Пакет 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 методами всех классов в этом пакете.
- Since:
- 11
| Класс | Описание |
|---|---|
| HttpClient | HTTP-клиент. |
| HttpClient.Builder | Построитель HTTP-клиентов. |
| HttpClient.Redirect | Определяет политику автоматического перенаправления. |
| HttpClient.Version | Версия HTTP-протокола. |
| HttpConnectTimeoutException | Выбрасывается, когда соединение, по которому предполагается отправка HttpRequest, не устанавливается в течение заданного периода времени. |
| HttpHeaders | Только для чтения представление набора HTTP-заголовков. |
| HttpRequest | HTTP-запрос. |
| HttpRequest.BodyPublisher | BodyPublisher преобразует высокоуровневые объекты Java в поток байтовых буферов, подходящих для отправки в качестве тела запроса. |
| HttpRequest.BodyPublishers | Реализации BodyPublisher, реализующие различные полезные издатели, такие как публикацию тела запроса из строки или файла. |
| HttpRequest.Builder | Построитель HTTP-запросов. |
| HttpResponse<T> | HTTP-ответ. |
| HttpResponse.BodyHandler<T> | Обработчик тел ответов. |
| HttpResponse.BodyHandlers | Реализации BodyHandler, реализующие различные полезные обработчики, такие как обработка тела ответа как строки или потоковая передача тела ответа в файл. |
| HttpResponse.BodySubscriber<T> | BodySubscriber потребляет байты тела ответа и преобразует их в высокоуровневый тип Java. |
| HttpResponse.BodySubscribers | Реализации BodySubscriber, реализующие различные полезные подписчики, такие как преобразование байтов тела ответа в строку или потоковая передача байтов в файл. |
| HttpResponse.PushPromiseHandler<T> | Обработчик push-обещаний. |
| HttpResponse.ResponseInfo | Первоначальная информация о ответе, предоставляемая BodyHandler при первоначальном получении ответа и до обработки тела. |
| HttpTimeoutException | Выбрасывается, если ответ не получен в течение заданного периода времени. |
| WebSocket | Клиент WebSocket. |
| WebSocket.Builder | Построитель WebSocket-клиентов. |
| WebSocket.Listener | Интерфейс получения WebSocket. |
| WebSocketHandshakeException | Выбрасывается, если открытие рукопожатия завершилось неудачно. |
© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.net.http/java/net/http/package-summary.html
