Класс ProxySelector

java.lang.Object

java.net.ProxySelector

public abstract class ProxySelector extends Object

Выбирает прокси-сервер, если он есть, для подключения к сетевому ресурсу, на который указывает URL. Селектор прокси — это конкретный подкласс данного класса, который регистрируется вызовом метода setDefault. Зарегистрированный в данный момент селектор прокси можно получить вызовом метода getDefault.

Если селектор прокси зарегистрирован, например подкласс класса URLConnection должен вызывать метод select для каждого запроса URL, чтобы селектор прокси мог решить, следует ли использовать прямое подключение или подключение через прокси. Метод select возвращает итератор по коллекции с предпочтительными способами подключения.

Если не удается установить подключение к прокси-серверу (PROXY или SOCKS), вызывающий код должен вызвать метод селектора прокси connectFailed, чтобы уведомить селектор прокси о недоступности прокси-сервера.

Селектор прокси по умолчанию применяет набор системных свойств, связанных с настройками прокси.

Начиная с версии:: 1.5

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

Конструктор	Описание
`ProxySelector()`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`abstract void`	`connectFailed(URI uri, SocketAddress sa, IOException ioe)`	Вызывается для указания того, что не удалось установить подключение к прокси-/SOCKS-серверу.
`static ProxySelector`	`getDefault()`	Возвращает системный селектор прокси.
`static ProxySelector`	`of(InetSocketAddress proxyAddress)`	Возвращает селектор прокси, использующий указанный адрес прокси для всех HTTP- и HTTPS-запросов.
`abstract List<Proxy>`	`select(URI uri)`	Выбирает все подходящие прокси на основе протокола доступа к ресурсу и адреса назначения, по которому доступен ресурс.
`static void`	`setDefault(ProxySelector ps)`	Устанавливает (или сбрасывает) системный селектор прокси.

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

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

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

ProxySelector

public ProxySelector()

Конструктор для вызова подклассами.

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

getDefault

public static ProxySelector getDefault()

Возвращает системный селектор прокси.

Возвращает:

системный ProxySelector

Начиная с версии:

1.5

См. также:

setDefault

public static void setDefault(ProxySelector ps)

Устанавливает (или сбрасывает) системный селектор прокси. Примечание: обработчики нестандартных протоколов могут игнорировать эту настройку.

Параметры:

ps — селектор HTTP-прокси или null, чтобы сбросить селектор прокси.

Начиная с версии:

1.5

См. также:

select

public abstract List<Proxy> select(URI uri)

Выбирает все подходящие прокси на основе протокола доступа к ресурсу и адреса назначения, по которому доступен ресурс. Формат URI определяется следующим образом:

URI http для подключений http
URI https для подключений https
socket://host:port
для подключений клиентских сокетов tcp

Параметры:: uri — URI, к которому требуется подключение
Возвращает:: список прокси. Каждый элемент списка имеет тип Proxy; если прокси недоступен, список будет содержать один элемент типа Proxy, представляющий прямое подключение.
Вызывает исключение:: IllegalArgumentException — если аргумент равен null или если по предоставленному uri невозможно определить протокол или хост

connectFailed

public abstract void connectFailed(URI uri, SocketAddress sa, IOException ioe)

Вызывается для указания того, что не удалось установить подключение к прокси-/SOCKS-серверу. Реализация этого метода может временно удалить прокси или изменить порядок прокси, возвращаемых методом select(URI), используя адрес и IOException, перехваченное при попытке подключения.

Параметры:: uri — URI, запрос к которому не смог обслужить прокси по адресу sa.; sa — адрес сокета прокси-/SOCKS-сервера; ioe — исключение ввода-вывода, возникшее при сбое подключения.
Вызывает исключение:: IllegalArgumentException — если любой из аргументов равен null

of

public static ProxySelector of(InetSocketAddress proxyAddress)

Возвращает селектор прокси, использующий указанный адрес прокси для всех HTTP- и HTTPS-запросов. Если proxyAddress равен null, использование прокси отключается.

Параметры:: proxyAddress — адрес прокси
Возвращает:: селектор прокси
Начиная с версии:: 9

© 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/java.base/java/net/ProxySelector.html