关于WebService中用到的QName详解

<a href="http://doc.java.sun.com/docweb/login.html">zh_cn</a>

<code>qname</code> 的值包含名称空间 uri、本地部分和前缀。

<code>qname</code> 是不可变的。

version

<a href="http://doc.java.sun.com/docweb/login.html">en</a>

$revision: 1.5 $, $date: 2005/11/03 19:34:20 $

since

1.5

see also

constructors

指定名称空间 uri 和本地部分的 <code>qname</code> 构造方法。

如果本地部分为 <code>null</code>，则抛出 <code>illegalargumentexception</code>。允许 "" 的本地部分保持与 qname 1.0 的兼容行为。

namespaceuri

<code>qname</code> 的名称空间 uri

localpart

<code>qname</code> 的本地部分

throws

illegalargumentexception:

当 <code>localpart</code> 为 <code>null</code> 时

<a href="http://doc.java.sun.com/docweb/api/javax.xml.namespace.qname#qname(string%20namespaceuri,%20string%20localpart,%20string%20prefix)">qname(string namespaceuri, string localpart, string prefix)</a>

指定名称空间 uri、本地部分和前缀的 <code>qname</code> 构造方法。

prefix

<code>qname</code> 的前缀

当 <code>localpart</code> 或 <code>prefix</code> 为 <code>null</code> 时

指定本地部分的 <code>qname</code> 构造方法。

在 xml 上下文中，所有元素和属性名称都存在于名称空间的上下文中。在构造 <code>qname</code> 的过程中，使其显式存在有助于避免诊断 xml 有效性错误的难度。优先使用构造方法

methods

测试此 <code>qname</code> 与另一个 <code>object</code> 的相等性。

如果要测试的 <code>object</code> 不是 <code>qname</code>，或为 <code>null</code>，那么此方法返回 <code>false</code>。

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

objecttotest

要测试与此 <code>qname</code> 相等性的 <code>object</code>

return

如果给定的 <code>object</code> 等于此 <code>qname</code>，则返回 <code>true</code>，否则返回 <code>false</code>

hashcode()

生成此 <code>qname</code> 的哈希码。

使用 <code>qname</code> 的名称空间 uri 和本地部分计算哈希码。前缀不能 用于计算哈希码。

此 <code>qname</code> <code>object</code> 的哈希码

tostring()

此 <code>qname</code> 的 <code>string</code> 表示形式。

<code>.equals(xmlconstants.null_ns_uri)</code>，则仅返回本地部分。此方法适用于调试或记录人为消耗。

注：前缀值不能 作为 <code>string</code> 表示形式的一部分返回。

此 <code>qname</code> 的 <code>string</code> 表示形式

从解析格式化 <code>string</code> 中派生的 <code>qname</code>。

<code>.equals(xmlconstants.null_ns_uri)</code>，则仅提供本地部分。

此方法不能完全验证生成的 <code>qname</code>。

qnameasstring

<code>qname</code> 的 <code>string</code> 表示形式

当 <code>qnameasstring</code> 为 <code>null</code> 或出错时

与给定 <code>string</code> 对应的 <code>qname</code>

<a href="http://doc.java.sun.com/docweb/api/javax.xml.namespace.qname#tostring()">qname.tostring()</a>

properties

getlocalpart()

获取此 <code>qname</code> 的本地部分。

此 <code>qname</code> 的本地部分

getnamespaceuri()

获取此 <code>qname</code> 的名称空间 uri。

此 <code>qname</code> 的名称空间 uri

getprefix()

获取此 <code>qname</code> 的前缀。

分配给 <code>qname</code> 的前缀在其他上下文中可能无 效。例如，可以在解析文档的上下文中为

<code>qname</code> 分配一个前缀，但是，该前缀可能在其他文档的上下文中无效。

此 <code>qname</code> 的前缀