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
取代。
方法摘要 | |
---|---|
String |
getLocalName() 获取此 Name 对象表示的 XML 名称的本地名称部分。 |
String |
getPrefix() 返回初始化此 Name 对象时指定的前缀。 |
String |
getQualifiedName() 获取此 Name 对象表示的 XML 名称限定于命名空间的名称。 |
String |
getURI() 返回此 Name 对象表示的 XML 名称命名空间的 URI。 |
方法详细信息 |
---|
String getLocalName()
Name
对象表示的 XML 名称的本地名称部分。
String getQualifiedName()
Name
对象表示的 XML 名称限定于命名空间的名称。
String getPrefix()
Name
对象时指定的前缀。此前缀与此
Name
对象表示的 XML 名称的命名空间关联。
String getURI()
Name
对象表示的 XML 名称命名空间的 URI。