Name (Java Platform SE 6)

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.xml.soap
接口 Name

public interface Name

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

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

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

（"xmlns" 代表 "XML namespace"。）下文显示了 Name 接口中的方法将返回的内容。

getQualifiedName 将返回 "prefix:LocalName" = "WOMBAT:GetLastTradePrice"
getURI 将返回 "https://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",
"https://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。