Пакет 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 | Выбрасывается, когда запрос на установление соединения (handshake) не удался. |
© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.net.http/java/net/http/package-summary.html
