javax.xml.soap
介面 Name

public interface Name

XML 名稱的表示形式。此介面提供的方法可獲取本地和限定於命名空間的名稱，以及與名稱的命名空間關聯的前綴。它還能夠獲取命名空間的 URI。

以下是一個元素中命名空間宣告的範例。

<wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
 

（"xmlns" 代表 "XML namespace"。）下文顯示了 Name 介面中的方法將返回的內容。

• getQualifiedName 將返回 "prefix:LocalName" = "WOMBAT:GetLastTradePrice"
• getURI 將返回 "http://www.wombat.org/trader"
• getLocalName 將返回 "GetLastTracePrice"
• getPrefix 將返回 "WOMBAT"

XML 命名空間用於辨別 SOAP 標識符與特定於應用程序的標識符。

Name 物件是使用方法 SOAPEnvelope.createName 創建的，該方法有兩種形式。一種方法創建帶有本地名稱、命名空間前綴和命名空間 URI 的 Name 物件，另一種方法創建只帶有本地名稱的 Name 物件。以下程式碼行（其中 se 是一個 SOAPEnvelope 物件）創建帶有所有三個元素的新 Name 物件。

Name name = se.createName("GetLastTradePrice", "WOMBAT",
"http://www.wombat.org/trader");
 

以下程式碼行給出一個如何使用物件 Name 的範例。變數 element 是一個 SOAPElement 物件。此程式碼創建帶有給定名稱的新 SOAPElement 物件並將其添加到 element。

element.addChildElement(name);
 

Name 介面在將來的 SAAJ 版本中可能會被廢棄，並被 javax.xml.namespace.QName 取代。

另請參見：

SOAPEnvelope.createName, SOAPFactory.createName

方法摘要

String	getLocalName() 獲取此 Name 物件表示的 XML 名稱的本地名稱部分。
String	getPrefix() 返回初始化此 Name 物件時指定的前綴。
String	getQualifiedName() 獲取此 Name 物件表示的 XML 名稱限定於命名空間的名稱。
String	getURI() 返回此 Name 物件表示的 XML 名稱命名空間的 URI。

方法詳細資訊

getLocalName

String getLocalName()

獲取此 Name 物件表示的 XML 名稱的本地名稱部分。

返回：

給出本地名稱的字元串

getQualifiedName

String getQualifiedName()

獲取此 Name 物件表示的 XML 名稱限定於命名空間的名稱。

返回：

字元串形式的限定於命名空間的名稱。

getPrefix

String getPrefix()

返回初始化此 Name 物件時指定的前綴。此前綴與此 Name 物件表示的 XML 名稱的命名空間關聯。

返回：

字元串形式的資料

getURI

String getURI()

返回此 Name 物件表示的 XML 名稱命名空間的 URI。

返回：

字元串形式的 URI