Интерфейс HttpOption<T>

Параметры типа:: T — тип значения параметра

public sealed interface HttpOption<T>

Этот интерфейс используется для предоставления дополнительных подсказок о параметрах конфигурации запроса, определяющих, как реализация HttpClient должна выполнять обмен запросом и ответом HTTP. Подсказки о параметрах конфигурации запроса можно передать объекту HttpRequest с помощью метода

HttpRequest.Builder
setOption

Конкретные экземпляры этого класса и его подклассов неизменяемы.

Примечание API:: В этой версии интерфейс HttpOption является запечатанным и допускает только параметр H3_DISCOVERY. Однако в будущем он может быть расширен для поддержки дополнительных параметров.
Параметр H3_DISCOVERY можно использовать, чтобы помочь HttpClient решить, как выбрать или установить соединение HTTP/3 для выполнения обмена запросом и ответом HTTP/3.
Начиная с версии:: 26

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static enum`	`HttpOption.Http3DiscoveryMode`	Это перечисление можно использовать, чтобы помочь `HttpClient` решить, как установить обмен HTTP/3. Его можно передать в качестве значения параметра `H3_DISCOVERY` методу `Builder.setOption`.

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final HttpOption<HttpOption.Http3DiscoveryMode>`	`H3_DISCOVERY`	Параметр, с помощью которого можно настроить способ, которым `HttpClient` будет выбирать или устанавливать соединение HTTP/3 для выполнения запроса.

Краткое описание методов

Модификатор и тип	Метод	Описание
`String`	`name()`	Возвращает имя параметра.
`Class<T>`	`type()`	Возвращает тип значения, связанного с параметром.

Подробное описание полей

H3_DISCOVERY

static final HttpOption<HttpOption.Http3DiscoveryMode> H3_DISCOVERY

Параметр, с помощью которого можно настроить способ, которым HttpClient будет выбирать или устанавливать соединение HTTP/3 для выполнения запроса. Если HttpClient.Version.HTTP_3 не выбрана в качестве предпочтительной версии для запроса или предпочтительной версии HttpClient, установка этого параметра для запроса не имеет эффекта.

Имя этого параметра — "H3_DISCOVERY".

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

Встроенная реализация JDK HttpClient поддерживает подсказку параметра запроса H3_DISCOVERY.
Если подсказка H3_DISCOVERY не задана, а версия HTTP/3 выбрана в качестве предпочтительной версии запроса или предпочтительной версии клиента, встроенная реализация JDK установит обмен в соответствии с HttpOption.Http3DiscoveryMode.ANY.

В случае перенаправления параметр H3_DISCOVERY, если он задан, всегда переносится в новый запрос.

В этой реализации HTTP/3 через прокси-серверы не поддерживается. Если не указан параметр HttpOption.Http3DiscoveryMode.HTTP_3_URI_ONLY, а для URI запроса выбран прокси-сервер с помощью метода выбора, версия протокола понижается до HTTP/2 или HTTP/1.1, а параметр H3_DISCOVERY игнорируется. Если же указан параметр HttpOption.Http3DiscoveryMode.HTTP_3_URI_ONLY, запрос завершится с ошибкой.

См. также:

Подробное описание методов

name

String name()

Возвращает имя параметра.

Требования к реализации:: Разные параметры должны иметь разные имена.
Возвращает:: имя параметра

type

Class<T> type()

Возвращает тип значения, связанного с параметром.

Примечание API:: Разные параметры могут иметь одинаковый тип.
Возвращает:: тип значения, связанного с параметром

© 1993, 2025, 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.