Пакет java.net.http
API HTTP-клиента и WebSocket
Предоставляет высокоуровневые клиентские интерфейсы для HTTP (версий 1.1 и 2) и низкоуровневые клиентские интерфейсы для WebSocket. Основные определённые типы:
Требования к конкретным протоколам определены в документах Протокол передачи гипертекста версии 2 (HTTP/2), Протокол передачи гипертекста (HTTP/1.1) и Протокол WebSocket.
Как правило, асинхронные задачи выполняются либо в потоке, вызывающем операцию, например отправку HTTP-запроса, либо в потоках, предоставленных executor клиента. Зависимые задачи, запускаемые возвращёнными объектами CompletionStage или CompletableFuture, которые явно не задают исполнитель, выполняются в том же default executor, что и
CompletableFuture, либо в вызывающем потоке, если операция завершается до регистрации зависимой задачи.
Объекты CompletableFuture, возвращаемые этим API, выбрасывают UnsupportedOperationException при вызове методов obtrudeValue и obtrudeException. Если не указано иное, вызов метода cancel для объекта CompletableFuture, возвращённого этим API, может не прервать базовую операцию, но может быть полезен для завершения с исключением зависимых этапов, которые ещё не завершились.
Если не указано иное, значения параметров null приведут к тому, что методы всех классов этого пакета выбросят NullPointerException.
- Начиная с:
- 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://docs.oracle.com/en/java/javase/25/docs/api/java.net.http/java/net/http/package-summary.html
