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, 序列化表格

UNSPECIFIED_OPTION

public static final int UNSPECIFIED_OPTION

未指定的选项类型。

如果此 ConfirmationCallback 是使用 options 而不是 optionType 实例化的，则 getOptionType 方法返回此值。

另请参见：

常量字段值

YES_NO_OPTION

public static final int YES_NO_OPTION

YES/NO 确认选项。

如果 ConfirmationCallback 构造方法需要一个以 YES 或 NO 作答的确认信息，则底层安全服务将此值指定为 ConfirmationCallback 构造方法的 optionType。

另请参见：

常量字段值

YES_NO_CANCEL_OPTION

public static final int YES_NO_CANCEL_OPTION

YES/NO/CANCEL 确认选项。

如果 ConfirmationCallback 构造方法需要一个以 YES、NO 或 CANCEL 作答的确认信息，则底层安全服务将此值指定为 ConfirmationCallback 构造方法的 optionType。

另请参见：

常量字段值

OK_CANCEL_OPTION

public static final int OK_CANCEL_OPTION

OK/CANCEL 确认选项。

如果 ConfirmationCallback 构造方法需要一个以 OK 或 CANCEL 作答的确认信息，则底层安全服务将此值指定为 ConfirmationCallback 构造方法的 optionType。

另请参见：

常量字段值

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 是使用 options 而不是 optionType 实例化的。在这种情况下，调用 getOptions 方法，以确定显示何种确认选项。

返回：

选项类型（YES_NO_OPTION、YES_NO_CANCEL_OPTION 或 OK_CANCEL_OPTION），如果此 ConfirmationCallback 是使用 options 而不是 optionType 实例化的，则返回 UNSPECIFIED_OPTION。

getOptions

public String[] getOptions()

获取确认选项。

返回：

确认选项列表，如果此 ConfirmationCallback 是使用 optionType 而不是 options 实例化的，则返回 null。

getDefaultOption

public int getDefaultOption()

获取默认选项。

返回：

默认选项，如果为此 ConfirmationCallback 的构造方法指定了 optionType，则表示为 YES、NO、OK 或 CANCEL。否则，此方法返回默认选项，作为为此 ConfirmationCallback 的构造方法指定的 options 数组中的索引。

setSelectedIndex

public void setSelectedIndex(int selection)

设置选中的确认选项。

参数：

selection - 如果为此 ConfirmationCallback 的构造方法指定了一个 optionType，则该 selection 表示为 YES、NO、OK 或 CANCEL。否则，该 selection 表示为为此 ConfirmationCallback 的构造方法指定的 options 数组中的索引。

另请参见：

getSelectedIndex()

getSelectedIndex

public int getSelectedIndex()

获取选中的确认选项。

返回：

如果为此 ConfirmationCallback 的构造方法指定了一个 optionType ，则返回选中的确认选项，表示为 YES、NO、OK 或 CANCEL。否则，此方法返回选中的确认选项，作为为此 ConfirmationCallback 的构造方法指定的 options 数组中的索引。

另请参见：

setSelectedIndex(int)

版权所有 2008 Sun Microsystems, Inc. 保留所有权利。请遵守GNU General Public License, version 2 only。