JavaTM Platform
Standard Ed. 6

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 - 如果调用该方法但不存在任何正被服务的请求,则抛出该异常。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策