Пакет java.net.http
API HTTP-клиента и WebSocket
Предоставляет интерфейсы высокого уровня для HTTP (версий 1.1 и 2) и низкого уровня для WebSocket. Основные определенные типы:
Требования, специфичные для протокола, определены в Hypertext Transfer Protocol версии 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, 2023, 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/21/docs/api/java.net.http/java/net/http/package-summary.html
