java/6 : javax/security/auth/callback/ConfirmationCallback.java

ConfirmationCallback
https://openjdk.java.net/
GPLv2 + Classpath Exception
/*
 * Copyright (c) 1999, 2003, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package javax.security.auth.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.
See Also: CallbackHandler/**
 * <p> Underlying security services instantiate and pass a
 * <code>ConfirmationCallback</code> to the <code>handle</code>
 * method of a <code>CallbackHandler</code> to ask for YES/NO,
 * OK/CANCEL, YES/NO/CANCEL or other similar confirmations.
 *
 * @see javax.security.auth.callback.CallbackHandler
 */
public class ConfirmationCallback implements Callback, java.io.Serializable {

    private static final long serialVersionUID = -9095656433782481624L;

    Unspecified option type.
 The getOptionType method returns this
value if this ConfirmationCallback was instantiated
with options instead of an optionType.
/**
     * Unspecified option type.
     *
     * <p> The <code>getOptionType</code> method returns this
     * value if this <code>ConfirmationCallback</code> was instantiated
     * with <code>options</code> instead of an <code>optionType</code>.
     */
    public static final int UNSPECIFIED_OPTION          = -1;

    YES/NO confirmation option.
 An underlying security service specifies this as the
optionType to a ConfirmationCallback
constructor if it requires a confirmation which can be answered
with either YES or NO.
/**
     * YES/NO confirmation option.
     *
     * <p> An underlying security service specifies this as the
     * <code>optionType</code> to a <code>ConfirmationCallback</code>
     * constructor if it requires a confirmation which can be answered
     * with either <code>YES</code> or <code>NO</code>.
     */
    public static final int YES_NO_OPTION               = 0;

    YES/NO/CANCEL confirmation confirmation option.
 An underlying security service specifies this as the
optionType to a ConfirmationCallback
constructor if it requires a confirmation which can be answered
with either YES, NO or CANCEL.
/**
     * YES/NO/CANCEL confirmation confirmation option.
     *
     * <p> An underlying security service specifies this as the
     * <code>optionType</code> to a <code>ConfirmationCallback</code>
     * constructor if it requires a confirmation which can be answered
     * with either <code>YES</code>, <code>NO</code> or <code>CANCEL</code>.
     */
    public static final int YES_NO_CANCEL_OPTION        = 1;

    OK/CANCEL confirmation confirmation option.
 An underlying security service specifies this as the
optionType to a ConfirmationCallback
constructor if it requires a confirmation which can be answered
with either OK or CANCEL.
/**
     * OK/CANCEL confirmation confirmation option.
     *
     * <p> An underlying security service specifies this as the
     * <code>optionType</code> to a <code>ConfirmationCallback</code>
     * constructor if it requires a confirmation which can be answered
     * with either <code>OK</code> or <code>CANCEL</code>.
     */
    public static final int OK_CANCEL_OPTION            = 2;

    YES option.
 If an optionType was specified to this
ConfirmationCallback, this option may be specified as a
defaultOption or returned as the selected index.
/**
     * YES option.
     *
     * <p> If an <code>optionType</code> was specified to this
     * <code>ConfirmationCallback</code>, this option may be specified as a
     * <code>defaultOption</code> or returned as the selected index.
     */
    public static final int YES                         = 0;

    NO option.
 If an optionType was specified to this
ConfirmationCallback, this option may be specified as a
defaultOption or returned as the selected index.
/**
     * NO option.
     *
     * <p> If an <code>optionType</code> was specified to this
     * <code>ConfirmationCallback</code>, this option may be specified as a
     * <code>defaultOption</code> or returned as the selected index.
     */
    public static final int NO                          = 1;

    CANCEL option.
 If an optionType was specified to this
ConfirmationCallback, this option may be specified as a
defaultOption or returned as the selected index.
/**
     * CANCEL option.
     *
     * <p> If an <code>optionType</code> was specified to this
     * <code>ConfirmationCallback</code>, this option may be specified as a
     * <code>defaultOption</code> or returned as the selected index.
     */
    public static final int CANCEL                      = 2;

    OK option.
 If an optionType was specified to this
ConfirmationCallback, this option may be specified as a
defaultOption or returned as the selected index.
/**
     * OK option.
     *
     * <p> If an <code>optionType</code> was specified to this
     * <code>ConfirmationCallback</code>, this option may be specified as a
     * <code>defaultOption</code> or returned as the selected index.
     */
    public static final int OK                          = 3;

    INFORMATION message type.  /** INFORMATION message type.  */
    public static final int INFORMATION                 = 0;

    WARNING message type. /** WARNING message type. */
    public static final int WARNING                     = 1;

    ERROR message type. /** ERROR message type. */
    public static final int ERROR                       = 2;
    @serial 
Since: 1.4/**
     * @serial
     * @since 1.4
     */
    private String prompt;
    @serial 
Since: 1.4/**
     * @serial
     * @since 1.4
     */
    private int messageType;
    @serial 
Since: 1.4/**
     * @serial
     * @since 1.4
     */
    private int optionType = UNSPECIFIED_OPTION;
    @serial 
Since: 1.4/**
     * @serial
     * @since 1.4
     */
    private int defaultOption;
    @serial 
Since: 1.4/**
     * @serial
     * @since 1.4
     */
    private String[] options;
    @serial 
Since: 1.4/**
     * @serial
     * @since 1.4
     */
    private int selection;

    Construct a ConfirmationCallback 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.

Params: messageType – the message type (INFORMATION,
                 WARNING or ERROR). 
optionType – the option type (YES_NO_OPTION,
                 YES_NO_CANCEL_OPTION or
                 OK_CANCEL_OPTION). 
defaultOption – the default option
                 from the provided optionType (YES,
                 NO, CANCEL or
                 OK).
Throws: IllegalArgumentException – if messageType is not either
                 INFORMATION, WARNING,
                 or ERROR, if optionType is not either
                 YES_NO_OPTION,
                 YES_NO_CANCEL_OPTION, or
                 OK_CANCEL_OPTION,
                 or if defaultOption
                 does not correspond to one of the options in
                 optionType./**
     * Construct a <code>ConfirmationCallback</code> with a
     * message type, an option type and a default option.
     *
     * <p> Underlying security services use this constructor if
     * they require either a YES/NO, YES/NO/CANCEL or OK/CANCEL
     * confirmation.
     *
     * <p>
     *
     * @param messageType the message type (<code>INFORMATION</code>,
     *                  <code>WARNING</code> or <code>ERROR</code>). <p>
     *
     * @param optionType the option type (<code>YES_NO_OPTION</code>,
     *                  <code>YES_NO_CANCEL_OPTION</code> or
     *                  <code>OK_CANCEL_OPTION</code>). <p>
     *
     * @param defaultOption the default option
     *                  from the provided optionType (<code>YES</code>,
     *                  <code>NO</code>, <code>CANCEL</code> or
     *                  <code>OK</code>).
     *
     * @exception IllegalArgumentException if messageType is not either
     *                  <code>INFORMATION</code>, <code>WARNING</code>,
     *                  or <code>ERROR</code>, if optionType is not either
     *                  <code>YES_NO_OPTION</code>,
     *                  <code>YES_NO_CANCEL_OPTION</code>, or
     *                  <code>OK_CANCEL_OPTION</code>,
     *                  or if <code>defaultOption</code>
     *                  does not correspond to one of the options in
     *                  <code>optionType</code>.
     */
    public ConfirmationCallback(int messageType,
                int optionType, int defaultOption) {

        if (messageType < INFORMATION || messageType > ERROR ||
            optionType < YES_NO_OPTION || optionType > OK_CANCEL_OPTION)
            throw new IllegalArgumentException();

        switch (optionType) {
        case YES_NO_OPTION:
            if (defaultOption != YES && defaultOption != NO)
                throw new IllegalArgumentException();
            break;
        case YES_NO_CANCEL_OPTION:
            if (defaultOption != YES && defaultOption != NO &&
                defaultOption != CANCEL)
                throw new IllegalArgumentException();
            break;
        case OK_CANCEL_OPTION:
            if (defaultOption != OK && defaultOption != CANCEL)
                throw new IllegalArgumentException();
            break;
        }

        this.messageType = messageType;
        this.optionType = optionType;
        this.defaultOption = defaultOption;
    }

    Construct a ConfirmationCallback 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 the CallbackHandler implementation
in a manner consistent with the way preset options are displayed.

Params: messageType – the message type (INFORMATION,
                 WARNING or ERROR). 
options – the list of confirmation options. 
defaultOption – the default option, represented as an index
                 into the options array.
Throws: IllegalArgumentException – if messageType is not either
                 INFORMATION, WARNING,
                 or ERROR, if options is null,
                 if options has a length of 0,
                 if any element from options is null,
                 if any element from options
                 has a length of 0, or if defaultOption
                 does not lie within the array boundaries of
                 options./**
     * Construct a <code>ConfirmationCallback</code> with a
     * message type, a list of options and a default option.
     *
     * <p> 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 <code>options</code> array,
     * and are displayed by the <code>CallbackHandler</code> implementation
     * in a manner consistent with the way preset options are displayed.
     *
     * <p>
     *
     * @param messageType the message type (<code>INFORMATION</code>,
     *                  <code>WARNING</code> or <code>ERROR</code>). <p>
     *
     * @param options the list of confirmation options. <p>
     *
     * @param defaultOption the default option, represented as an index
     *                  into the <code>options</code> array.
     *
     * @exception IllegalArgumentException if messageType is not either
     *                  <code>INFORMATION</code>, <code>WARNING</code>,
     *                  or <code>ERROR</code>, if <code>options</code> is null,
     *                  if <code>options</code> has a length of 0,
     *                  if any element from <code>options</code> is null,
     *                  if any element from <code>options</code>
     *                  has a length of 0, or if <code>defaultOption</code>
     *                  does not lie within the array boundaries of
     *                  <code>options</code>.
     */
    public ConfirmationCallback(int messageType,
                String[] options, int defaultOption) {

        if (messageType < INFORMATION || messageType > ERROR ||
            options == null || options.length == 0 ||
            defaultOption < 0 || defaultOption >= options.length)
            throw new IllegalArgumentException();

        for (int i = 0; i < options.length; i++) {
            if (options[i] == null || options[i].length() == 0)
                throw new IllegalArgumentException();
        }

        this.messageType = messageType;
        this.options = options;
        this.defaultOption = defaultOption;
    }

    Construct a ConfirmationCallback 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.

Params: prompt – the prompt used to describe the list of options. 
messageType – the message type (INFORMATION,
                 WARNING or ERROR). 
optionType – the option type (YES_NO_OPTION,
                 YES_NO_CANCEL_OPTION or
                 OK_CANCEL_OPTION). 
defaultOption – the default option
                 from the provided optionType (YES,
                 NO, CANCEL or
                 OK).
Throws: IllegalArgumentException – if prompt is null,
                 if prompt has a length of 0,
                 if messageType is not either
                 INFORMATION, WARNING,
                 or ERROR, if optionType is not either
                 YES_NO_OPTION,
                 YES_NO_CANCEL_OPTION, or
                 OK_CANCEL_OPTION,
                 or if defaultOption
                 does not correspond to one of the options in
                 optionType./**
     * Construct a <code>ConfirmationCallback</code> with a prompt,
     * message type, an option type and a default option.
     *
     * <p> Underlying security services use this constructor if
     * they require either a YES/NO, YES/NO/CANCEL or OK/CANCEL
     * confirmation.
     *
     * <p>
     *
     * @param prompt the prompt used to describe the list of options. <p>
     *
     * @param messageType the message type (<code>INFORMATION</code>,
     *                  <code>WARNING</code> or <code>ERROR</code>). <p>
     *
     * @param optionType the option type (<code>YES_NO_OPTION</code>,
     *                  <code>YES_NO_CANCEL_OPTION</code> or
     *                  <code>OK_CANCEL_OPTION</code>). <p>
     *
     * @param defaultOption the default option
     *                  from the provided optionType (<code>YES</code>,
     *                  <code>NO</code>, <code>CANCEL</code> or
     *                  <code>OK</code>).
     *
     * @exception IllegalArgumentException if <code>prompt</code> is null,
     *                  if <code>prompt</code> has a length of 0,
     *                  if messageType is not either
     *                  <code>INFORMATION</code>, <code>WARNING</code>,
     *                  or <code>ERROR</code>, if optionType is not either
     *                  <code>YES_NO_OPTION</code>,
     *                  <code>YES_NO_CANCEL_OPTION</code>, or
     *                  <code>OK_CANCEL_OPTION</code>,
     *                  or if <code>defaultOption</code>
     *                  does not correspond to one of the options in
     *                  <code>optionType</code>.
     */
    public ConfirmationCallback(String prompt, int messageType,
                int optionType, int defaultOption) {

        if (prompt == null || prompt.length() == 0 ||
            messageType < INFORMATION || messageType > ERROR ||
            optionType < YES_NO_OPTION || optionType > OK_CANCEL_OPTION)
            throw new IllegalArgumentException();

        switch (optionType) {
        case YES_NO_OPTION:
            if (defaultOption != YES && defaultOption != NO)
                throw new IllegalArgumentException();
            break;
        case YES_NO_CANCEL_OPTION:
            if (defaultOption != YES && defaultOption != NO &&
                defaultOption != CANCEL)
                throw new IllegalArgumentException();
            break;
        case OK_CANCEL_OPTION:
            if (defaultOption != OK && defaultOption != CANCEL)
                throw new IllegalArgumentException();
            break;
        }

        this.prompt = prompt;
        this.messageType = messageType;
        this.optionType = optionType;
        this.defaultOption = defaultOption;
    }

    Construct a ConfirmationCallback 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 the CallbackHandler implementation
in a manner consistent with the way preset options are displayed.

Params: prompt – the prompt used to describe the list of options. 
messageType – the message type (INFORMATION,
                 WARNING or ERROR). 
options – the list of confirmation options. 
defaultOption – the default option, represented as an index
                 into the options array.
Throws: IllegalArgumentException – if prompt is null,
                 if prompt has a length of 0,
                 if messageType is not either
                 INFORMATION, WARNING,
                 or ERROR, if options is null,
                 if options has a length of 0,
                 if any element from options is null,
                 if any element from options
                 has a length of 0, or if defaultOption
                 does not lie within the array boundaries of
                 options./**
     * Construct a <code>ConfirmationCallback</code> with a prompt,
     * message type, a list of options and a default option.
     *
     * <p> 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 <code>options</code> array,
     * and are displayed by the <code>CallbackHandler</code> implementation
     * in a manner consistent with the way preset options are displayed.
     *
     * <p>
     *
     * @param prompt the prompt used to describe the list of options. <p>
     *
     * @param messageType the message type (<code>INFORMATION</code>,
     *                  <code>WARNING</code> or <code>ERROR</code>). <p>
     *
     * @param options the list of confirmation options. <p>
     *
     * @param defaultOption the default option, represented as an index
     *                  into the <code>options</code> array.
     *
     * @exception IllegalArgumentException if <code>prompt</code> is null,
     *                  if <code>prompt</code> has a length of 0,
     *                  if messageType is not either
     *                  <code>INFORMATION</code>, <code>WARNING</code>,
     *                  or <code>ERROR</code>, if <code>options</code> is null,
     *                  if <code>options</code> has a length of 0,
     *                  if any element from <code>options</code> is null,
     *                  if any element from <code>options</code>
     *                  has a length of 0, or if <code>defaultOption</code>
     *                  does not lie within the array boundaries of
     *                  <code>options</code>.
     */
    public ConfirmationCallback(String prompt, int messageType,
                String[] options, int defaultOption) {

        if (prompt == null || prompt.length() == 0 ||
            messageType < INFORMATION || messageType > ERROR ||
            options == null || options.length == 0 ||
            defaultOption < 0 || defaultOption >= options.length)
            throw new IllegalArgumentException();

        for (int i = 0; i < options.length; i++) {
            if (options[i] == null || options[i].length() == 0)
                throw new IllegalArgumentException();
        }

        this.prompt = prompt;
        this.messageType = messageType;
        this.options = options;
        this.defaultOption = defaultOption;
    }

    Get the prompt.

Returns: the prompt, or null if this ConfirmationCallback
         was instantiated without a prompt./**
     * Get the prompt.
     *
     * <p>
     *
     * @return the prompt, or null if this <code>ConfirmationCallback</code>
     *          was instantiated without a <code>prompt</code>.
     */
    public String getPrompt() {
        return prompt;
    }

    Get the message type.

Returns: the message type (INFORMATION,
         WARNING or ERROR)./**
     * Get the message type.
     *
     * <p>
     *
     * @return the message type (<code>INFORMATION</code>,
     *          <code>WARNING</code> or <code>ERROR</code>).
     */
    public int getMessageType() {
        return messageType;
    }

    Get the option type.
 If this method returns UNSPECIFIED_OPTION, then this
ConfirmationCallback was instantiated with
options instead of an optionType.
In this case, invoke the getOptions method
to determine which confirmation options to display.

Returns: the option type (YES_NO_OPTION,
         YES_NO_CANCEL_OPTION or
         OK_CANCEL_OPTION), or
         UNSPECIFIED_OPTION if this
         ConfirmationCallback was instantiated with
         options instead of an optionType./**
     * Get the option type.
     *
     * <p> If this method returns <code>UNSPECIFIED_OPTION</code>, then this
     * <code>ConfirmationCallback</code> was instantiated with
     * <code>options</code> instead of an <code>optionType</code>.
     * In this case, invoke the <code>getOptions</code> method
     * to determine which confirmation options to display.
     *
     * <p>
     *
     * @return the option type (<code>YES_NO_OPTION</code>,
     *          <code>YES_NO_CANCEL_OPTION</code> or
     *          <code>OK_CANCEL_OPTION</code>), or
     *          <code>UNSPECIFIED_OPTION</code> if this
     *          <code>ConfirmationCallback</code> was instantiated with
     *          <code>options</code> instead of an <code>optionType</code>.
     */
    public int getOptionType() {
        return optionType;
    }

    Get the confirmation options.

Returns: the list of confirmation options, or null if this
         ConfirmationCallback was instantiated with
         an optionType instead of options./**
     * Get the confirmation options.
     *
     * <p>
     *
     * @return the list of confirmation options, or null if this
     *          <code>ConfirmationCallback</code> was instantiated with
     *          an <code>optionType</code> instead of <code>options</code>.
     */
    public String[] getOptions() {
        return options;
    }

    Get the default option.

Returns: the default option, represented as
         YES, NO, OK or
         CANCEL if an optionType
         was specified to the constructor of this
         ConfirmationCallback.
         Otherwise, this method returns the default option as
         an index into the
         options array specified to the constructor
         of this ConfirmationCallback./**
     * Get the default option.
     *
     * <p>
     *
     * @return the default option, represented as
     *          <code>YES</code>, <code>NO</code>, <code>OK</code> or
     *          <code>CANCEL</code> if an <code>optionType</code>
     *          was specified to the constructor of this
     *          <code>ConfirmationCallback</code>.
     *          Otherwise, this method returns the default option as
     *          an index into the
     *          <code>options</code> array specified to the constructor
     *          of this <code>ConfirmationCallback</code>.
     */
    public int getDefaultOption() {
        return defaultOption;
    }

    Set the selected confirmation option.

Params: selection – the selection represented as YES,
         NO, OK or CANCEL
         if an optionType was specified to the constructor
         of this ConfirmationCallback.
         Otherwise, the selection represents the index into the
         options array specified to the constructor
         of this ConfirmationCallback.
See Also: getSelectedIndex/**
     * Set the selected confirmation option.
     *
     * <p>
     *
     * @param selection the selection represented as <code>YES</code>,
     *          <code>NO</code>, <code>OK</code> or <code>CANCEL</code>
     *          if an <code>optionType</code> was specified to the constructor
     *          of this <code>ConfirmationCallback</code>.
     *          Otherwise, the selection represents the index into the
     *          <code>options</code> array specified to the constructor
     *          of this <code>ConfirmationCallback</code>.
     *
     * @see #getSelectedIndex
     */
    public void setSelectedIndex(int selection) {
        this.selection = selection;
    }

    Get the selected confirmation option.

See Also: setSelectedIndex
Returns: the selected confirmation option represented as
         YES, NO, OK or
         CANCEL if an optionType
         was specified to the constructor of this
         ConfirmationCallback.
         Otherwise, this method returns the selected confirmation
         option as an index into the
         options array specified to the constructor
         of this ConfirmationCallback./**
     * Get the selected confirmation option.
     *
     * <p>
     *
     * @return the selected confirmation option represented as
     *          <code>YES</code>, <code>NO</code>, <code>OK</code> or
     *          <code>CANCEL</code> if an <code>optionType</code>
     *          was specified to the constructor of this
     *          <code>ConfirmationCallback</code>.
     *          Otherwise, this method returns the selected confirmation
     *          option as an index into the
     *          <code>options</code> array specified to the constructor
     *          of this <code>ConfirmationCallback</code>.
     *
     * @see #setSelectedIndex
     */
    public int getSelectedIndex() {
        return selection;
    }
}
Params:	messageType – the message type (`INFORMATION`, `WARNING` or `ERROR`). optionType – the option type (`YES_NO_OPTION`, `YES_NO_CANCEL_OPTION` or `OK_CANCEL_OPTION`). defaultOption – the default option from the provided optionType (`YES`, `NO`, `CANCEL` or `OK`).
Throws:	IllegalArgumentException – if messageType is not either `INFORMATION`, `WARNING`, or `ERROR`, if optionType is not either `YES_NO_OPTION`, `YES_NO_CANCEL_OPTION`, or `OK_CANCEL_OPTION`, or if `defaultOption` does not correspond to one of the options in `optionType`.
Params:	prompt – the prompt used to describe the list of options. messageType – the message type (`INFORMATION`, `WARNING` or `ERROR`). optionType – the option type (`YES_NO_OPTION`, `YES_NO_CANCEL_OPTION` or `OK_CANCEL_OPTION`). defaultOption – the default option from the provided optionType (`YES`, `NO`, `CANCEL` or `OK`).
Throws:	IllegalArgumentException – if `prompt` is null, if `prompt` has a length of 0, if messageType is not either `INFORMATION`, `WARNING`, or `ERROR`, if optionType is not either `YES_NO_OPTION`, `YES_NO_CANCEL_OPTION`, or `OK_CANCEL_OPTION`, or if `defaultOption` does not correspond to one of the options in `optionType`.
Params:	selection – the selection represented as `YES`, `NO`, `OK` or `CANCEL` if an `optionType` was specified to the constructor of this `ConfirmationCallback`. Otherwise, the selection represents the index into the `options` array specified to the constructor of this `ConfirmationCallback`.
See Also:	getSelectedIndex
See Also:	setSelectedIndex
Returns:	the selected confirmation option represented as `YES`, `NO`, `OK` or `CANCEL` if an `optionType` was specified to the constructor of this `ConfirmationCallback`. Otherwise, this method returns the selected confirmation option as an index into the `options` array specified to the constructor of this `ConfirmationCallback`.
/

java/ 6/ javax/security/auth/callback/ConfirmationCallback.java
