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

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