-
- 型パラメータ:
T- レスポンス本文のタイプ
public interface HttpResponse<T>HTTPレスポンス。HttpResponseは直接作成されるのではなく、HttpRequestを送信した結果として返されます。 レスポンスのステータス・コードとヘッダーを受信したとき、および通常はレスポンス本文を完全に受信した後に、HttpResponseが使用可能になります。 レスポンス本文が完全に受信される前にHttpResponseが使用可能になっているかどうかは、HttpRequestの送信時に指定されたBodyHandlerに依存します。このクラスは、レスポンスのステータス・コード、ヘッダー、レスポンス本文およびこのレスポンスに対応する
HttpRequestにアクセスするためのメソッドを提供します。文字列としてレスポンスを取得する例を次に示します。
HttpResponse<String> response = client .send(request, BodyHandlers.ofString());クラス
BodyHandlersは、多くの共通レスポンス・ハンドラの実装を提供します。 または、カスタムBodyHandlerの実装を使用できます。- 導入されたバージョン:
- 11
-
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 インタフェース 説明 static interfaceHttpResponse.BodyHandler<T>レスポンス本文のハンドラ。static classHttpResponse.BodyHandlersレスポンス本文を文字列として処理したり、レスポンス本文をファイルにストリーミングするなど、様々な便利なハンドラを実装するBodyHandlerの実装。static interfaceHttpResponse.BodySubscriber<T>BodySubscriberはレスポンス本文のバイトを消費し、上位のJavaタイプに変換します。static classHttpResponse.BodySubscribersレスポンス本文バイトをStringに変換したり、バイトをファイルにストリーミングするなど、様々な有用なサブスクライバを実装するBodySubscriberの実装。static interfaceHttpResponse.PushPromiseHandler<T>プッシュ・プロ・ミスのハンドラです。static interfaceHttpResponse.ResponseInfoレスポンスが最初に受信されて本文が処理される前にBodyHandlerに提供される初期レスポンス情報。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 Tbody()本体を返します。HttpHeadersheaders()受信したレスポンス・ヘッダーを返します。Optional<HttpResponse<T>>previousResponse()前の中間レスポンスが受信された場合、前の中間レスポンスを含むOptionalを返します。HttpRequestrequest()このレスポンスに対応するHttpRequestを返します。Optional<SSLSession>sslSession()このレスポンスに有効なSSLSessionを含むOptionalを返します。intstatusCode()このレスポンスのステータス・コードを返します。URIuri()レスポンスの受信元のURIを返します。HttpClient.Versionversion()このレスポンスに使用されたHTTPプロトコル・バージョンを返します。
-
-
-
メソッドの詳細
-
statusCode
int statusCode()
このレスポンスのステータス・コードを返します。- 戻り値:
- レスポンス・コード
-
request
HttpRequest request()
このレスポンスに対応するHttpRequestを返します。「送信」の場合、返される
HttpRequestは起動リクエストではない可能性があります。 たとえば、開始リクエストがリダイレクトされた場合、このメソッドから返されるリクエストにはリダイレクトされたURIがあり、これは開始リクエストURIとは異なります。- 戻り値:
- 要求
- 関連項目:
previousResponse()
-
previousResponse
Optional<HttpResponse<T>> previousResponse()
前の中間レスポンスが受信された場合、前の中間レスポンスを含むOptionalを返します。 中間レスポンスは、リダイレクションまたは認証の結果として受信されるレスポンスです。 以前のレスポンスが受信されなかった場合は、空のOptionalが返されます。- 戻り値:
- HttpResponseを含むOptional。
-
headers
HttpHeaders headers()
受信したレスポンス・ヘッダーを返します。- 戻り値:
- レスポンス・ヘッダー
-
body
T body()
本体を返します。Tのタイプによっては、返される本体が読取り後の本体(byte[]、String、Pathなど)を表す場合もあれば、本体が読み取られるオブジェクト(InputStreamなど)を表す場合もあります。この
HttpResponseがpreviousResponse()の呼出しから返された場合、このメソッドはnullを返します- 戻り値:
- ボディ
-
sslSession
Optional<SSLSession> sslSession()
このレスポンスに有効なSSLSessionを含むOptionalを返します。 HTTPSレスポンスでない場合、空のOptionalを返します。- 戻り値:
- レスポンスに関連付けられた
SSLSessionを含むOptional
-
uri
URI uri()
レスポンスの受信元のURIを返します。 リダイレクションが発生した場合、これはリクエストURIと異なる可能性があります。- 戻り値:
- レスポンスのURI
-
version
HttpClient.Version version()
このレスポンスに使用されたHTTPプロトコル・バージョンを返します。- 戻り値:
- HTTPプロトコル・バージョン
-
-