Интерфейс HttpClient.Builder

static final ProxySelector NO_PROXY

HttpClient.Builder cookieHandler(CookieHandler cookieHandler)

Параметры:

cookieHandler — обработчик файлов cookie

Возвращает:

этот построитель

HttpClient.Builder connectTimeout(Duration duration)

Параметры:

duration — время, отведенное на установление базового подключения

Возвращает:

этот построитель

Вызывает исключение:

IllegalArgumentException — если значение времени ожидания неположительное

HttpClient.Builder sslContext(SSLContext sslContext)

Параметры:

sslContext — SSLContext

Возвращает:

этот построитель

HttpClient.Builder sslParameters(SSLParameters sslParameters)

Параметры:

sslParameters — SSLParameters

Возвращает:

этот построитель

HttpClient.Builder executor(Executor executor)

Примечание по реализации:

Исполнитель по умолчанию использует пул потоков с пользовательской фабрикой потоков.

Параметры:

executor — Executor

Возвращает:

этот построитель

HttpClient.Builder followRedirects(HttpClient.Redirect policy)

Параметры:

policy — политика перенаправления

Возвращает:

этот построитель

HttpClient.Builder version(HttpClient.Version version)

Примечание по реализации:

На выбор версии протокола могут влиять и другие ограничения. Например, если через прокси запрашивается HTTP/2, а реализация не поддерживает такой режим, может использоваться HTTP/1.1.

Параметры:

version — запрошенная версия протокола HTTP

Возвращает:

этот построитель

HttpClient.Builder priority(int priority)

Параметры:

priority — вес приоритета

Возвращает:

этот построитель

Вызывает исключение:

IllegalArgumentException — если указанный приоритет выходит за пределы диапазона

HttpClient.Builder proxy(ProxySelector proxySelector)

Примечание API:

ProxySelector::of предоставляет ProxySelector, который использует один прокси для всех запросов. Системный селектор прокси можно получить с помощью ProxySelector.getDefault().

Примечание по реализации:

Если этот метод не вызывается до создания, вновь создаваемые клиенты будут использовать селектор прокси по умолчанию, который обычно подходит для клиентских приложений. Селектор прокси по умолчанию поддерживает набор системных свойств, связанных с настройками прокси. Это поведение по умолчанию можно отключить, передав явный селектор прокси, например NO_PROXY или селектор, возвращаемый ProxySelector::of, до вызова создания.

Параметры:

proxySelector — ProxySelector

Возвращает:

этот построитель

HttpClient.Builder authenticator(Authenticator authenticator)

Примечание по реализации:

Во встроенной реализации HttpClient в JDK, если для HttpRequest задан заголовок Authorization или Proxy-Authorization, используется его значение, а Authenticator для соответствующей аутентификации не вызывается. В этом случае ошибки аутентификации возвращаются пользователю, а запросы не повторяются автоматически. Кроме того, встроенная реализация JDK в настоящее время поддерживает только HTTP-аутентификацию Basic.

Параметры:

authenticator — Authenticator

Возвращает:

этот построитель

default HttpClient.Builder localAddress(InetAddress localAddr)

Требования к реализации:

Реализация этого метода по умолчанию вызывает UnsupportedOperationException. Builder, полученные с помощью HttpClient.newBuilder(), предоставляют реализацию этого метода, позволяющую задать локальный адрес.

Параметры:

localAddr — локальный адрес сокета. Может быть равен null.

Возвращает:

этот построитель

Вызывает исключение:

UnsupportedOperationException — если этот построитель не поддерживает настройку локального адреса или если переданный localAddr не поддерживается этой реализацией HttpClient.

Начиная с:

19

HttpClient build()

Возвращает:

новый HttpClient

Вызывает исключение:

UncheckedIOException — может быть вызвано, если не удается выделить ресурсы ввода-вывода, необходимые реализации. Например, если реализации требуется Selector, а его открытие завершается ошибкой из-за недостатка необходимых ресурсов.