Класс 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)`	Вызывается для указания невозможности установить соединение с прокси/соксовой сервером.
`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()

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

Возвращает:

прокси-селектор системы.

Исключения:

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

С момента:

1.5

См. также:

setDefault

public static void setDefault(ProxySelector ps)

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

Параметры:

ps - Прокси-селектор HTTP или null для сброса прокси-селектора.

Исключения:

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

С момента:

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

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

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