JavaTM Platform
Standard Ed. 6

javax.xml.soap
接口 Name


public interface Name

XML 名称的表示形式。此接口提供的方法可获取本地和限定于命名空间的名称,以及与名称的命名空间关联的前缀。它还能够获取命名空间的 URI。

以下是一个元素中命名空间声明的示例。

<wombat:GetLastTradePrice xmlns:wombat="http://www.wombat.org/trader">
 
("xmlns" 代表 "XML namespace"。)下文显示了 Name 接口中的方法将返回的内容。

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

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策