Cosminexus アプリケーションサーバ V8 リファレンス API編

[目次][索引][前へ][次へ]

handleメソッド

説明

認証情報を取得し,WebPasswordCallbackオブジェクト(Callbackの実装クラス)のリファレンスに設定してユーザ認証ライブラリのログインモジュールに渡します。

形式

public void handle(Callback[] callbacks)
  throws IOException, UnsupportedCallbackException;

パラメタ

callbacks:
WebPasswordCallbackオブジェクトのリファレンスを指定されていた場合,認証情報を設定して返却します。WebSSOCallbackオブジェクトのリファレンスが指定されていた場合は,セッション情報を設定して返却します。上記以外のオブジェクトのリファレンスが指定されていた場合は,UnsupportedCallbackException例外が発生します。

例外

java.io.IOException:
HttpServletRequest内にユーザID/パスワードの情報がありません。取り出すパラメタ名は,「注意事項」を参照してください。

javax.security.auth.callback.UnsupportedCallbackException:
サポートしていないcallbacksリファレンスが指定されていました。

戻り値

callbacksに値を設定して返却します。このメソッドでは,戻り値はありません。

注意事項

認証情報は,次の図に示す順序で読み込まれます。

図8-1 認証情報の読み込み順序

[図データ]

HttpServletRequest内の認証情報は,次に示すパラメタ名から取得します。