Module java.xml

Package javax.xml.namespace

Class QName

java.lang.Object

javax.xml.namespace.QName

所有已实现的接口:

Serializable

       public class QName extends Object implements Serializable
      

QName代表XML规范中定义的限定名称：XML模式第2部分：数据类型规范，XML中的命名空间。

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

前缀包含在QName中，以保留在XML输入源中出现时的词汇信息。前缀在QName.equals(Object)或计算QName.hashCode()时不被使用。相等性和哈希码仅使用命名空间URI和本地部分来定义。

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

QName是不可变的。

自1.5版本起:

1.5

参见:

• XML模式第2部分：数据类型规范
• XML中的命名空间
• 序列化形式

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
final boolean	equals(Object objectToTest)	测试此QName与另一个Object的相等性。
String	getLocalPart()	获取此QName的本地部分。
String	getNamespaceURI()	获取此QName的命名空间URI。
String	getPrefix()	获取此QName的前缀。
final int	hashCode()	为此QName生成哈希码。
String	toString()	此QName的String表示形式。
static QName	valueOf(String qNameAsString)	从格式化的String解析出的QName。

Methods declared in class java.lang.Object

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

Constructor Details

QName

             public QName(String namespaceURI, String localPart)
            

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

如果命名空间URI为null，则设置为XMLConstants.NULL_NS_URI。此值表示根据XML中的命名空间规范未明确定的命名空间。此操作保留了与QName 1.0的兼容行为。明确提供XMLConstants.NULL_NS_URI值是首选的编码风格。

如果本地部分为null，则抛出IllegalArgumentException。允许本地部分为""以保留与QName 1.0的兼容行为。

XMLConstants.DEFAULT_NS_PREFIX。

URI引用。本地部分不会被验证为 NCName，如 XML中的命名空间中指定的那样。

参数:

namespaceURI - QName的命名空间URI

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。此值表示根据XML中的命名空间规范未明确定的命名空间。此操作保留了与QName 1.0的兼容行为。明确提供XMLConstants.NULL_NS_URI值是首选的编码风格。

如果本地部分为null，则抛出IllegalArgumentException。允许本地部分为""以保留与QName 1.0的兼容行为。

null，则抛出 IllegalArgumentException。使用 XMLConstants.DEFAULT_NS_PREFIX来明确指示没有前缀存在或前缀不相关。

URI引用。本地部分和前缀不会被验证为 NCName，如 XML中的命名空间中指定的那样。

参数:

namespaceURI - QName的命名空间URI

localPart - QName的本地部分

prefix - QName的前缀

抛出:

IllegalArgumentException - 当localPart或prefix为null时

QName

             public QName(String localPart)
            

QName构造函数指定本地部分。

如果本地部分为null，则抛出IllegalArgumentException。允许本地部分为""以保留与QName 1.0的兼容行为。

XMLConstants.NULL_NS_URI，前缀设置为 XMLConstants.DEFAULT_NS_PREFIX。

在XML上下文中，所有元素和属性名称都存在于命名空间的上下文中。在构造QName时明确此点有助于防止难以诊断的XML有效性错误。首选使用构造函数QName(String namespaceURI, String localPart)和QName(String namespaceURI, String localPart, String prefix)。

NCName，如 XML中的命名空间中指定的那样。

参数:

localPart - QName的本地部分

抛出:

IllegalArgumentException - 当localPart为null时

参见:

• QName(String namespaceURI, String localPart)
• QName(String namespaceURI, String localPart, String prefix)

Method Details

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。

QName才被视为相等。此方法使用 String.equals()来检查命名空间URI和本地部分的相等性。前缀 不用于确定相等性。

Object.equals(Object)的一般合同。

覆盖:

equals 在类 Object

参数:

objectToTest - 要测试与此QName相等性的Object

返回:

true如果给定的Object等于此QName，否则false

参见:

• Object.hashCode()
• HashMap

hashCode

             public final int hashCode()
            

为此QName生成哈希码。

QName的命名空间URI和本地部分计算哈希码。前缀 不用于计算哈希码。

Object.hashCode()的一般合同。

覆盖:

hashCode 在类 Object

返回:

此QName对象的哈希码

参见:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

toString

             public String toString()
            

此QName的String表示。

表示QName的常用方式是由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)
            

从格式化的String派生的QName。

如果String为null或不符合QName.toString()的格式，将抛出IllegalArgumentException。

该String必须符合由QName.toString()返回的形式。

表示QName的常用方式是由James Clark定义的。尽管这不是一个标准规范，但它被广泛使用，例如Transformer.setParameter(String name, Object value)。此实现解析格式为："{" + 命名空间URI + "}" + 本地部分的String。如果命名空间URI.equals(XMLConstants.NULL_NS_URI)，则应仅提供本地部分。

前缀值无法在String中表示，并将设置为XMLConstants.DEFAULT_NS_PREFIX。

此方法不会对生成的QName进行完整验证。

命名空间URI不会作为URI引用进行验证。本地部分不会作为NCName进行验证，如XML命名空间中指定的那样。

参数:

qNameAsString - QName的String表示

返回:

对应于给定String的QName

抛出:

IllegalArgumentException - 当qNameAsString为null或格式不正确时

参见:

• QName.toString()