javax.xml.ws.soap

Class AddressingFeature

java.lang.Object

javax.xml.ws.WebServiceFeature

javax.xml.ws.soap.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头。

如果启用寻址，则必须根据3.1 WS-Policy Assertions在WSDL中生成相应的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寻址的更多信息。

从以下版本开始：

JAX-WS 2.1

另请参见：

Addressing

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AddressingFeature.Responses 如果启用寻址，则此属性确定端点是否仅需要使用匿名响应，或仅使用非匿名响应或全部。

Field Summary

Fields

Modifier and Type	Field and Description
static String	ID 识别寻址功能的常数值
protected boolean	required 如果启用寻址，则此属性确定端点是否需要WS-Addressing。

Fields inherited from class javax.xml.ws.WebServiceFeature

enabled

构造方法摘要

构造方法

Constructor and Description
AddressingFeature() 创建和配置 AddressingFeature配合使用的寻址要求。
AddressingFeature(boolean enabled) 创建和配置 AddressingFeature配合使用的寻址要求。
AddressingFeature(boolean enabled, boolean required) 创建和配置 AddressingFeature配合使用的寻址要求。
AddressingFeature(boolean enabled, boolean required, AddressingFeature.Responses responses) 创建和配置 AddressingFeature配合使用的寻址要求。

方法摘要

Modifier and Type	Method and Description
String	getID() 获取此WebServiceFeature的唯一标识符。
AddressingFeature.Responses	getResponses() 如果启用寻址，则此属性确定端点是否需要使用匿名响应，或非匿名响应或所有响应。
boolean	isRequired() 如果启用寻址，则此属性确定端点是否需要WS-Addressing。

Methods inherited from class javax.xml.ws.WebServiceFeature

isEnabled

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细信息

ID

public static final String ID

识别寻址功能的常数值

另请参见：

Constant Field Values

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 - 指定需要什么类型的响应

从以下版本开始：

JAX-WS 2.2

方法详细信息

getID

public String getID()

获取此WebServiceFeature的唯一标识符。

Specified by:

getID在 WebServiceFeature

结果

该功能的唯一标识符。

isRequired

public boolean isRequired()

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

结果

当前所需的值

getResponses

public AddressingFeature.Responses getResponses()

如果启用寻址，则此属性确定端点是否需要使用匿名响应，或非匿名响应或所有响应。

结果

AddressingFeature.Responses.ALL当端点支持所有类型的响应时， AddressingFeature.Responses.ANONYMOUS当端点只需使用匿名响应时， AddressingFeature.Responses.NON_ANONYMOUS当端点需要使用只有非匿名响应时

从以下版本开始：

JAX-WS 2.2