Класс Authenticator
java.lang.Object
com.sun.net.httpserver.Authenticator
- Прямые известные подклассы:
BasicAuthenticator
public abstract class Authenticator extends Object
Authenticator представляет реализацию механизма аутентификации HTTP. Подклассы предоставляют реализации конкретных механизмов, таких как Digest или Basic аутентификация. Экземпляры вызываются для проверки информации об аутентификации, предоставленной во всех входящих запросах. Примечание. Это подразумевает, что кэширование учетных данных или другой информации об аутентификации должно выполняться вне этого класса.
- С тех пор:
- 1.6
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
static class |
Authenticator.Failure |
Указывает на сбой аутентификации. |
static class |
Authenticator.Result |
Базовый класс для типа возвращаемого значения метода authenticate(HttpExchange). |
static class |
Authenticator.Retry |
Указывает, что аутентификация должна быть повторёна. |
static class |
Authenticator.Success |
Указывает, что аутентификация прошла успешно, и аутентифицированный пользователь принципал может быть получен путём вызова Authenticator.Success.getPrincipal(). |
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
abstract Authenticator.Result |
authenticate |
Вызывается для аутентификации каждого входящего запроса. |
Подробное описание конструкторов
Authenticator
protected Authenticator()
Конструктор для вызова подклассами.
Подробное описание методов
authenticate
public abstract Authenticator.Result authenticate(HttpExchange exch)
Вызывается для аутентификации каждого входящего запроса. Реализация должна вернуть объект
Authenticator.Failure, Authenticator.Success или Authenticator.Retry, в зависимости от ситуации: -
Failureозначает, что аутентификация завершена, но завершилась неудачей из-за неверных учетных данных. -
Successозначает, что аутентификация прошла успешно, и объектPrincipal, представляющий пользователя, может быть получен вызовомAuthenticator.Success.getPrincipal(). -
Retryозначает, что требуется другой HTTP обмен. Все заголовки ответа, которые необходимо отправить клиенту, устанавливаются в данномHttpExchange. Код ответа, который необходимо вернуть, должен быть указан в объектеRetry.Retryможет происходить несколько раз.
- Параметры:
-
exch- объект обмена, на котором вызывается authenticate - Возвращает:
- результат
© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/jdk.httpserver/com/sun/net/httpserver/Authenticator.html