Module  java.xml.ws
软件包  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标识符的歧义。

    使用方法SOAPEnvelope.createName创建Name对象,该方法有两个版本。 一种方法创建具有本地名称,命名空间前缀和命名空间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

    从以下版本开始:
    1.6
    另请参见:
    SOAPEnvelope.createNameSOAPFactory.createName
    • 方法详细信息

      • getLocalName

        String getLocalName​()
        获取此 Name对象所代表的XML名称的本地名称部分。
        结果
        一个字符串给出本地名称
      • getQualifiedName

        String getQualifiedName​()
        获取此 Name对象表示的XML名称的命名空间限定名称。
        结果
        命名空间限定名称作为字符串
      • getPrefix

        String getPrefix​()
        返回此Name对象初始化时指定的前缀。 此前缀与此Name对象表示的XML名称的命名空间相关联。
        结果
        前缀作为字符串
      • getURI

        String getURI​()
        返回此 Name对象表示的XML名称的命名空间的URI。
        结果
        该URI作为字符串