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

Class 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
    • 构造方法详细信息

      • RespectBindingFeature

        public RespectBindingFeature​()
        创建一个RespectBindingFeature 创建的实例将被启用。
      • RespectBindingFeature

        public RespectBindingFeature​(boolean enabled)
        创建一个RespectBindingFeature
        参数
        enabled - 指定是否启用此功能。
    • 方法详细信息

      • getID

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