-
public interface WebServiceContext
AWebServiceContext
使Web服务端点实现类可以相对于正在服务的请求访问消息上下文和安全信息。 通常,WebServiceContext
注入到使用端点实现类Resource
注解。- 从以下版本开始:
- 1.6,JAX-WS 2.0
- 另请参见:
-
Resource
-
-
方法摘要
所有方法 接口方法 抽象方法 Modifier and Type 方法 描述 <T extends EndpointReference>
TgetEndpointReference(Class<T> clazz, Element... referenceParameters)
返回与此端点关联的EndpointReference
。EndpointReference
getEndpointReference(Element... referenceParameters)
返回此端点的EndpointReference
。MessageContext
getMessageContext()
在MessageContext
此方法时,返回MessageContext
提供的请求的MessageContext
。Principal
getUserPrincipal()
返回标识当前正在处理的请求的发件人的Principal。boolean
isUserInRole(String role)
返回一个布尔值,指示经过身份验证的用户是否包含在指定的逻辑角色中。
-
-
-
方法详细信息
-
getMessageContext
MessageContext getMessageContext()
在MessageContext
此方法时,返回MessageContext
提供的请求的MessageContext
。 只有具有APPLICATION范围的属性才能对应用程序可见。- 结果
- MessageContext消息上下文。
- 异常
-
IllegalStateException
- 如果在没有请求服务的情况下调用该方法,则抛出此异常。 - 另请参见:
-
MessageContext
,MessageContext.Scope
,IllegalStateException
-
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
-
-