モジュール jdk.incubator.httpclient
パッケージ jdk.incubator.http

クラスHttpResponse<T>

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

    public abstract class HttpResponse<T>
extends Object
    HttpRequestへのレスポンスを表します。
    インキュベーション機能。将来のリリースで削除されます。

    HttpResponseは、レスポンス・ステータス・コードとヘッダーが受信されたとき、通常はレスポンス本文も受信された後で使用できます。 これは、リクエストを送信するときに提供されるレスポンス本文ハンドラに依存します。 すべてのケースで、レスポンス本文ハンドラは本文が読み込まれる前に呼び出されます。 これにより、アプリケーションは本文をどのように扱うかを決める機会が与えられます。

    このクラスには、レスポンス・ヘッダーとレスポンス本文にアクセスするためのメソッドが用意されています。

    レスポンス・ハンドラとプロセッサ

    レスポンス機関は2つのレベルで扱われます。 アプリケーション・コードは、レスポンス・ハンドラ(HttpResponse.BodyHandler)を提供します。応答ハンドラ(HttpResponse.BodyHandler)は、レスポンス・ステータス・コードとヘッダーを調べてから、HttpResponse.BodyProcessorを返して実際に本文を読み込んで、有用なJavaオブジェクト・タイプに変換します。 ハンドラは、あらかじめ定義されたプロセッサ型の1つ、またはカスタム・プロセッサを返すことができます。また、本文を破棄する場合は、BodyProcessor.discard()を呼び出してレスポンス本文を破棄するプロセッサを返すことができます。 ハンドラとプロセッサの両方の静的な実装は、それぞれBodyHandlerとBodyProcessorで提供されています。 すべてのケースで、提供されるハンドラ関数は、提供されたステータス・コードとヘッダーを無視し、関連する事前定義されたBodyProcessorを返す便利な実装です。

    使用例については、HttpResponse.BodyHandlerを参照してください。

    導入されたバージョン:
    9

    • コンストラクタの詳細

      • HttpResponse

        protected HttpResponse​()
        HttpResponseを作成します。

    • メソッドの詳細

      • statusCode

        public abstract int statusCode​()
        このレスポンスのステータス・コードを返します。
        戻り値:
        レスポンス・コード

      • request

        public abstract HttpRequest request​()
        交換を開始した最初のHttpRequestを返します。
        戻り値:
        リクエスト

      • finalRequest

        public abstract HttpRequest finalRequest​()
        交換(最初のリクエストと同じであってもなくてもよい)のために電線で送られた最後のHttpRequestを返します。
        戻り値:
        リクエスト

      • headers

        public abstract HttpHeaders headers​()
        受信したレスポンス・ヘッダーを返します。
        戻り値:
        レスポンス・ヘッダー

      • trailers

        public abstract CompletableFuture<HttpHeaders> trailers​()
        受信したレスポンス・トレーラがあれば、それが利用可能になったときに戻します。 多くのレスポンス・プロセッサ型では、これはHttpResponse自体が利用可能になるのと同時に発生します。 そのような場合、返されたCompletableFutureはすでに完了しています。
        戻り値:
        レスポンス・トレーラ(空の場合があります)のCompletableFuture

      • body

        public abstract T body​()
        本文を返します。 Tのタイプに応じて、返された本文は、本文が(byte[]、またはString、またはPathなどの)の後に本文を表すか、本文が読み取られるオブジェクトを表すことがあります(InputStreamなど)。
        戻り値:
        体

      • sslParameters

        public abstract SSLParameters sslParameters​()
        このレスポンスのSSLParametersを返します。 これがHTTPSレスポンスでない場合は、nullを返します。
        戻り値:
        レスポンスに関連付けられたSSLParameters

      • uri

        public abstract URI uri​()
        レスポンスを受け取ったURIを返します。 これは、リダイレクトが発生した場合、リクエストURIと異なる場合があります。
        戻り値:
        レスポンスのURI

      • version

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