モジュール java.net.http
パッケージ java.net.http

インタフェースHttpResponse<T>

  • 型パラメータ:
    T - レスポンス本文のタイプ

    public interface HttpResponse<T>
    HTTPレスポンス。

    HttpResponseは直接作成されるのではなく、HttpRequestを送信した結果として返されます。 レスポンスのステータス・コードとヘッダーを受信したとき、および通常はレスポンス本文を完全に受信した後に、HttpResponseが使用可能になります。 レスポンス本文が完全に受信される前にHttpResponseが使用可能になっているかどうかは、HttpRequestの送信時に指定されたBodyHandlerに依存します。

    このクラスは、レスポンスのステータス・コード、ヘッダー、レスポンス本文およびこのレスポンスに対応するHttpRequestにアクセスするためのメソッドを提供します。

    文字列としてレスポンスを取得する例を次に示します。

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

    クラスBodyHandlersは、多くの共通レスポンス・ハンドラの実装を提供します。 または、カスタムBodyHandlerの実装を使用できます。

    導入されたバージョン:
    11
    • メソッドの詳細

      • 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[]StringPathなど)を表す場合もあれば、本体が読み取られるオブジェクト(InputStreamなど)を表す場合もあります。

        このHttpResponsepreviousResponse()の呼出しから返された場合、このメソッドはnullを返します

        戻り値:
        ボディ
      • sslSession

        Optional<SSLSession> sslSession()
        このレスポンスに有効なSSLSessionを含むOptionalを返します。 HTTPSレスポンスでない場合、空のOptionalを返します。
        戻り値:
        レスポンスに関連付けられたSSLSessionを含むOptional
      • uri

        URI uri()
        レスポンスの受信元のURIを返します。 リダイレクションが発生した場合、これはリクエストURIと異なる可能性があります。
        戻り値:
        レスポンスのURI
      • version

        HttpClient.Version version()
        このレスポンスに使用されたHTTPプロトコル・バージョンを返します。
        戻り値:
        HTTPプロトコル・バージョン