confirmationcallback.java

Mobile 应用程序使用 Java Micro Edition (Java ME) 平台

    }

    /**
     * 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 <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.
     *
     * <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.
     *
     * <p>
     *
     * @return the message type (<code>INFORMATION</code>,
     *		<code>WARNING</code> or <code>ERROR</code>).
     */
    public int getMessageType() {
	return messageType;
    }

    /**
     * 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.
     *
     * <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.
     *
     * <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.
     *
     * <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.
     *
     * <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;
    }
}