Пакет java.net.http

API для HTTP-клиентов и WebSocket

Предоставляет высокоуровневые клиентские интерфейсы для HTTP (версий 1.1 и 2) и низкоуровневые клиентские интерфейсы для WebSocket. Основные определенные типы:

Специфические требования протокола определены в Hypertext Transfer Protocol Version 2 (HTTP/2), Hypertext Transfer Protocol (HTTP/1.1) и протоколе WebSocket.

В общем случае асинхронные задачи выполняются либо в потоке, вызвавшем операцию, например, при отправке HTTP-запроса, либо в потоках, предоставленных исполнителем клиента через executor. Зависимые задачи, которые запускаются возвращаемыми CompletionStages или CompletableFutures, которые явно не указывают исполнителя, выполняются в том же default executor, что и CompletableFuture, или в вызвавшем потоке, если операция завершается до регистрации зависимой задачи.

CompletableFuture возвращаемые этим API, будут выбрасывать UnsupportedOperationException для своих методов obtrudeValue и obtrudeException. Вызов метода cancel для CompletableFuture возвращаемых этим API, может не прервать основную операцию, но может быть полезен для завершения, с исключением, зависимых этапов, которые еще не завершились.

Если не указано иное, значения параметров null приведут к тому, что методы всех классов в этом пакете будут выбрасывать NullPointerException.

С:: 11

Интерфейс	Описание
HttpClient.Builder	Построитель HTTP-клиентов.
HttpRequest.BodyPublisher	`BodyPublisher` преобразует высокоуровневые Java-объекты в поток байтовых буферов, подходящих для отправки в качестве тела запроса.
HttpRequest.Builder	Построитель HTTP-запросов.
HttpResponse<T>	HTTP-ответ.
HttpResponse.BodyHandler<T>	Обработчик тел ответов.
HttpResponse.BodySubscriber<T>	`BodySubscriber` потребляет байты тела ответа и преобразует их в высокоуровневый Java-тип.
HttpResponse.PushPromiseHandler<T>	Обработчик push-обещаний.
HttpResponse.ResponseInfo	Первоначальная информация об ответе, предоставляемая `BodyHandler`, когда ответ первоначально получен и до обработки тела.
WebSocket	WebSocket-клиент.
WebSocket.Builder	Построитель WebSocket-клиентов.
WebSocket.Listener	Интерфейс приема `WebSocket`.

Класс	Описание
HttpClient	HTTP-клиент.
HttpHeaders	Только для чтения представление набора HTTP-заголовков.
HttpRequest	HTTP-запрос.
HttpRequest.BodyPublishers	Реализации `BodyPublisher`, которые реализуют различные полезные издатели, такие как публикацию тела запроса из строки или файла.
HttpResponse.BodyHandlers	Реализации `BodyHandler`, которые реализуют различные полезные обработчики, такие как обработка тела ответа как строки или потоковая передача тела ответа в файл.
HttpResponse.BodySubscribers	Реализации `BodySubscriber`, которые реализуют различные полезные подписчики, такие как преобразование байтов тела ответа в строку или потоковая передача байтов в файл.

Перечисление	Описание
HttpClient.Redirect	Определяет политику автоматического перенаправления.
HttpClient.Version	Версия HTTP-протокола.

Исключение	Описание
HttpConnectTimeoutException	Выбрасывается, когда соединение, по которому предполагается отправка `HttpRequest`, не установлено в течение заданного периода времени.
HttpTimeoutException	Выбрасывается, когда ответ не получен в течение заданного периода времени.
WebSocketHandshakeException	Выбрасывается, когда начальная рукопожатие не удалась.