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

Interface WebServiceContext


  • public interface WebServiceContext
    A WebServiceContext使Web服务端点实现类可以相对于正在服务的请求访问消息上下文和安全信息。 通常， WebServiceContext注入到使用端点实现类Resource注解。
    从以下版本开始：
    1.6，JAX-WS 2.0
    另请参见：
    Resource

    • 方法详细信息

      • getUserPrincipal

        Principal getUserPrincipal​()
        返回标识当前正在处理的请求的发件人的Principal。 如果发件人尚未认证，则该方法返回null 。
        结果
        校长主要对象。
        异常
        IllegalStateException - 如果在没有请求服务的情况下调用该方法，则抛出此异常。
        另请参见：
        Principal ， IllegalStateException

      • isUserInRole

        boolean isUserInRole​(String role)
        返回一个布尔值，指示经过身份验证的用户是否包含在指定的逻辑角色中。 如果用户尚未认证，该方法返回false 。
        参数
        role - 指定角色名称的 String
        结果
        一个 boolean指示请求的发件人是否属于给定的角色
        异常
        IllegalStateException - 如果在没有请求服务的情况下调用该方法，则抛出此异常。

      • getEndpointReference

        EndpointReference getEndpointReference​(Element... referenceParameters)
        返回此端点的EndpointReference 。

        如果这个bindingProvider的bindingProvider是SOAP1.1 / HTTP或SOAP1.2 / HTTP，那么必须返回一个W3CEndpointReference 。

        参数
        referenceParameters - 与返回的 EndpointReference实例相关联的参考参数。
        结果
        与此WebServiceContext相关联的端点的EndpointReference。 如果返回的EndpointReference是W3CEndpointReference那么它必须包含指定的referenceParameters 。
        异常
        IllegalStateException - 如果在没有请求服务的情况下调用该方法，则抛出此异常。
        从以下版本开始：
        1.6，JAX-WS 2.1
        另请参见：
        W3CEndpointReference

      • getEndpointReference

        <T extends EndpointReference> T getEndpointReference​(Class<T> clazz,
                                                     Element... referenceParameters)
        返回与此端点关联的 EndpointReference 。
        参数类型
        T - 类型 EndpointReference 。
        参数
        clazz - 必须返回的类型为 EndpointReference 。
        referenceParameters - 与返回的 EndpointReference实例关联的参考参数。
        结果
        与此WebServiceContext实例相关联的端点类型为clazz的EndpointReference。 如果返回的EndpointReference是W3CEndpointReference那么它必须包含指定的referenceParameters 。
        异常
        IllegalStateException - 如果在没有请求服务的情况下调用该方法，则抛出此异常。
        WebServiceException - 如果不支持 clazz类型的 EndpointReference 。
        从以下版本开始：
        1.6，JAX-WS 2.1