- All Implemented Interfaces:
Serializable
,Callback
Underlying security services instantiate and pass a
ConfirmationCallback
to the handle
method of a CallbackHandler
to ask for YES/NO,
OK/CANCEL, YES/NO/CANCEL or other similar confirmations.
- Since:
- 1.4
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
CANCEL option.static final int
ERROR message type.static final int
INFORMATION message type.static final int
NO option.static final int
OK option.static final int
OK/CANCEL confirmation option.static final int
Unspecified option type.static final int
WARNING message type.static final int
YES option.static final int
YES/NO/CANCEL confirmation option.static final int
YES/NO confirmation option. -
Constructor Summary
ConstructorDescriptionConfirmationCallback
(int messageType, int optionType, int defaultOption) Construct aConfirmationCallback
with a message type, an option type and a default option.ConfirmationCallback
(int messageType, String[] options, int defaultOption) Construct aConfirmationCallback
with a message type, a list of options and a default option.ConfirmationCallback
(String prompt, int messageType, int optionType, int defaultOption) Construct aConfirmationCallback
with a prompt, message type, an option type and a default option.ConfirmationCallback
(String prompt, int messageType, String[] options, int defaultOption) Construct aConfirmationCallback
with a prompt, message type, a list of options and a default option. -
Method Summary
Modifier and TypeMethodDescriptionint
Get the default option.int
Get the message type.String[]
Get the confirmation options.int
Get the option type.Get the prompt.int
Get the selected confirmation option.void
setSelectedIndex
(int selection) Set the selected confirmation option.
-
Field Details
-
UNSPECIFIED_OPTION
public static final int UNSPECIFIED_OPTIONUnspecified option type.The
getOptionType
method returns this value if thisConfirmationCallback
was instantiated withoptions
instead of anoptionType
.- See Also:
-
YES_NO_OPTION
public static final int YES_NO_OPTIONYES/NO confirmation option.An underlying security service specifies this as the
optionType
to aConfirmationCallback
constructor if it requires a confirmation which can be answered with eitherYES
orNO
.- See Also:
-
YES_NO_CANCEL_OPTION
public static final int YES_NO_CANCEL_OPTIONYES/NO/CANCEL confirmation option.An underlying security service specifies this as the
optionType
to aConfirmationCallback
constructor if it requires a confirmation which can be answered with eitherYES
,NO
orCANCEL
.- See Also:
-
OK_CANCEL_OPTION
public static final int OK_CANCEL_OPTIONOK/CANCEL confirmation option.An underlying security service specifies this as the
optionType
to aConfirmationCallback
constructor if it requires a confirmation which can be answered with eitherOK
orCANCEL
.- See Also:
-
YES
public static final int YESYES option.If an
optionType
was specified to thisConfirmationCallback
, this option may be specified as adefaultOption
or returned as the selected index.- See Also:
-
NO
public static final int NONO option.If an
optionType
was specified to thisConfirmationCallback
, this option may be specified as adefaultOption
or returned as the selected index.- See Also:
-
CANCEL
public static final int CANCELCANCEL option.If an
optionType
was specified to thisConfirmationCallback
, this option may be specified as adefaultOption
or returned as the selected index.- See Also:
-
OK
public static final int OKOK option.If an
optionType
was specified to thisConfirmationCallback
, this option may be specified as adefaultOption
or returned as the selected index.- See Also:
-
INFORMATION
public static final int INFORMATIONINFORMATION message type.- See Also:
-
WARNING
public static final int WARNINGWARNING message type.- See Also:
-
ERROR
public static final int ERRORERROR message type.- See Also:
-
-
Constructor Details
-
ConfirmationCallback
public ConfirmationCallback(int messageType, int optionType, int defaultOption) Construct aConfirmationCallback
with a message type, an option type and a default option.Underlying security services use this constructor if they require either a YES/NO, YES/NO/CANCEL or OK/CANCEL confirmation.
- Parameters:
messageType
- the message type (INFORMATION
,WARNING
orERROR
).optionType
- the option type (YES_NO_OPTION
,YES_NO_CANCEL_OPTION
orOK_CANCEL_OPTION
).defaultOption
- the default option from the provided optionType (YES
,NO
,CANCEL
orOK
).- Throws:
IllegalArgumentException
- if messageType is not eitherINFORMATION
,WARNING
, orERROR
, if optionType is not eitherYES_NO_OPTION
,YES_NO_CANCEL_OPTION
, orOK_CANCEL_OPTION
, or ifdefaultOption
does not correspond to one of the options inoptionType
.
-
ConfirmationCallback
Construct aConfirmationCallback
with a message type, a list of options and a default option.Underlying security services use this constructor if they require a confirmation different from the available preset confirmations provided (for example, CONTINUE/ABORT or STOP/GO). The confirmation options are listed in the
options
array, and are displayed by theCallbackHandler
implementation in a manner consistent with the way preset options are displayed.- Parameters:
messageType
- the message type (INFORMATION
,WARNING
orERROR
).options
- the list of confirmation options. The array is cloned to protect against subsequent modification.defaultOption
- the default option, represented as an index into theoptions
array.- Throws:
IllegalArgumentException
- if messageType is not eitherINFORMATION
,WARNING
, orERROR
, ifoptions
is null, ifoptions
has a length of 0, if any element fromoptions
is null, if any element fromoptions
has a length of 0, or ifdefaultOption
does not lie within the array boundaries ofoptions
.
-
ConfirmationCallback
Construct aConfirmationCallback
with a prompt, message type, an option type and a default option.Underlying security services use this constructor if they require either a YES/NO, YES/NO/CANCEL or OK/CANCEL confirmation.
- Parameters:
prompt
- the prompt used to describe the list of options.messageType
- the message type (INFORMATION
,WARNING
orERROR
).optionType
- the option type (YES_NO_OPTION
,YES_NO_CANCEL_OPTION
orOK_CANCEL_OPTION
).defaultOption
- the default option from the provided optionType (YES
,NO
,CANCEL
orOK
).- Throws:
IllegalArgumentException
- ifprompt
is null, ifprompt
has a length of 0, if messageType is not eitherINFORMATION
,WARNING
, orERROR
, if optionType is not eitherYES_NO_OPTION
,YES_NO_CANCEL_OPTION
, orOK_CANCEL_OPTION
, or ifdefaultOption
does not correspond to one of the options inoptionType
.
-
ConfirmationCallback
Construct aConfirmationCallback
with a prompt, message type, a list of options and a default option.Underlying security services use this constructor if they require a confirmation different from the available preset confirmations provided (for example, CONTINUE/ABORT or STOP/GO). The confirmation options are listed in the
options
array, and are displayed by theCallbackHandler
implementation in a manner consistent with the way preset options are displayed.- Parameters:
prompt
- the prompt used to describe the list of options.messageType
- the message type (INFORMATION
,WARNING
orERROR
).options
- the list of confirmation options. The array is cloned to protect against subsequent modification.defaultOption
- the default option, represented as an index into theoptions
array.- Throws:
IllegalArgumentException
- ifprompt
is null, ifprompt
has a length of 0, if messageType is not eitherINFORMATION
,WARNING
, orERROR
, ifoptions
is null, ifoptions
has a length of 0, if any element fromoptions
is null, if any element fromoptions
has a length of 0, or ifdefaultOption
does not lie within the array boundaries ofoptions
.
-
-
Method Details
-
getPrompt
Get the prompt.- Returns:
- the prompt, or null if this
ConfirmationCallback
was instantiated without aprompt
.
-
getMessageType
public int getMessageType()Get the message type.- Returns:
- the message type (
INFORMATION
,WARNING
orERROR
).
-
getOptionType
public int getOptionType()Get the option type.If this method returns
UNSPECIFIED_OPTION
, then thisConfirmationCallback
was instantiated withoptions
instead of anoptionType
. In this case, invoke thegetOptions
method to determine which confirmation options to display.- Returns:
- the option type (
YES_NO_OPTION
,YES_NO_CANCEL_OPTION
orOK_CANCEL_OPTION
), orUNSPECIFIED_OPTION
if thisConfirmationCallback
was instantiated withoptions
instead of anoptionType
.
-
getOptions
Get the confirmation options.- Returns:
- a copy of the list of confirmation options, or null if this
ConfirmationCallback
was instantiated with anoptionType
instead ofoptions
.
-
getDefaultOption
public int getDefaultOption()Get the default option.- Returns:
- the default option, represented as
YES
,NO
,OK
orCANCEL
if anoptionType
was specified to the constructor of thisConfirmationCallback
. Otherwise, this method returns the default option as an index into theoptions
array specified to the constructor of thisConfirmationCallback
.
-
setSelectedIndex
public void setSelectedIndex(int selection) Set the selected confirmation option.- Parameters:
selection
- the selection represented asYES
,NO
,OK
orCANCEL
if anoptionType
was specified to the constructor of thisConfirmationCallback
. Otherwise, the selection represents the index into theoptions
array specified to the constructor of thisConfirmationCallback
.- See Also:
-
getSelectedIndex
public int getSelectedIndex()Get the selected confirmation option.- Returns:
- the selected confirmation option represented as
YES
,NO
,OK
orCANCEL
if anoptionType
was specified to the constructor of thisConfirmationCallback
. Otherwise, this method returns the selected confirmation option as an index into theoptions
array specified to the constructor of thisConfirmationCallback
. - See Also:
-