Интерфейс 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 не вызывается для соответствующей аутентификации. В этом случае любые ошибки аутентификации возвращаются пользователю, и запросы не пересылаются автоматически.

Параметры:

authenticator - Authenticator

Возвращает:

этот билдер

default HttpClient.Builder localAddress(InetAddress localAddr)

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

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

Параметры:

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

Возвращает:

этот билдер

Исключения:

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

С:

19

HttpClient build()

Возвращает:

новый HttpClient

Издаёт исключение:

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