JavaTM Platform
Standard Ed. 6

javax.security.auth.callback
クラス ConfirmationCallback

java.lang.Object
  上位を拡張 javax.security.auth.callback.ConfirmationCallback
すべての実装されたインタフェース:
Serializable, Callback

public class ConfirmationCallback
extends Object
implements Callback, Serializable

基本となるセキュリティーサービスでは、ConfirmationCallback をインスタンス化して CallbackHandlerhandle メソッドに渡し、YES/NO、OK/CANCEL、YES/NO/CANCEL などの確認を要求します。

関連項目:
CallbackHandler, 直列化された形式

フィールドの概要
static int CANCEL
          CANCEL オプションです。
static int ERROR
          ERROR メッセージ型です。
static int INFORMATION
          INFORMATION メッセージ型です。
static int NO
          NO オプションです。
static int OK
          OK オプションです。
static int OK_CANCEL_OPTION
          OK/CANCEL の確認オプションです。
static int UNSPECIFIED_OPTION
          指定のないオプション型です。
static int WARNING
          WARNING メッセージ型です。
static int YES
          YES オプションです。
static int YES_NO_CANCEL_OPTION
          YES/NO/CANCEL の確認オプションです。
static int YES_NO_OPTION
          YES/NO の確認オプションです。
 
コンストラクタの概要
ConfirmationCallback(int messageType, int optionType, int defaultOption)
          ConfirmationCallback をメッセージ型、オプション型、およびデフォルトのオプションを使用して構築します。
ConfirmationCallback(int messageType, String[] options, int defaultOption)
          ConfirmationCallback をメッセージ型、オプションのリスト、およびデフォルトのオプションを使用して構築します。
ConfirmationCallback(String prompt, int messageType, int optionType, int defaultOption)
          ConfirmationCallback をプロンプト、メッセージ型、オプション型、およびデフォルトのオプションを使用して構築します。
ConfirmationCallback(String prompt, int messageType, String[] options, int defaultOption)
          ConfirmationCallback をプロンプト、メッセージ型、オプションのリスト、およびデフォルトのオプションを使用して構築します。
 
メソッドの概要
 int getDefaultOption()
          デフォルトオプションを取得します。
 int getMessageType()
          メッセージ型を取得します。
 String[] getOptions()
          確認オプションを取得します。
 int getOptionType()
          オプション型を取得します。
 String getPrompt()
          プロンプトを取得します。
 int getSelectedIndex()
          選択された確認オプションを取得します。
 void setSelectedIndex(int selection)
          選択された確認オプションを設定します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

フィールドの詳細

UNSPECIFIED_OPTION

public static final int UNSPECIFIED_OPTION
指定のないオプション型です。

getOptionType メソッドがこの値を返すのは、この ConfirmationCallbackoptionType ではなく options でインスタンス化された場合です。

関連項目:
定数フィールド値

YES_NO_OPTION

public static final int YES_NO_OPTION
YES/NO の確認オプションです。

基本セキュリティーサービスでは、YES または NO で回答できる確認を要求するときに、この確認オプションを optionType として ConfirmationCallback コンストラクタに指定します。

関連項目:
定数フィールド値

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION
YES/NO/CANCEL の確認オプションです。

基本セキュリティーサービスでは、YESNO、または CANCEL で回答できる確認を要求するときに、この確認オプションを optionType として ConfirmationCallback コンストラクタに指定します。

関連項目:
定数フィールド値

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION
OK/CANCEL の確認オプションです。

基本セキュリティーサービスでは、OK または CANCEL で回答できる確認を要求するときに、この確認オプションを optionType として ConfirmationCallback コンストラクタに指定します。

関連項目:
定数フィールド値

YES

public static final int YES
YES オプションです。

この ConfirmationCallbackoptionType が指定された場合、このオプションは defaultOption として指定されるか、選択したインデックスとして返されます。

関連項目:
定数フィールド値

NO

public static final int NO
NO オプションです。

この ConfirmationCallbackoptionType が指定された場合、このオプションは defaultOption として指定されるか、選択したインデックスとして返されます。

関連項目:
定数フィールド値

CANCEL

public static final int CANCEL
CANCEL オプションです。

この ConfirmationCallbackoptionType が指定された場合、このオプションは defaultOption として指定されるか、選択したインデックスとして返されます。

関連項目:
定数フィールド値

OK

public static final int OK
OK オプションです。

この ConfirmationCallbackoptionType が指定された場合、このオプションは defaultOption として指定されるか、選択したインデックスとして返されます。

関連項目:
定数フィールド値

INFORMATION

public static final int INFORMATION
INFORMATION メッセージ型です。

関連項目:
定数フィールド値

WARNING

public static final int WARNING
WARNING メッセージ型です。

関連項目:
定数フィールド値

ERROR

public static final int ERROR
ERROR メッセージ型です。

関連項目:
定数フィールド値
コンストラクタの詳細

ConfirmationCallback

public ConfirmationCallback(int messageType,
                            int optionType,
                            int defaultOption)
ConfirmationCallback をメッセージ型、オプション型、およびデフォルトのオプションを使用して構築します。

基本セキュリティーサービスでは、YES/NO、YES/NO/CANCEL、OK/CANCEL の各確認方法のどれかを要求する場合に、このコンストラクタを使用します。

パラメータ:
messageType - メッセージ型 (INFORMATIONWARNING、または ERROR)

optionType - オプション型 (YES_NO_OPTIONYES_NO_CANCEL_OPTION、または OK_CANCEL_OPTION)

defaultOption - 指定された optionType のデフォルトのオプション (YESNOCANCEL、または OK)
例外:
IllegalArgumentException - messageType が INFORMATIONWARNINGERROR のどれでもない場合、optionType が YES_NO_OPTIONYES_NO_CANCEL_OPTIONOK_CANCEL_OPTION のどれでもない場合、または defaultOptionoptionType 内のオプションのどれにも対応しない場合

ConfirmationCallback

public ConfirmationCallback(int messageType,
                            String[] options,
                            int defaultOption)
ConfirmationCallback をメッセージ型、オプションのリスト、およびデフォルトのオプションを使用して構築します。

基本のセキュリティーサービスでは、あらかじめ設定されている利用可能な確認方法とは異なる確認を要求する場合 (たとえば CONTINUE/ABORT や STOP/GO)、このコンストラクタを使用します。確認のオプションは、options 配列にリストされ、あらかじめ登録されているオプションと同様の形式で CallbackHandler 実装によって表示されます。

パラメータ:
messageType - メッセージ型 (INFORMATIONWARNING、または ERROR)

options - 確認オプションのリスト

defaultOption - options 配列のインデックスとして表されるデフォルトオプション
例外:
IllegalArgumentException - messageType が INFORMATIONWARNINGERROR のどれでもない場合、options が null の場合、options の長さが 0 の場合、options の要素に null が含まれる場合、options の要素に長さ 0 のものがある場合、または defaultOptionoptions の配列範囲内にない場合

ConfirmationCallback

public ConfirmationCallback(String prompt,
                            int messageType,
                            int optionType,
                            int defaultOption)
ConfirmationCallback をプロンプト、メッセージ型、オプション型、およびデフォルトのオプションを使用して構築します。

基本セキュリティーサービスでは、YES/NO、YES/NO/CANCEL、OK/CANCEL の各確認方法のどれかを要求する場合に、このコンストラクタを使用します。

パラメータ:
prompt - オプションのリストを記述するためのプロンプト

messageType - メッセージ型 (INFORMATIONWARNING、または ERROR)

optionType - オプション型 (YES_NO_OPTIONYES_NO_CANCEL_OPTION、または OK_CANCEL_OPTION)

defaultOption - 指定された optionType のデフォルトのオプション (YESNOCANCEL、または OK)
例外:
IllegalArgumentException - prompt が null の場合、prompt の長さが 0 の場合、messageType が INFORMATIONWARNINGERROR のどれでもない場合、optionType が YES_NO_OPTIONYES_NO_CANCEL_OPTIONOK_CANCEL_OPTION のどれでもない場合、または defaultOptionoptionType 内のオプションのどれにも対応しない場合

ConfirmationCallback

public ConfirmationCallback(String prompt,
                            int messageType,
                            String[] options,
                            int defaultOption)
ConfirmationCallback をプロンプト、メッセージ型、オプションのリスト、およびデフォルトのオプションを使用して構築します。

基本のセキュリティーサービスでは、あらかじめ設定されている利用可能な確認方法とは異なる確認を要求する場合 (たとえば CONTINUE/ABORT や STOP/GO)、このコンストラクタを使用します。確認のオプションは、options 配列にリストされ、あらかじめ登録されているオプションと同様の形式で CallbackHandler 実装によって表示されます。

パラメータ:
prompt - オプションのリストを記述するためのプロンプト

messageType - メッセージ型 (INFORMATIONWARNING、または ERROR)

options - 確認オプションのリスト

defaultOption - options 配列のインデックスとして表されるデフォルトオプション
例外:
IllegalArgumentException - prompt が null の場合、prompt の長さが 0 の場合、messageType が INFORMATIONWARNINGERROR のどれでもない場合、options が null の場合、options の長さが 0 の場合、options の要素に null が含まれる場合、options の要素のどれかが長さ 0 の場合、または defaultOptionoptions の配列範囲内にない場合
メソッドの詳細

getPrompt

public String getPrompt()
プロンプトを取得します。

戻り値:
プロンプト。この ConfirmationCallbackprompt なしでインスタンス化された場合は null

getMessageType

public int getMessageType()
メッセージ型を取得します。

戻り値:
メッセージ型 (INFORMATIONWARNING、または ERROR)

getOptionType

public int getOptionType()
オプション型を取得します。

このメソッドが UNSPECIFIED_OPTION を返す場合、この ConfirmationCallbackoptionType ではなく options でインスタンス化されています。このときは、getOptions を呼び出し、表示される確認オプションを確認してください。

戻り値:
オプション型 (YES_NO_OPTIONYES_NO_CANCEL_OPTION、または OK_CANCEL_OPTION)。この ConfirmationCallbackoptionType ではなく options でインスタンス化されている場合は UNSPECIFIED_OPTION

getOptions

public String[] getOptions()
確認オプションを取得します。

戻り値:
確認オプションのリスト。この ConfirmationCallbackoptions ではなく optionType でインスタンス化された場合は null

getDefaultOption

public int getDefaultOption()
デフォルトオプションを取得します。

戻り値:
optionType がこの ConfirmationCallback のコンストラクタとして指定されている場合は、YESNOOK、または CANCEL を表すデフォルトオプション。そうでない場合は、この ConfirmationCallback のコンストラクタとして指定された options 配列のインデックスとして、デフォルトオプションを返す

setSelectedIndex

public void setSelectedIndex(int selection)
選択された確認オプションを設定します。

パラメータ:
selection - optionType がこの ConfirmationCallback のコンストラクタとして指定されている場合は、YESNOOK、または CANCEL を表す選択内容。そうでない場合は、この ConfirmationCallback のコンストラクタとして指定された options 配列のインデックスを表す選択内容
関連項目:
getSelectedIndex()

getSelectedIndex

public int getSelectedIndex()
選択された確認オプションを取得します。

戻り値:
optionType がこの ConfirmationCallback のコンストラクタとして指定されている場合は、YESNOOK、または CANCEL を表す選択した確認オプション。そうでない場合は、この ConfirmationCallback のコンストラクタとして指定された options 配列のインデックスとして、選択した確認オプションを返す
関連項目:
setSelectedIndex(int)

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。