- java.lang.Object
-
- javax.xml.ws.WebServiceFeature
-
- javax.xml.ws.RespectBindingFeature
-
public final class RespectBindingFeature extends WebServiceFeature
此功能说明了在JAX-WS运行时中使用wsdl:binding
。 此功能可以在创建SEI代理的过程中使用,并Dispatch
个在客户端实例和Endpoint
个在服务器端实例。 此功能不能用于客户端上的Service
实例创建。此功能仅适用于具有关联WSDL的Web服务。 启用此功能需要JAX-WS实现在运行时检查端点的
wsdl:binding
,以确保将required
属性设置为true
所有wsdl:extensions
都被理解并正在使用。以下描述了此功能对启用或禁用的影响:
- ENABLED:在此模式下,JAX-WS运行时必须确保所有必需的
wsdl:binding
扩展(包括策略)被运行时理解和使用,或由Web服务应用程序明确禁用。 如果有对应的WebServiceFeature
或注释,Web服务可以禁用特定扩展。 类似地,Web服务客户端可以在创建代理或Dispatch实例时使用相应的WebServiceFeature
禁用特定扩展。 运行时还必须确保SEI参数/返回值的绑定符合wsdl:binding
。 启用此功能后,如果WSDL中有所需的(wsdl:required="true"
)wsdl:binding
扩展,并且JAX-WS运行时不支持此功能,并且尚未由Web服务开发人员显式关闭该扩展,则该JAX-WS运行时必须执行适当地基于它是在客户端还是服务器上:- 客户端:运行时必须在调用上述方法之前不迟于第一次调用端点操作时抛出一个
WebServiceException
。 - 服务器:抛出一个
WebServiceException
并且终端必须无法部署
- 客户端:运行时必须在调用上述方法之前不迟于第一次调用端点操作时抛出一个
- 禁用:在此模式下,实施可以选择是否检查
wsdl:binding
,以及wsdl:binding
将被检查的程度。 例如,一个实现可以选择表现为该特征被启用,另一个实现可以仅选择验证SEI的参数/返回类型绑定。
- 从以下版本开始:
- 1.6,JAX-WS 2.1
- 另请参见:
-
AddressingFeature
- ENABLED:在此模式下,JAX-WS运行时必须确保所有必需的
-
-
Field Summary
Fields Modifier and Type Field 描述 static String
ID
识别RespectBindingFeature的常量值-
Fields inherited from class javax.xml.ws.WebServiceFeature
enabled
-
-
构造方法摘要
构造方法 Constructor 描述 RespectBindingFeature()
创建一个RespectBindingFeature
。RespectBindingFeature(boolean enabled)
创建一个RespectBindingFeature
-
-
-
字段详细信息
-
ID
public static final String ID
识别RespectBindingFeature的常量值- 另请参见:
- Constant Field Values
-
-
方法详细信息
-
getID
public String getID()
获取此WebServiceFeature的唯一标识符。- Specified by:
-
getID
在WebServiceFeature
- 结果
- 该功能的唯一标识符。
-
-