Класс ProxySelector

java.lang.Object

java.net.ProxySelector

public abstract class ProxySelector extends Object

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

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

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

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

Since:: 1.5

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

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

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

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

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

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

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

ProxySelector

public ProxySelector()

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

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

getDefault

public static ProxySelector getDefault()

Получает прокси-селектор системы.

Возвращает:

системный ProxySelector

Since:

1.5

См. также:

setDefault

public static void setDefault(ProxySelector ps)

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

Параметры:

ps - Прокси-селектор HTTP, или null для отмены установки прокси-селектора.

Since:

1.5

См. также:

select

public abstract List<Proxy> select(URI uri)

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

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

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

connectFailed

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

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

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

of

public static ProxySelector of(InetSocketAddress proxyAddress)

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

Параметры:: proxyAddress - адрес прокси
Возвращает:: ProxySelector
Since:: 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://download.java.net/java/early_access/jdk24/docs/api/java.base/java/net/ProxySelector.html