關于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> 的字首