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 - 如果調用該方法但不存在任何正被服務的請求，則拋出該異常。