Класс 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`	Указывает, что аутентификация прошла успешно и аутентифицированного пользователя principal можно получить, вызвав `Authenticator.Success.getPrincipal()`.

Краткое описание конструкторов

Authenticator()

Модификатор	Конструктор	Описание
`protected`	Конструктор, предназначенный для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`abstract Authenticator.Result`	`authenticate(HttpExchange exch)`	Вызывается для аутентификации каждого входящего запроса.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Подробное описание конструкторов

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 — объект HttpExchange, для которого вызывается 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://docs.oracle.com/en/java/javase/25/docs/api/jdk.httpserver/com/sun/net/httpserver/Authenticator.html