javax.security.auth.callback
クラス ConfirmationCallback

java.lang.Object
  javax.security.auth.callback.ConfirmationCallback

すべての実装されたインタフェース:

Serializable, Callback

public class ConfirmationCallback
extends Object
implements Callback, Serializable

基本となるセキュリティーサービスでは、ConfirmationCallback をインスタンス化して CallbackHandler の handle メソッドに渡し、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 メソッドがこの値を返すのは、この ConfirmationCallback が optionType ではなく 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 の確認オプションです。

基本セキュリティーサービスでは、YES、NO、または 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 オプションです。

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

関連項目:

定数フィールド値

NO

public static final int NO

NO オプションです。

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

関連項目:

定数フィールド値

CANCEL

public static final int CANCEL

CANCEL オプションです。

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

関連項目:

定数フィールド値

OK

public static final int OK

OK オプションです。

この ConfirmationCallback で optionType が指定された場合、このオプションは 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 - メッセージ型 (INFORMATION、WARNING、または ERROR)

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

defaultOption - 指定された optionType のデフォルトのオプション (YES、NO、CANCEL、または OK)

例外:

IllegalArgumentException - messageType が INFORMATION、WARNING、ERROR のどれでもない場合、optionType が YES_NO_OPTION、YES_NO_CANCEL_OPTION、OK_CANCEL_OPTION のどれでもない場合、または defaultOption が optionType 内のオプションのどれにも対応しない場合

ConfirmationCallback

public ConfirmationCallback(int messageType,
                            String[] options,
                            int defaultOption)

ConfirmationCallback をメッセージ型、オプションのリスト、およびデフォルトのオプションを使用して構築します。

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

パラメータ:

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

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

defaultOption - options 配列のインデックスとして表されるデフォルトオプション

例外:

IllegalArgumentException - messageType が INFORMATION、WARNING、ERROR のどれでもない場合、options が null の場合、options の長さが 0 の場合、options の要素に null が含まれる場合、options の要素に長さ 0 のものがある場合、または defaultOption が options の配列範囲内にない場合

ConfirmationCallback

public ConfirmationCallback(String prompt,
                            int messageType,
                            int optionType,
                            int defaultOption)

ConfirmationCallback をプロンプト、メッセージ型、オプション型、およびデフォルトのオプションを使用して構築します。

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

パラメータ:

prompt - オプションのリストを記述するためのプロンプト

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

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

defaultOption - 指定された optionType のデフォルトのオプション (YES、NO、CANCEL、または OK)

例外:

IllegalArgumentException - prompt が null の場合、prompt の長さが 0 の場合、messageType が INFORMATION、WARNING、ERROR のどれでもない場合、optionType が YES_NO_OPTION、YES_NO_CANCEL_OPTION、OK_CANCEL_OPTION のどれでもない場合、または defaultOption が optionType 内のオプションのどれにも対応しない場合

ConfirmationCallback

public ConfirmationCallback(String prompt,
                            int messageType,
                            String[] options,
                            int defaultOption)

ConfirmationCallback をプロンプト、メッセージ型、オプションのリスト、およびデフォルトのオプションを使用して構築します。

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

パラメータ:

prompt - オプションのリストを記述するためのプロンプト

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

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

defaultOption - options 配列のインデックスとして表されるデフォルトオプション

例外:

IllegalArgumentException - prompt が null の場合、prompt の長さが 0 の場合、messageType が INFORMATION、WARNING、ERROR のどれでもない場合、options が null の場合、options の長さが 0 の場合、options の要素に null が含まれる場合、options の要素のどれかが長さ 0 の場合、または defaultOption が options の配列範囲内にない場合

メソッドの詳細

getPrompt

public String getPrompt()

プロンプトを取得します。

戻り値:

プロンプト。この ConfirmationCallback が prompt なしでインスタンス化された場合は null

getMessageType

public int getMessageType()

メッセージ型を取得します。

戻り値:

メッセージ型 (INFORMATION、WARNING、または ERROR)

getOptionType

public int getOptionType()

オプション型を取得します。

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

戻り値:

オプション型 (YES_NO_OPTION、YES_NO_CANCEL_OPTION、または OK_CANCEL_OPTION)。この ConfirmationCallback が optionType ではなく options でインスタンス化されている場合は UNSPECIFIED_OPTION

getOptions

public String[] getOptions()

確認オプションを取得します。

戻り値:

確認オプションのリスト。この ConfirmationCallback が options ではなく optionType でインスタンス化された場合は null

getDefaultOption

public int getDefaultOption()

デフォルトオプションを取得します。

戻り値:

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

setSelectedIndex

public void setSelectedIndex(int selection)

選択された確認オプションを設定します。

パラメータ:

selection - optionType がこの ConfirmationCallback のコンストラクタとして指定されている場合は、YES、NO、OK、または CANCEL を表す選択内容。そうでない場合は、この ConfirmationCallback のコンストラクタとして指定された options 配列のインデックスを表す選択内容

関連項目:

getSelectedIndex()

getSelectedIndex

public int getSelectedIndex()

選択された確認オプションを取得します。

戻り値:

optionType がこの ConfirmationCallback のコンストラクタとして指定されている場合は、YES、NO、OK、または CANCEL を表す選択した確認オプション。そうでない場合は、この ConfirmationCallback のコンストラクタとして指定された options 配列のインデックスとして、選択した確認オプションを返す

関連項目:

setSelectedIndex(int)