Интерфейс HttpResponse<T>

Параметры типа:: T - тип тела ответа

public interface HttpResponse<T>

Ответ HTTP.

Объект HttpResponse не создаётся напрямую, а возвращается в качестве результата отправки запроса HttpRequest. Объект HttpResponse становится доступным, когда код состояния и заголовки ответа получены, и, как правило, после того, как тело ответа также будет полностью получено. То, доступен ли объект HttpResponse до того, как тело ответа будет полностью получено, зависит от BodyHandler, предоставленного при отправке HttpRequest.

Этот класс предоставляет методы для доступа к коду состояния ответа, заголовкам, телу ответа и HttpRequest, соответствующему этому ответу.

Вот пример получения ответа в виде строки:

HttpResponse<String> response = client
  .send(request, BodyHandlers.ofString());

Класс BodyHandlers предоставляет реализации многих распространённых обработчиков ответов. В качестве альтернативы можно использовать собственную реализацию BodyHandler.

С тех пор:: 11

Краткое описание вложенных классов

Модификатор и тип	Интерфейс	Описание
`static interface`	`HttpResponse.BodyHandler<T>`	Обработчик тел ответов.
`static class`	`HttpResponse.BodyHandlers`	Реализации `BodyHandler`, которые реализуют различные полезные обработчики, такие как обработка тела ответа в виде строки или передача тела ответа в файл.
`static interface`	`HttpResponse.BodySubscriber<T>`	`BodySubscriber` потребляет байты тела ответа и преобразует их в тип Java более высокого уровня.
`static class`	`HttpResponse.BodySubscribers`	Реализации `BodySubscriber`, которые реализуют различные полезные подписчики, такие как преобразование байтов тела ответа в строку или передача байтов в файл.
`static interface`	`HttpResponse.PushPromiseHandler<T>`	Обработчик push-обещаний.
`static interface`	`HttpResponse.ResponseInfo`	Первоначальная информация об ответе, предоставляемая `BodyHandler` при первоначальном получении ответа и до обработки тела.

Краткое описание методов

Модификатор и тип	Метод	Описание
`T`	`body()`	Возвращает тело.
`HttpHeaders`	`headers()`	Возвращает полученные заголовки ответа.
`Optional<HttpResponse<T>>`	`previousResponse()`	Возвращает `Optional`, содержащий предыдущий промежуточный ответ, если он был получен.
`HttpRequest`	`request()`	Возвращает `HttpRequest`, соответствующий этому ответу.
`Optional<SSLSession>`	`sslSession()`	Возвращает `Optional`, содержащий `SSLSession`, действующий для этого ответа.
`int`	`statusCode()`	Возвращает код состояния этого ответа.
`URI`	`uri()`	Возвращает `URI`, с которого был получен ответ.
`HttpClient.Version`	`version()`	Возвращает версию протокола HTTP, которая использовалась для этого ответа.

Подробное описание методов

statusCode

int statusCode()

Возвращает код состояния этого ответа.

Возвращает:: код ответа

request

HttpRequest request()

Возвращает HttpRequest, соответствующий этому ответу.

Возвращаемый HttpRequest может не быть исходным запросом, предоставленным при отправке. Например, если исходный запрос был перенаправлен, то запрос, возвращаемый этим методом, будет содержать перенаправленный URI, который будет отличаться от URI исходного запроса.

Возвращает:

запрос

См. также:

previousResponse

Optional<HttpResponse<T>> previousResponse()

Возвращает Optional, содержащий предыдущий промежуточный ответ, если он был получен. Промежуточный ответ — это ответ, который получен в результате перенаправления или аутентификации. Если предыдущий ответ не был получен, то возвращается пустой Optional.

Возвращает:: Optional, содержащий HttpResponse, если он есть.

headers

HttpHeaders headers()

Возвращает полученные заголовки ответа.

Возвращает:: заголовки ответа

body

T body()

Возвращает тело. В зависимости от типа T, возвращаемое тело может представлять тело после его чтения (например, byte[], или String, или Path) или может представлять объект, с помощью которого тело читается, например, InputStream.

Если этот HttpResponse был возвращён из вызова previousResponse(), то этот метод возвращает null

Возвращает:: тело

sslSession

Optional<SSLSession> sslSession()

Возвращает Optional, содержащий SSLSession, действующий для этого ответа. Возвращает пустой Optional, если это не ответ HTTPS.

Возвращает:: Optional, содержащий SSLSession, связанный с ответом

uri

URI uri()

Возвращает URI, с которого был получен ответ. Это может отличаться от запрошенного URI, если произошло перенаправление.

Возвращает:: URI ответа

version

HttpClient.Version version()

Возвращает версию протокола HTTP, которая использовалась для этого ответа.

Возвращает:: версия протокола HTTP

© 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/HttpResponse.html