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

Interface BindingProvider

  • All Known Subinterfaces:
    Dispatch<T> 

    public interface BindingProvider
    BindingProvider接口提供对协议绑定和相关联的上下文对象的访问以用于请求和响应消息处理。
    从以下版本开始：
    1.6，JAX-WS 2.0
    另请参见：
    Binding

    • 字段详细信息

      • USERNAME_PROPERTY

        static final String USERNAME_PROPERTY
        标准属性：认证用户名。

        类型： java.lang.String

        另请参见：
        Constant Field Values

      • PASSWORD_PROPERTY

        static final String PASSWORD_PROPERTY
        标准属性：验证密码。

        类型： java.lang.String

        另请参见：
        Constant Field Values

      • ENDPOINT_ADDRESS_PROPERTY

        static final String ENDPOINT_ADDRESS_PROPERTY
        标准属性：目标服务端点地址。 端点地址规范的URI方案必须对应于正在使用的绑定的协议/传输绑定。

        类型： java.lang.String

        另请参见：
        Constant Field Values

      • SESSION_MAINTAIN_PROPERTY

        static final String SESSION_MAINTAIN_PROPERTY
        标准属性：此布尔属性由服务客户端用于指示是否要参与与服务端点的会话。 如果此属性设置为true ，则服务客户端指示它要维护会话。 如果设置为false ，则会话不被维护。 该属性的默认值为false 。

        类型： java.lang.Boolean

        另请参见：
        Constant Field Values

      • SOAPACTION_USE_PROPERTY

        static final String SOAPACTION_USE_PROPERTY
        SOAPAction的标准属性。 该布尔属性指示是否使用了javax.xml.ws.soap.http.soapaction.uri属性的值作为SOAPAction的值。 此属性的默认值为false表示javax.xml.ws.soap.http.soapaction.uri属性不用于SOAPAction的值，但如果启用了WS-Addressing，则默认值为true 。

        类型： java.lang.Boolean

        另请参见：
        Constant Field Values

      • SOAPACTION_URI_PROPERTY

        static final String SOAPACTION_URI_PROPERTY
        SOAPAction的标准属性。 如果javax.xml.ws.soap.http.soapaction.use属性设置为true则指示SOAPAction URI。 如果启用了WS-Addressing，则该值也将用于WS-Addressing Action头的值。 如果未设置此属性，将发送默认的SOAPAction和WS-Addressing操作。

        类型： java.lang.String

        另请参见：
        Constant Field Values

    • 方法详细信息

      • getRequestContext

        Map<String,Object> getRequestContext​()
        获取用于初始化请求消息的消息上下文的上下文。 对请求上下文的修改不会影响已经启动的同步或异步操作的消息上下文。
        结果
        用于处理请求消息的上下文。

      • getResponseContext

        Map<String,Object> getResponseContext​()
        获取处理响应消息产生的上下文。 返回的上下文是最近完成的同步操作。 随后的同步操作调用将覆盖响应上下文。 异步操作通过响应界面返回其响应上下文。
        结果
        处理最新回应讯息产生的上下文。

      • getBinding

        Binding getBinding​()
        获取此绑定提供程序的绑定。
        结果
        此绑定提供程序的绑定。

      • getEndpointReference

        EndpointReference getEndpointReference​()
        返回EndpointReference与此相关BindingProvider实例。

        如果此bindingProvider的绑定是SOAP1.1 / HTTP或SOAP1.2 / HTTP，则必须返回一个W3CEndpointReference 。

        结果
        与此 BindingProvider实例相关联的目标端点的EndpointReference。
        异常
        UnsupportedOperationException - 如果此 BindingProvider使用XML / HTTP绑定。
        从以下版本开始：
        1.6，JAX-WS 2.1
        另请参见：
        W3CEndpointReference

      • getEndpointReference

        <T extends EndpointReference> T getEndpointReference​(Class<T> clazz)
        返回EndpointReference与此相关BindingProvider实例。 返回的实例将为clazz 。
        参数类型
        T - 类型 EndpointReference
        参数
        clazz - 指定必须返回的类型 EndpointReference 。
        结果
        与此BindingProvider实例相关联的目标端点的EndpointReference。 必须是clazz 。
        异常
        WebServiceException - 如果此实现不支持类别 clazz 。
        UnsupportedOperationException - 如果这个 BindingProvider使用XML / HTTP绑定。
        从以下版本开始：
        1.6，JAX-WS 2.1