メソッドの詳細

• getMessageContext

  MessageContext getMessageContext()

  メソッド getMessageContext は、このエンドポイントインスタンスを対象とする MessageContext を返します。これにより、サービスエンドポイントインスタンスは、リクエスト HandlerChain （およびそれに含まれる Handler インスタンス）によって伝播された MessageContext をターゲットエンドポイントインスタンスにアクセスし、SOAP メッセージ処理関連のコンテキストを共有できます。エンドポイントインスタンスは、MessageContext にアクセスして操作し、SOAP メッセージ処理関連のコンテキストをレスポンス HandlerChain と共有できます。

  戻り値:

  MessageContext; 関連する MessageContext がない場合、このメソッドは null を返します。

  例外:

  IllegalStateExceptionSE - このメソッドがサービスエンドポイントインスタンスによってリモートメソッド実装の外部で呼び出された場合。

  関連事項:

  MessageContext, HandlerChain, Handler

• getUserPrincipal

  PrincipalSE getUserPrincipal()

  エンドポイントインスタンスでの現在のメソッド呼び出しの認証済みユーザーの名前を含む java.security.Principal インスタンスを返します。関連付けられたプリンシパルがまだない場合、このメソッドは null を返します。基盤となる Jakarta XML RPC ランタイムシステムは、サービスエンドポイントインスタンスでのリモートメソッド呼び出しに適切な認証済みプリンシパルを提供する責任を負います。

  戻り値:

  サーブレットエンドポイントインスタンスでの現在の呼び出しに関連付けられた認証済みプリンシパルの java.security.Principal。メソッド呼び出しに関連付けられた認証済みユーザーがいない場合は、null を返します。

  関連事項:

  PrincipalSE

• getHttpSession

  HttpSession getHttpSession()

  getHttpSession メソッドは、現在の HTTP セッションを（javax.servlet.http.HTTPSession として）返します。リモートメソッド実装内のサービスエンドポイントによって呼び出されると、getHttpSession はこのメソッド呼び出しに現在関連付けられている HTTP セッションを返します。現在アクティブでこのサービスエンドポイントに関連付けられている HTTP セッションがない場合、このメソッドは null を返します。エンドポイントクラスは、アクティブな HTTP セッションが常に存在することに依存するべきではありません。基盤となる Jakarta XML RPC ランタイムシステムは、アクティブな HTTP セッションがあるかどうかを管理するロールを果たします。

  getHttpSession メソッドは、HTTP にバインドされていないエンドポイントによって呼び出された場合、JAXRPCException をスローします。

  戻り値:

  現在の呼び出しに関連付けられている HTTP セッション、またはアクティブなセッションがない場合は null。

  例外:

  JAXRPCException - このメソッドが HTTP にバインドされていないエンドポイントによって呼び出された場合

  関連事項:

  HttpSession

• getServletContext

  ServletContext getServletContext()

  メソッド getServletContext は、このエンドポイントを含む Web アプリケーションに関連付けられた ServletContext を返します。サーブレットの仕様によると、JVM ごとに Web アプリケーション（WAR としてインストールされる）ごとに 1 つのコンテキストがあります。サーブレットベースのサービスエンドポイントは、Web アプリケーションの一部としてデプロイされます。

  戻り値:

  ServletContext

  関連事項:

  ServletContext

• isUserInRole

  boolean isUserInRole(StringSE role)

  エンドポイントインスタンスでの現在のメソッド呼び出しの認証済みユーザーが、指定された論理「ロール」に含まれているかどうかを示すブール値を返します。

  パラメーター:

  role - ロールの名前を指定する String 

  戻り値:

  現在のメソッド呼び出しに関連付けられている認証済みユーザーが特定のロールに属しているかどうかを示す boolean。ユーザーが認証されていない場合は false