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代表使用WS-Addressing使用肥皂或肥皂1.1/http 1.2/http结合。使用此功能与任何其他绑定是不确定的。

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

以下介绍了该功能的影响，将启用或禁用：

• 启用：在这种模式下，寻址将启用。这意味着端点支持WS-Addressing但不需要。发送者可以发送寻址标头或无寻址标头信息。但一个接收器必须消耗这两种类型的消息。
• 禁用：在这种模式下，寻址将被禁用。在运行时，寻址标头不能由一个发送器或接收器使用。

如果启用该功能，在required属性确定端点需要寻址。如果设为true，寻址标题必须对传入和传出的消息是。默认情况下，required属性false。

如果Web服务开发者没有明确启用此功能，WSDL的方便寻址策略断言是用来发现WS-Addressing使用。采用特征明确，应用重写的WS-Addressing使用WSDL的指示。在某些情况下，这是真的需要的。例如，如果一个应用程序实现了寻址本身，它可以使用此功能来禁用寻址。这意味着JAX-WS实现不消耗或产生寻址标头。

如果启用了相应处理，方便寻址策略断言必须产生的WSDL中每 3.1 WS-Policy Assertions

在生成的WSDL @Addressing 例1：possible政策主张

 
        
        
        
      
        
      <方便寻址wsp：可选=“true”>
       
         
       
         
         
         
  WSP：政策/ > << /方便寻址>
 
        
        
        
      
        
      

在生成的WSDL @Addressing(required=true) 例2：possible政策主张

 
        
        
        
      
        
      <地址>
       
         
       
         
         
         
  方便WSP：政策/ > << /方便寻址>
 
        
        
        
      
        
      

在生成的WSDL @Addressing(required=true, responses=Responses.ANONYMOUS) 例3：possible政策主张

 
        
        
        
      
        
      <地址>
       
         
       
         
         
         
  方便WSP：<
  
         
         
         
       
         
       <政策>
         >基于anonymousresponses / >：<< / WSP：政策>< /方便寻址> 
       
 
        
        
        
      
        
      

看到 Web Services Addressing - Core， Web Services Addressing 1.0 - SOAP Binding，和基于WS-Addressing的更多信息 Web Services Addressing 1.0 - Metadata。

从以下版本开始：

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 定值确定addressingfeature
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

Field Detail

ID

public static final String ID

定值确定addressingfeature

另请参见：

Constant Field Values

required

protected boolean required

如果在启用，此属性确定是否需要WS-Addressing端点。如果需要的话是真的，寻址标题必须对传入和传出的消息是。

Constructor Detail

AddressingFeature

public AddressingFeature()

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

AddressingFeature

public AddressingFeature(boolean enabled)

创建和配置的要求使用一个 AddressingFeature。如果 enabled是真实的，它使寻址即支持WS-Addressing但不需要。它还配置为接受所有的反应类型。

参数

enabled真使i.e.ws-addressing WS-Addressing支持但不需要

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required)

创建和配置的要求使用一个 AddressingFeature。如果 enabled和 required是真实的，它使寻址和需要使用的。它还配置为接受所有的反应类型。

参数

enabled真使i.e.ws-addressing WS-Addressing支持但不需要

required -真的意味着需要WS-Addressing使用。

AddressingFeature

public AddressingFeature(boolean enabled,
                         boolean required,
                         AddressingFeature.Responses responses)

创建和配置的要求使用一个 AddressingFeature。如果 enabled和 required是真实的，它使寻址和需要使用的。同时，响应类型可以配置使用 responses参数。

参数

enabled真使i.e.ws-addressing WS-Addressing支持但不需要

required -真的意味着需要WS-Addressing使用。

responses -指定什么类型的反应是必需的

从以下版本开始：

JAX-WS 2.2

方法详细信息

getID

public String getID()

得到的唯一标识该webservicefeature。

Specified by:

getID 方法重写，继承类 WebServiceFeature

结果

此功能的唯一标识符。

isRequired

public boolean isRequired()

如果在启用，此属性确定是否需要WS-Addressing端点。如果需要的话是真的，寻址标题必须对传入和传出的消息是。

结果

当前所需的值

getResponses

public AddressingFeature.Responses getResponses()

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

结果

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

从以下版本开始：

JAX-WS 2.2