javax.xml.soap

接口
异常
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