javax.xml.soap

Interface Name

public interface Name

XML名称的表示形式。 此接口提供了获取本地和命名空间限定名称以及获取与名称的命名空间相关联的前缀的方法。 也可以获取命名空间的URI。

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

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

（“XMLNS”代表“XML命名空间”。）下面显示的方法是什么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对象的示例。 可变元素是一个SOAPElement对象。 该代码创建一个具有给定名称的新的SOAPElement对象，并将其添加到元素 。

  element.addChildElement(name); 

Name接口可能在SAAJ的未来版本中被废弃，赞成javax.xml.namespace.QName

另请参见：

SOAPEnvelope.createName ， SOAPFactory.createName

方法摘要

Modifier and Type	Method and Description
String	getLocalName() 获取此 Name对象所代表的XML名称的本地名称部分。
String	getPrefix() 返回在 Name对象时指定的前缀。
String	getQualifiedName() 获取此 Name对象表示的XML名称的命名空间限定名称。
String	getURI() 返回此 Name对象表示的XML名称的命名 Name URI。

方法详细信息

getLocalName

String getLocalName()

获取此 Name对象所代表的XML名称的本地名称部分。

结果

一个字符串给出本地名称

getQualifiedName

String getQualifiedName()

获取此 Name对象所代表的XML名称的命名空间限定名称。

结果

命名空间限定名称作为字符串

getPrefix

String getPrefix()

返回当此Name对象初始化时指定的前缀。 此前缀与此Name对象表示的XML名称的命名Name联。

结果

前缀作为字符串

getURI

String getURI()

返回此 Name对象表示的XML名称的命名 Name URI。

结果

该URI作为一个字符串