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是不可变的。

从以下版本开始：

1.5

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() 获取此的命名空间URI QName 。
String	getPrefix() 获取此 QName的前缀。
int	hashCode() 生成这个 QName的哈希码。
String	toString() String这个 QName 。
static QName	valueOf(String qNameAsString) QName源自解析格式化的 String 。

Methods inherited from class 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 。 本地部分不会验证为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，本地部分和前缀。

如果命名空间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有助于避免诊断XML有效性错误。 构造器QName(String namespaceURI, String localPart)和QName(String namespaceURI, String localPart, String prefix)是优选的。

本地部分不会验证为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()

获取此的命名空间URI QName 。

结果

这个 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的普遍接受的方式是James Clark的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的普遍接受的方式是James Clark的defined 。 虽然这不是一个标准的规范，但它是常用的，例如Transformer.setParameter(String name, Object value) 。 此实现解析为String格式为：“{”+ Namespace URI +“}”+本地部分。 如果命名空间URI为.equals(XMLConstants.NULL_NS_URI) ，则只应提供本地部分。

前缀值不能在String中String ，并将设置为XMLConstants.DEFAULT_NS_PREFIX 。

该方法不会对所得的QName进行全面QName 。

命名空间URI未验证为URI reference 。 本地部分不会验证为NCName在指定的Namespaces in XML 。

参数

qNameAsString - String表示 QName

结果

QName对应给定的 String

异常

IllegalArgumentException - 当 qNameAsString为 null或格式错误

另请参见：

QName.toString()