Module  java.xml.ws
软件包  javax.xml.ws.soap

Class AddressingFeature


  • public final class AddressingFeature
extends WebServiceFeature
    AddressingFeature表示使用SOAP 1.1 / HTTP或SOAP 1.2 / HTTP绑定的WS-Addressing。 使用此功能与任何其他绑定是未定义的。

    此功能可以在创建SEI代理的过程中使用，并Dispatch个在客户端实例和Endpoint个在服务器端实例。 此功能不能在客户端使用Service实例创建。

    以下描述了该功能对启用或禁用的影响：

    • ENABLED：在此模式下，WS-Addressing将被启用。 这意味着端点支持WS寻址，但不需要使用它。 发件人可以使用WS-Addressing标头或没有WS-Addressing标头发送消息。 但接收者必须消耗这两种类型的消息。
    • DISABLED：在此模式下，WS-Addressing将被禁用。 在运行时，WS-Addressing头不能被发送者或接收者使用。

    如果启用该功能，则required属性确定端点是否需要WS-Addressing。 如果设置为真，WS-Addressing头必须在传入和传出的消息中存在。 默认情况下， required属性为false 。

    如果Web服务开发人员尚未明确启用此功能，则WSDL的wsam：寻址策略断言用于查找使用WS-Addressing。 通过明确使用该功能，应用程序会覆盖WSDL使用WS-Addressing的指示。 在某些情况下，这是真正需要的。 例如，如果应用程序本身已经实现了WS-Addressing，它可以使用此功能来禁用寻址。 这意味着JAX-WS实现不消耗或产生WS-Addressing头。

    如果启用寻址，则必须在WSDL中根据3.1 WS-Policy Assertions生成相应的wsam：寻址策略断言

    示例1：可能的策略声明生成的WSDL为@Addressing 

       <wsam:Addressing wsp:Optional="true"> <wsp:Policy/> </wsam:Addressing>

    示例2：可能的策略声明生成的WSDL为@Addressing(required=true) 

       <wsam:Addressing> <wsp:Policy/> </wsam:Addressing>

    示例3：生成的WSDL中可能的策略声明为@Addressing(required=true, responses=Responses.ANONYMOUS) 

       <wsam:Addressing> <wsp:Policy> <wsam:AnonymousResponses/> </wsp:Policy> </wsam:Addressing>

    见Web Services Addressing - Core ， Web Services Addressing 1.0 - SOAP Binding ，并Web Services Addressing 1.0 - Metadata对WS寻址的更多信息。

    从以下版本开始：
    1.6，JAX-WS 2.1
    另请参见：
    Addressing

    • 字段详细信息

      • required

        protected boolean required
        如果启用寻址，则此属性确定端点是否需要WS-Addressing。 如果需要，则WS-Addressing头必须存在于传入和传出的消息中。

    • 构造方法详细信息

      • AddressingFeature

        public AddressingFeature​()
        使用寻址要求创建和配置一个AddressingFeature 。 创建的功能使ws寻址即支持ws寻址，但不需要使用。 它也被配置为接受所有的响应类型。

      • AddressingFeature

        public AddressingFeature​(boolean enabled)
        使用寻址要求创建和配置一个AddressingFeature 。 如果enabled是真的，它可以实现ws寻址，即支持ws寻址，但不需要使用它。 它还配置为接受所有响应类型。
        参数
        enabled - true启用ws寻址iews寻址，但不需要使用

      • AddressingFeature

        public AddressingFeature​(boolean enabled,
                         boolean required)
        使用寻址要求创建和配置一个AddressingFeature 。 如果enabled和required都为真，则可以实现ws寻址并且需要使用它。 它还配置为接受所有响应类型。
        参数
        enabled - true启用ws寻址iews寻址，但不需要使用
        required - 真正的手段需要使用ws寻址。

      • AddressingFeature

        public AddressingFeature​(boolean enabled,
                         boolean required,
                         AddressingFeature.Responses responses)
        使用寻址要求创建和配置一个AddressingFeature 。 如果enabled和required都为真，则可以实现ws寻址，并且需要使用它。 此外，响应类型可以使用responses参数进行配置。
        参数
        enabled - true启用ws寻址iews寻址，但不需要使用
        required - 真正的手段需要使用ws寻址。
        responses - 指定需要哪种类型的响应
        从以下版本开始：
        1.7，JAX-WS 2.2

    • 方法详细信息

      • getID

        public String getID​()
        获取此WebServiceFeature的唯一标识符。
        Specified by:
        getID在 WebServiceFeature
        结果
        该功能的唯一标识符。

      • isRequired

        public boolean isRequired​()
        如果启用寻址，则此属性确定端点是否需要WS-Addressing。 如果需要，则WS-Addressing头必须存在于传入和传出的消息中。
        结果
        当前所需的值