Класс 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

Исключения:

SecurityException - Если установлен менеджер безопасности и он запрещает NetPermission("getProxySelector")

Since:

1.5

См. также:

setDefault(ProxySelector)

setDefault

public static void setDefault(ProxySelector ps)

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

Параметры:

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

Исключения:

SecurityException - Если установлен менеджер безопасности и он запрещает NetPermission("setProxySelector")

Since:

1.5

См. также:

getDefault()

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. Если прокси null то проксирование отключено.

Параметры:: proxyAddress - Адрес прокси
Возвращает:: ProxySelector
Since:: 9

© 1993, 2021, 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/17/docs/api/java.base/java/net/ProxySelector.html