compact2, compact3

javax.xml.namespace

Class QName

java.lang.Object

javax.xml.namespace.QName

All Implemented Interfaces:

Serializable

public class QName
extends Object
implements Serializable

QName代表限定名在XML规范中定义的：XML Schema Part2: Datatypes specification，Namespaces in XML，Namespaces in XML Errata。

一个QName的值包含一个命名空间URI，局部和前缀。

前缀是包含在QName保留在XML input source词汇信息当礼物。前缀是不用于QName.equals(Object)或计算QName.hashCode()。平等的散列码使用只有定义的命名空间URI和本地部分。

如果不指定的命名空间URI设置为XMLConstants.NULL_NS_URI。如果不指定前缀设置为XMLConstants.DEFAULT_NS_PREFIX。

QName是不变的。

从以下版本开始：

一点五

Version:

修改：1.8美元美元美元，日期：2010 / 03 / 18 03:06:17美元

另请参见：

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

构造方法摘要

构造方法

Constructor and Description
QName(String localPart) QName构造函数指定地方。
QName(String namespaceURI, String localPart) QName构造函数中指定的命名空间URI和本地部分。
QName(String namespaceURI, String localPart, String prefix) QName构造函数中指定的命名空间URI，局部和前缀。

方法摘要

Modifier and Type	Method and Description
boolean	equals(Object objectToTest) 这 QName测试与另一 Object平等。
String	getLocalPart() 得到这个 QName局部。
String	getNamespaceURI() 得到这个 QName命名空间URI。
String	getPrefix() 得到这个 QName前缀。
int	hashCode() 这 QName生成哈希代码。
String	toString() 这 QName String表示。
static QName	valueOf(String qNameAsString) QName来自解析格式化 String。

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

QName

public QName(String namespaceURI,
             String localPart)

QName构造函数中指定的命名空间URI和本地部分。

如果是null命名空间URI，它是集XMLConstants.NULL_NS_URI。此值表示没有明确定义的命名空间的Namespaces in XML规范定义。这个动作保持1兼容的行为属性。显式提供XMLConstants.NULL_NS_URI值优先编码风格。

如果局部null一IllegalArgumentException抛出。“”一个局部允许保留与1兼容的行为属性。

使用此构造函数时，前缀设置为XMLConstants.DEFAULT_NS_PREFIX。

命名空间URI不验证为URI reference。当地的部分没有被验证为NCName指定Namespaces in XML。

参数

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，局部和前缀。

如果是null命名空间URI，它是集XMLConstants.NULL_NS_URI。此值表示没有明确定义的命名空间的Namespaces in XML规范定义。这个动作保持1兼容的行为属性。显式提供XMLConstants.NULL_NS_URI值优先编码风格。

如果局部null一IllegalArgumentException抛出。“”一个局部允许保留与1兼容的行为属性。

如果前缀是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抛出。“”一个局部允许保留与1兼容的行为属性。

使用此构造函数时，该命名空间URI设置为XMLConstants.NULL_NS_URI和前缀设置为XMLConstants.DEFAULT_NS_PREFIX。

在XML上下文中，命名空间的上下文中存在所有元素和属性名称。这个明确的QName的建设过程中，有助于防止难诊断XML有效性错误。构造函数属性（字符串namespaceuri，字符串localpart）和属性（字符串namespaceuri localpart，字符串，字符串的前缀）优先。

当地的部分没有被验证为NCName指定Namespaces in XML。

参数

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。

两QNames被视为相等当且仅当它的命名空间URI和本地部分相等。该方法采用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()

这QName String表示。

普遍被接受的方式表示QName作为String是defined James Clark。虽然这不是一个标准的规范，这是普遍使用的，如Transformer.setParameter(String name, Object value)。这个实现是一个QName：“{”+命名空间URI +“}”+局部。如果命名空间URI .equals(XMLConstants.NULL_NS_URI)，只有当地的一部分返回。这种方法的一个适当的使用是用于调试或日志记录用于人类消费。

值得注意的是不前缀值的一部分返回String表示。

该方法满足Object.toString()一般合同。

重写：

toString 方法重写，继承类 Object

结果

这 QName String表示

valueOf

public static QName valueOf(String qNameAsString)

QName来自解析格式化String。

如果String是null或不符合QName.toString()格式，一个IllegalArgumentException抛出。

字符串必须在形式返回tostring() QName。

普遍被接受的方式表示QName作为String是defined James Clark。虽然这不是一个标准的规范，这是普遍使用的，如Transformer.setParameter(String name, Object value)。这个实现解析String格式为：“{”+命名空间URI +“}”+局部。如果命名空间URI .equals(XMLConstants.NULL_NS_URI)，只有当地部分应提供。

前缀值不能在String表示，将XMLConstants.DEFAULT_NS_PREFIX。

这种方法不产生QName充分验证。

命名空间URI不验证为URI reference。当地的部分没有被验证为NCName指定Namespaces in XML。

参数

qNameAsString的 QName String表示

结果

到了相应的 QName String

异常

IllegalArgumentException当 qNameAsString是 null或畸形

另请参见：

QName.toString()