- java.lang.Object
-
- 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
-
-
ネストされたクラスのサマリー
ネストされたクラス 修飾子と型 クラス 説明 static interface
HttpResponse.BodyHandler<T>
レスポンス本文のハンドラ。static interface
HttpResponse.BodyProcessor<T>
レスポンス・ボディ用のプロセッサ。static interface
HttpResponse.MultiProcessor<U,T>
HTTP/2マルチ・レスポンス用の応答プロセッサ。
-
コンストラクタのサマリー
コンストラクタ 修飾子 コンストラクタ 説明 protected
HttpResponse()
HttpResponseを作成します。
-
メソッドのサマリー
すべてのメソッド インスタンス・メソッド 抽象メソッド 修飾子と型 メソッド 説明 abstract T
body()
本文を返します。abstract HttpRequest
finalRequest()
交換(最初のリクエストと同じであってもなくてもよい)のために電線で送られた最後のHttpRequest
を返します。abstract HttpHeaders
headers()
受信したレスポンス・ヘッダーを返します。abstract HttpRequest
request()
交換を開始した最初のHttpRequest
を返します。abstract SSLParameters
sslParameters()
このレスポンスのSSLParameters
を返します。abstract int
statusCode()
このレスポンスのステータス・コードを返します。abstract CompletableFuture<HttpHeaders>
trailers()
受信したレスポンス・トレーラがあれば、それが利用可能になったときに戻します。abstract URI
uri()
レスポンスを受け取ったURI
を返します。abstract HttpClient.Version
version()
このレスポンスに使用されたHTTPプロトコルのバージョンを返します。
-
-
-
メソッドの詳細
-
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プロトコル・バージョン
-
-