java.lang.Object
- javax.xml.namespace.QName

实现的所有接口

Serializable
```
public class QName
extends Object
implements Serializable
```
QName表示如XML规范中定义的限定名称 ： XML Schema Part2: Datatypes specification ， Namespaces in XML 。

QName的值包含名称空间URI ， 本地部分和前缀。

前缀包括在QName保留词汇信息存在于一个时 XML input source 。前缀不用于QName.equals(Object)或计算QName.hashCode() 。仅使用Namespace URI和本地部分定义Equality和哈希码。

如果未指定，则名称空间URI设置为XMLConstants.NULL_NS_URI 。如果未指定，则前缀设置为XMLConstants.DEFAULT_NS_PREFIX 。

QName是不可变的。

从以下版本开始：

1.5

另请参见：

XML Schema Part2: Datatypes specification ， Namespaces in XML ， Serialized Form

构造方法摘要

构造方法
构造器	描述
`QName(String localPart)`	`QName`指定本地部分的构造函数。
`QName(String namespaceURI, String localPart)`	`QName`构造函数，指定名称空间URI和本地部分。
`QName(String namespaceURI, String localPart, String prefix)`	`QName`构造函数，指定名称空间URI，本地部分和前缀。

方法摘要

所有方法静态方法实例方法具体的方法
变量和类型	方法	描述
`boolean`	`equals(Object objectToTest)`	测试此 `QName`是否与另一个 `Object` 。
`String`	`getLocalPart()`	获取此 `QName`的本地部分。
`String`	`getNamespaceURI()`	获取此 `QName`的名称空间URI。
`String`	`getPrefix()`	获取此 `QName`的前缀。
`int`	`hashCode()`	生成此 `QName`的哈希码。
`String`	`toString()`	`String`表示这个 `QName` 。
`static QName`	`valueOf(String qNameAsString)`	`QName`派生自解析格式化的 `String` 。

声明方法的类 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - QName
```
public QName(String namespaceURI,
             String localPart)
```
    QName构造函数，指定名称空间URI和本地部分。
    
    如果名称空间URI为null ，则将其设置为XMLConstants.NULL_NS_URI 。此值表示Namespaces in XML规范未定义的显式定义的命名空间。此操作保留与QName 1.0的兼容行为。明确提供XMLConstants.NULL_NS_URI值是首选的编码风格。
    
    如果本地部分是null ，则抛出IllegalArgumentException 。允许“”的本地部分保留与QName 1.0的兼容行为。
    
    使用此构造函数时，前缀设置为XMLConstants.DEFAULT_NS_PREFIX 。
    
    名称空间URI未验证为URI reference 。本地部分未经过验证，如Namespaces in XML中指定的NCName 。
    
    参数
    
    namespaceURI -的的命名空间URI QName
    
    localPart -在当地的部分 QName
    
    异常
    
    IllegalArgumentException - 当 localPart是 null
    
    另请参见：
    
    QName(String namespaceURI, String localPart, String prefix)
  - QName
```
public QName(String namespaceURI,
             String localPart,
             String prefix)
```
    QName构造函数，指定名称空间URI，本地部分和前缀。
    
    如果名称空间URI为null ，则将其设置为XMLConstants.NULL_NS_URI 。此值表示Namespaces in XML规范未定义的显式定义的命名空间。此操作保留与QName 1.0的兼容行为。明确提供XMLConstants.NULL_NS_URI值是首选的编码风格。
    
    如果本地部分为null的IllegalArgumentException异常。允许“”的本地部分保留与QName 1.0的兼容行为。
    
    如果前缀为null ，则抛出IllegalArgumentException 。使用XMLConstants.DEFAULT_NS_PREFIX明确指出不存在前缀或前缀不相关。
    
    名称空间URI未验证为URI reference 。本地部分和前缀未经验证为NCName，如Namespaces in XML中所述。
    
    参数
    
    namespaceURI -的的命名空间URI QName
    
    localPart -在当地的部分 QName
    
    prefix -的前缀 QName
    
    异常
    
    IllegalArgumentException - 当 localPart或 prefix是 null
  - QName
```
public QName(String localPart)
```
    QName指定本地部分的构造函数。
    
    如果本地部分是null ，则抛出IllegalArgumentException 。允许“”的本地部分保留与QName 1.0的兼容行为。
    
    使用此构造函数时，名称空间URI设置为XMLConstants.NULL_NS_URI ，前缀设置为XMLConstants.DEFAULT_NS_PREFIX 。
    
    在XML上下文中，所有元素和属性名称都存在于命名空间的上下文中。 在构造QName期间明确这QName有助于防止难以诊断XML有效性错误。 构造函数QName(String namespaceURI, String localPart)和QName(String namespaceURI, String localPart, String prefix)是优选的。
    
    本地部分未经验证为5127159352809中指定的NCName 。
    
    参数
    
    localPart -在当地的部分 QName
    
    异常
    
    IllegalArgumentException - 当 localPart是 null
    
    另请参见：
    
    QName(String namespaceURI, String localPart) ， QName(String namespaceURI, String localPart, String prefix)
- 方法详细信息
  - getNamespaceURI
```
public String getNamespaceURI()
```
    获取此QName的名称空间URI。
    
    结果
    
    此 QName名称空间URI
  - getLocalPart
```
public String getLocalPart()
```
    获取此QName的本地部分。
    
    结果
    
    本地部分 QName
  - getPrefix
```
public String getPrefix()
```
    获取此QName的前缀。
    
    分配给一个前缀QName可能不是在不同的上下文中有效。例如，可以在解析文档的上下文中为QName分配前缀，但该前缀在不同文档的上下文中可能是无效的。
    
    结果
    
    这个前缀 QName
  - equals
```
public final boolean equals(Object objectToTest)
```
    测试此QName是否与另一个Object 。
    
    如果Object待测试不是QName或是null ，则此方法返回false 。
    
    当且仅当命名空间URI和本地部分相等时，才认为两个QName是相等的。此方法使用String.equals()来检查名称空间URI和本地部分的相等性。前缀不用于确定相等性。
    
    该方法满足Object.equals(Object)的总合同
    
    重写：
    
    equals在类 Object
    
    参数
    
    objectToTest -将 Object要测试其相等与此 QName
    
    结果
    
    true若给定 Object等于此 QName否则 false
    
    另请参见：
    
    Object.hashCode() ， HashMap
  - hashCode
```
public final int hashCode()
```
    生成此QName的哈希码。
    
    使用名称空间URI和QName的本地部分计算哈希码。前缀不用于计算哈希码。
    
    该方法满足Object.hashCode()的总合同。
    
    重写：
    
    hashCode类 Object
    
    结果
    
    此哈希码为 QName Object
    
    另请参见：
    
    Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)
  - toString
```
public String toString()
```
    String代表作者QName 。
    
    代表普遍接受的方式QName为String为defined由詹姆斯·克拉克。虽然这不是标准规范，但它是常用的，例如Transformer.setParameter(String name, Object value) 。此实现表示QName ：“{”+ Namespace URI +“}”+本地部分。如果名称空间URI为.equals(XMLConstants.NULL_NS_URI) ，则仅返回本地部分。适当使用此方法用于调试或记录供人食用。
    
    请注意，前缀值不会作为String表示的一部分返回。
    
    该方法满足Object.toString()的一般合同。
    
    重写：
    
    toString在类 Object
    
    结果
    
    String代表表示 QName
  - valueOf
```
public static QName valueOf(String qNameAsString)
```
    QName派生自解析格式化的String 。
    
    如果String是null或不符合QName.toString()格式，则抛出IllegalArgumentException 。
    
    String 必须采用QName.toString()返回的格式。
    
    代表普遍接受的方式QName为String为defined由詹姆斯·克拉克。虽然这不是标准规范，但它是常用的，例如Transformer.setParameter(String name, Object value) 。此实现解析String格式为：“{”+ Namespace URI +“}”+本地部分。如果名称空间URI为.equals(XMLConstants.NULL_NS_URI) ，则只应提供本地部分。
    
    前缀值不能在String表示，并将设置为XMLConstants.DEFAULT_NS_PREFIX 。
    
    此方法不会对生成的QName进行完全验证。
    
    名称空间URI未验证为URI reference 。本地部分未经过验证，如Namespaces in XML中指定的NCName 。
    
    参数
    
    qNameAsString - String表示的 QName
    
    结果
    
    QName对应于给定的 String
    
    异常
    
    IllegalArgumentException - 当 qNameAsString是 null或格式错误时
    
    另请参见：
    
    QName.toString()

Class QName

构造方法摘要

方法摘要

声明方法的类 java.lang.Object

构造方法详细信息

QName

QName

QName

方法详细信息

getNamespaceURI

getLocalPart

getPrefix

equals

hashCode

toString

valueOf