Класс Authenticator

public abstract class Authenticator
extends Object

Класс Authenticator представляет собой объект, знающий, как получить аутентификацию для сетевого подключения. Обычно он делает это, запрашивая информацию у пользователя.

Приложения используют этот класс, переопределяя getPasswordAuthentication() в подклассе. Этот метод обычно использует различные методы-аксессоры getXXX() для получения информации об объекте, запрашивающем аутентификацию. Затем он должен получить имя пользователя и пароль, либо взаимодействуя с пользователем, либо каким-то другим неинтерактивным способом. Кредиты возвращаются в качестве значения PasswordAuthentication.

Затем экземпляр этого конкретного подкласса регистрируется в системе, вызывая setDefault(Authenticator). Когда требуется аутентификация, система вызовет один из методов requestPasswordAuthentication(), которые в свою очередь вызовут метод getPasswordAuthentication() зарегистрированного объекта.

Все методы, запрашивающие аутентификацию, имеют реализацию по умолчанию, которая завершается ошибкой.

Конструкторы

Authenticator

public Authenticator()

Методы

setDefault

public static void setDefault(Authenticator a)

Параметры:

a - Аутентификатор, который нужно установить. Если аутентификатор null, то любой ранее установленный аутентификатор удаляется.

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkPermission не позволяет установить аутентификатор по умолчанию.

См. также:

SecurityManager.checkPermission(java.security.Permission), NetPermission

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(InetAddress addr,
                                                                   int port,
                                                                   String protocol,
                                                                   String prompt,
                                                                   String scheme)

Параметры:

addr - InetAddress сайта, запрашивающего авторизацию, или null, если неизвестен.

port - порт запрошенного соединения

protocol - Протокол, запрашивающий соединение (getRequestingProtocol())

prompt - Строка запроса для пользователя

scheme - Схема аутентификации

Возвращает:

Имя пользователя/пароль или null, если их получить нельзя.

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkPermission не позволяет запросить аутентификацию по паролю.

См. также:

SecurityManager.checkPermission(java.security.Permission), NetPermission

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(String host,
                                                                   InetAddress addr,
                                                                   int port,
                                                                   String protocol,
                                                                   String prompt,
                                                                   String scheme)

Параметры:

host - Имя хоста сайта, запрашивающего аутентификацию.

addr - InetAddress сайта, запрашивающего аутентификацию, или null, если неизвестен.

port - порт запрошенного соединения.

protocol - Протокол, запрашивающий соединение (getRequestingProtocol())

prompt - Строка запроса для пользователя, идентифицирующая область аутентификации.

scheme - Схема аутентификации

Возвращает:

Имя пользователя/пароль или null, если их получить нельзя.

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkPermission не позволяет запросить аутентификацию по паролю.

С:

1.4

См. также:

SecurityManager.checkPermission(java.security.Permission), NetPermission

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(String host,
                                                                   InetAddress addr,
                                                                   int port,
                                                                   String protocol,
                                                                   String prompt,
                                                                   String scheme,
                                                                   URL url,
                                                                   Authenticator.RequestorType reqType)

Параметры:

host - Имя хоста сайта, запрашивающего аутентификацию.

addr - InetAddress сайта, запрашивающего авторизацию, или null, если неизвестен.

port - порт запрошенного соединения

protocol - Протокол, запрашивающий соединение (getRequestingProtocol())

prompt - Строка запроса для пользователя

scheme - Схема аутентификации

url - Запрашиваемый URL, вызвавший аутентификацию

reqType - Тип сущности (сервер или прокси), запрашивающей аутентификацию.

Возвращает:

Имя пользователя/пароль или null, если их получить нельзя.

Исключения:

SecurityException - если менеджер безопасности существует и его метод checkPermission не позволяет запросить аутентификацию по паролю.

С:

1.5

См. также:

SecurityManager.checkPermission(java.security.Permission), NetPermission

getRequestingHost

protected final String getRequestingHost()

Получает имя хоста сайта или прокси, запрашивающего аутентификацию, или null, если оно недоступно.

Возвращает:

имя хоста соединения, требующего аутентификации, или null, если оно недоступно.

С:

1.4

getRequestingSite

protected final InetAddress getRequestingSite()

Получает InetAddress сайта, запрашивающего авторизацию, или null, если он недоступен.

Возвращает:

InetAddress сайта, запрашивающего авторизацию, или null, если он недоступен.

getRequestingPort

protected final int getRequestingPort()

Получает номер порта запрошенного соединения.

Возвращает:

целое число, обозначающее порт запрошенного соединения.

getRequestingProtocol

protected final String getRequestingProtocol()

Возвращает протокол, запрашивающий соединение. Часто это основано на URL, но в будущей версии JDK это может быть, например, "SOCKS" для защищенного паролем брандмауэра SOCKS5.

Возвращает:

протокол, за которым необязательно следует "/версия", где версия — номер версии.

См. также:

URL.getProtocol()

getRequestingPrompt

protected final String getRequestingPrompt()

Получает строку запроса, предоставленную запрашивающим элементом.

Возвращает:

строка запроса, предоставленная запрашивающим элементом (область для http-запросов)

getRequestingScheme

protected final String getRequestingScheme()

Получает схему запрашивающего элемента (например, схему HTTP для HTTP-брандмауэра).

Возвращает:

схема запрашивающего элемента

getPasswordAuthentication

protected PasswordAuthentication getPasswordAuthentication()

Вызывается, когда требуется аутентификация по паролю. Подклассы должны переопределять стандартную реализацию, которая возвращает null.

Возвращает:

PasswordAuthentication, полученный от пользователя, или null, если он не предоставлен.

getRequestingURL

protected URL getRequestingURL()

Возвращает URL, который привёл к этому запросу аутентификации.

Возвращает:

запрашиваемый URL

С:

1.5

getRequestorType

protected Authenticator.RequestorType getRequestorType()

Возвращает, является ли запрашивающий элемент прокси-сервером или сервером.

Возвращает:

тип аутентификации запрашивающего элемента

С:

1.5