Класс ConfirmationCallback
- java.lang.Object
-
- javax.security.auth.callback.ConfirmationCallback
- Все реализованные интерфейсы:
-
Serializable,Callback
public class ConfirmationCallback extends Object implements Callback, Serializable
Базовые службы безопасности создают и передают ConfirmationCallback методу handle объекта CallbackHandler, чтобы запросить подтверждение ДА/НЕТ, ОК/ОТМЕНА, ДА/НЕТ/ОТМЕНА или другие подобные подтверждения.
- С:
- 1.4
- См. также:
-
CallbackHandler, Сериализованная форма
Поля
| Модификатор и тип | Поле | Описание |
|---|---|---|
static int | CANCEL | Вариант ОТМЕНА. |
static int | ERROR | Тип сообщения об ОШИБКЕ. |
static int | INFORMATION | Тип сообщения ИНФОРМАЦИЯ. |
static int | NO | Вариант НЕТ. |
static int | OK | Вариант ОК. |
static int | OK_CANCEL_OPTION | Вариант подтверждения ОК/ОТМЕНА. |
static int | UNSPECIFIED_OPTION | Тип варианта без указания. |
static int | WARNING | Тип сообщения ПРЕДУПРЕЖДЕНИЕ. |
static int | YES | Вариант ДА. |
static int | YES_NO_CANCEL_OPTION | Вариант подтверждения ДА/НЕТ/ОТМЕНА. |
static int | YES_NO_OPTION | Вариант подтверждения ДА/НЕТ. |
Конструкторы
| Конструктор | Описание |
|---|---|
ConfirmationCallback(int messageType,
int optionType,
int defaultOption) | Создаёт |
ConfirmationCallback(int messageType,
String[] options,
int defaultOption) | Создаёт |
ConfirmationCallback(String prompt,
int messageType,
int optionType,
int defaultOption) | Создаёт |
ConfirmationCallback(String prompt,
int messageType,
String[] options,
int defaultOption) | Создаёт |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
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 был создан с options вместо optionType.
- См. также:
- Значения константных полей
YES_NO_OPTION
public static final int YES_NO_OPTION
Параметр подтверждения ДА/НЕТ.
Подлежащая служба безопасности указывает это как optionType для конструктора ConfirmationCallback, если требуется подтверждение, которое может быть отвечено YES или NO.
- См. также:
- Значения константных полей
YES_NO_CANCEL_OPTION
public static final int YES_NO_CANCEL_OPTION
Параметр подтверждения ДА/НЕТ/ОТМЕНА.
Подлежащая служба безопасности указывает это как optionType для конструктора ConfirmationCallback, если требуется подтверждение, которое может быть отвечено YES, NO или CANCEL.
- См. также:
- Значения константных полей
OK_CANCEL_OPTION
public static final int OK_CANCEL_OPTION
Параметр подтверждения OK/ОТМЕНА.
Подлежащая служба безопасности указывает это как optionType для конструктора ConfirmationCallback, если требуется подтверждение, которое может быть отвечено OK или CANCEL.
- См. также:
- Значения константных полей
YES
public static final int YES
Параметр ДА.
Если для этого ConfirmationCallback был задан параметр optionType, этот параметр может быть задан как defaultOption или возвращён как выбранный индекс.
- См. также:
- Значения константных полей
NO
public static final int NO
Параметр НЕТ.
Если для этого ConfirmationCallback был задан параметр optionType, этот параметр может быть задан как defaultOption или возвращён как выбранный индекс.
- См. также:
- Значения константных полей
CANCEL
public static final int CANCEL
Параметр ОТМЕНА.
Если для этого ConfirmationCallback был задан параметр optionType, этот параметр может быть задан как defaultOption или возвращён как выбранный индекс.
- См. также:
- Значения константных полей
OK
public static final int OK
Параметр OK.
Если для этого ConfirmationCallback был задан параметр optionType, этот параметр может быть задан как defaultOption или возвращён как выбранный индекс.
- См. также:
- Значения константных полей
ИНФОРМАЦИЯ
public static final int INFORMATION
Тип сообщения ИНФОРМАЦИЯ.
- См. также:
- Значения константных полей
ПРЕДУПРЕЖДЕНИЕ
public static final int WARNING
Тип сообщения ПРЕДУПРЕЖДЕНИЕ.
- См. также:
- Значения константных полей
ОШИБКА
public static final int ERROR
Тип сообщения ОШИБКА.
- См. также:
- Значения константных полей
Конструкторы
ConfirmationCallback
public ConfirmationCallback(int messageType,
int optionType,
int defaultOption) Создаёт ConfirmationCallback с типом сообщения, типом параметра и параметром по умолчанию.
Подлежащие службы безопасности используют этот конструктор, если им требуется подтверждение ДА/НЕТ, ДА/НЕТ/ОТМЕНА или OK/ОТМЕНА.
- Параметры:
-
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 с типом сообщения, списком параметров и параметром по умолчанию.
Подлежащие службы безопасности используют этот конструктор, если им требуется подтверждение, отличное от имеющихся предопределённых подтверждений (например, ПРОДОЛЖИТЬ/ПРЕКРАТИТЬ или СТОП/ВПЕРЁД). Параметры подтверждения перечислены в массиве 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 с приглашением, типом сообщения, типом параметра и параметром по умолчанию.
Подлежащие службы безопасности используют этот конструктор, если им требуется подтверждение ДА/НЕТ, ДА/НЕТ/ОТМЕНА или OK/ОТМЕНА.
- Параметры:
-
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 с приглашением, типом сообщения, списком параметров и параметром по умолчанию.
Подлежащие службы безопасности используют этот конструктор, если им требуется подтверждение, отличное от имеющихся предопределённых подтверждений (например, ПРОДОЛЖИТЬ/ПРЕКРАТИТЬ или СТОП/ВПЕРЁД). Параметры подтверждения перечислены в массиве 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()
Получить запрос.
- Возвращает:
- запрос или null, если этот
ConfirmationCallbackбыл создан безprompt.
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), илиUNSPECIFIED_OPTION, если этотConfirmationCallbackбыл создан сoptionsвместоoptionType.
getOptions
public String[] getOptions()
Получить опции подтверждения.
- Возвращает:
- список опций подтверждения или null, если этот
ConfirmationCallbackбыл создан сoptionTypeвместоoptions.
getDefaultOption
public int getDefaultOption()
Получить опцию по умолчанию.
- Возвращает:
- опцию по умолчанию, представленную как
YES,NO,OKилиCANCEL, если в конструктор этогоConfirmationCallbackбыла передана опция. В противном случае, этот метод возвращает опцию по умолчанию как индекс в массивеoptions, указанном в конструкторе этогоConfirmationCallback.
setSelectedIndex
public void setSelectedIndex(int selection)
Установить выбранную опцию подтверждения.
- Параметры:
-
selection- выбор, представленный какYES,NO,OKилиCANCEL, если в конструктор этогоConfirmationCallbackбыла передана опция. В противном случае, выбор представляет индекс в массивеoptions, указанном в конструкторе этогоConfirmationCallback. - См. также:
getSelectedIndex()
getSelectedIndex
public int getSelectedIndex()
Получить выбранную опцию подтверждения.
- Возвращает:
- выбранную опцию подтверждения, представленную как
YES,NO,OKилиCANCEL, если в конструктор этогоConfirmationCallbackбыла передана опция. В противном случае, этот метод возвращает выбранную опцию подтверждения как индекс в массивеoptions, указанном в конструкторе этогоConfirmationCallback. - См. также:
setSelectedIndex(int)
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.base/javax/security/auth/callback/ConfirmationCallback.html