モジュール jdk.incubator.httpclient

パッケージ jdk.incubator.http

高レベルのHTTPとWebSocket API

インキュベーション機能。将来のリリースで削除されます。

HTTP (バージョン1.1と2)とWebSocketに高水準のクライアント・インタフェースを提供します。 定義されている主な型は次のとおりです:

• HttpClient
• HttpRequest
• HttpResponse
• WebSocket

APIは非同期的に(CompletableFutureを使用して)として機能し、クライアントExecutorが提供するスレッド上では実用的です。

HttpClientはシンプルな同期モードも提供します。シンプルな同期モードでは、すべての作業が呼び出しスレッドで実行されます。

このAPIによって返されるCompletableFutureは、obtrudeValueおよびobtrudeExceptionメソッドに対してUnsupportedOperationExceptionをスローします。 このAPIによって返されたCompletableFutureでcancelメソッドを呼び出すことによって、基礎となる操作が中断されることはありませんが、例外的に完了していない依存ステージを完了するのに便利です。

特に指定のない限り、nullのパラメータ値により、このパッケージ内のすべてのクラスのメソッドがNullPointerExceptionをスローします。

導入されたバージョン:

9

インタフェースのサマリー

インタフェース	説明
HttpRequest.BodyPublisher	高水準のJavaオブジェクトをリクエスト本体として送信するのに適したバイト・バッファのフローに変換するパブリッシャ。
HttpResponse.BodyHandler<T>	レスポンス本文のハンドラ。
HttpResponse.BodySubscriber<T>	レスポンス主体のサブスクライバ。
HttpResponse.MultiSubscriber<U,T>	HTTP/2マルチ・レスポンスの応答サブスクライバ。
WebSocket	WebSocketクライアント。
WebSocket.Builder	WebSocketインスタンスを作成するためのビルダー。
WebSocket.Listener	WebSocketの受信インタフェース。

クラスのサマリー

クラス	説明
HttpClient	複数のHttpRequest sに共通する構成情報のためのコンテナ。
HttpClient.Builder	不変のHttpClientのビルダー。
HttpHeaders	一連のHTTPヘッダーの読み取り専用ビュー。
HttpRequest	サーバーに送信できる1つのHTTPリクエストを表します。
HttpRequest.Builder	「HTTPリクエスト」の作成者。
HttpResponse<T>	HttpRequestへのレスポンスを表します。
MultiMapResult<V>	HTTP/2リクエストとマルチ・レスポンスの結果を含むMap。

列挙型のサマリー

列挙型	説明
HttpClient.Redirect	自動リダイレクト・ポリシーを定義します。
HttpClient.Version	HTTPプロトコルのバージョン。
WebSocket.MessagePart	部分メッセージを識別するためにWebSocket.Listenerによって使用されるマーカー。

例外のサマリー

Exception	説明
HttpTimeoutException	レスポンスが指定された期間内に受信されない場合にスローされます。
WebSocketHandshakeException	オープニング・ハンドシェイクを通知するために使用された例外が失敗しました。