javax.xml.ws
接口 WebServiceContext

public interface WebServiceContext

WebServiceContext 能使 Web 服务端点实现类访问与服务的请求有关的消息上下文和安全信息。 通常，使用 Resource 注释将 WebServiceContext 注入到端点实现类中。

从以下版本开始：

JAX-WS 2.0

另请参见：

Resource

方法摘要

MessageContext	getMessageContext() 调用此方法时，返回正在服务的请求的 MessageContext。
Principal	getUserPrincipal() 返回标识当前正服务请求发送方的 Principal。
boolean	isUserInRole(String role) 返回一个布尔值，指示指定的逻辑角色中是否包含经过验证的用户。

方法详细信息

getMessageContext

MessageContext getMessageContext()

调用此方法时，返回正在服务的请求的 MessageContext。应用程序只能看到具有 APPLICATION 作用域的属性。

返回：

MessageContext 消息上下文。

抛出：

IllegalStateException - 如果调用该方法但不存在任何正被服务的请求，则抛出该异常。

另请参见：

MessageContext, MessageContext.Scope, IllegalStateException

getUserPrincipal

Principal getUserPrincipal()

返回标识当前正服务请求发送方的 Principal。如果发送方没有经过验证，则该方法返回 null。

返回：

Principal 主体对象。

抛出：

IllegalStateException - 如果调用该方法但不存在任何正被服务的请求，则抛出该异常。

另请参见：

Principal, IllegalStateException

isUserInRole

boolean isUserInRole(String role)

返回一个布尔值，指示指定的逻辑角色中是否包含经过验证的用户。如果用户没有经过验证，则该方法返回 false。

参数：

role - 指定角色名称的 String

返回：

一个 boolean 值，指示请求的发送方是否属于给定角色

抛出：

IllegalStateException - 如果调用该方法但不存在任何正被服务的请求，则抛出该异常。