关于WebService中用到的QName详解

如果名称空间 URI 为 null，则将它设置为 XMLConstants.NULL_NS_URI。此值表示非显式定义的名称空间，在 @L_502_19@ 规范中定义。此操作保持了与 QName 1.0 兼容的行为。显式提供 XMLConstants.NULL_NS_URI 值是首选的编码风格。

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

当使用此构造方法时，将前缀设置为 XMLConstants.DEFAULT_NS_PREFIX。

名称空间 URI 不根据 URI 参考验证。没有按 Namespaces in XML 中的指定将本地部分作为 NCName 来验证。

namespaceURI

zh_cn

QName 的名称空间 URI

localPart

zh_cn

QName 的本地部分

Throws

IllegalArgumentException:

zh_cn

当 localPart 为 null 时

See also QName(String namespaceURI,String prefix)

String localPart,String prefix)

zh_cn

指定名称空间 URI、本地部分和前缀的 QName 构造方法。

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

如果前缀为 null，则抛出 IllegalArgumentException。使用 XMLConstants.DEFAULT_NS_PREFIX 显式指示不存在任何前缀或前缀是不相关的。

名称空间 URI 不根据 URI 参考验证。没有按 Namespaces in XML 中的指定将本地部分和前缀作为 NCName 来验证。

namespaceURI

zh_cn

QName 的名称空间 URI

localPart

zh_cn

QName 的本地部分

prefix

zh_cn

QName 的前缀

Throws

IllegalArgumentException:

zh_cn

当 localPart 或 prefix 为 null 时

public

QName(String localPart)

zh_cn

指定本地部分的 QName 构造方法。

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

使用此构造方法时，将名称空间 URI 设置为 XMLConstants.NULL_NS_URI，并将前缀设置为 XMLConstants.DEFAULT_NS_PREFIX。

在 XML 上下文中，所有元素和属性名称都存在于名称空间的上下文中。在构造 QName 的过程中，使其显式存在有助于避免诊断 XML 有效性错误的难度。优先使用构造方法 QName(String namespaceURI,String localPart) 和 namespaceURI,String prefix)。

没有按 Namespaces in XML 中的指定将本地部分作为 NCName 来验证。

localPart

zh_cn

QName 的本地部分

Throws

IllegalArgumentException:

zh_cn

当 localPart 为 null 时

See also QName(String namespaceURI,String localPart), QName(String namespaceURI,String prefix)

Methods

final public boolean

equals(Object objectToTest)

zh_cn

测试此 QName 与另一个 Object 的相等性。

如果要测试的 Object 不是 QName，或为 null，那么此方法返回 false。

当且仅当名称空间 URI 和本地部分相等时，才认为两个 QName 相等。此方法使用 String.equals() 检查名称空间 URI 和本地部分的相等性。前缀不能用于确定相等性。

此方法满足 Object.equals(Object) 的常规协定。

objectToTest

zh_cn

要测试与此 QName 相等性的 Object

return

zh_cn

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

final public int

hashCode()

zh_cn

生成此 QName 的哈希码。

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

此方法满足 Object.hashCode() 的常规协定。

return

zh_cn

此 QName Object 的哈希码

public String

toString()

zh_cn

此 QName 的 String 表示形式。

James Clark 定义了将 QName 表示为 String 的公认方法。虽然这不是标准规范，但其使用很频繁，例如 name,Object value)。此实现将 QName 表示为："{" + Namespace URI + "}" + 本地部分。如果名称空间 URI .equals(XMLConstants.NULL_NS_URI)，则仅返回本地部分。此方法适用于调试或记录人为消耗。

注：前缀值不能作为 String 表示形式的一部分返回。

此方法满足 Object.toString() 的常规协定。

return

zh_cn

此 QName 的 String 表示形式

public static QName

valueOf(String qNameAsstring)

zh_cn

从解析格式化 String 中派生的 QName。

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

String 必须是 QName.toString() 返回的格式。

James Clark 定义了将 QName 表示为 String 的公认方法。虽然这不是标准规范，但其使用很频繁，例如 name,Object value)。此实现将 String 解析为以下格式："{" + Namespace URI + "}" + 本地部分。如果名称空间 URI .equals(XMLConstants.NULL_NS_URI)，则仅提供本地部分。

不能用 String 表示前缀值，并将它设置为 XMLConstants.DEFAULT_NS_PREFIX。

此方法不能完全验证生成的 QName。

名称空间 URI 不根据 URI 参考验证。没有按 Namespaces in XML 中的指定将本地部分作为 NCName 来验证。

qNameAsstring

zh_cn

QName 的 String 表示形式

Throws

IllegalArgumentException:

zh_cn

当 qNameAsstring 为 null 或出错时

return

zh_cn