パッケージ java.net.http
HTTPクライアントおよびWebSocket API
HTTP (バージョン1.1と2)およびWebSocketへの低レベルのクライアント・インタフェースに、上位レベルのクライアント・インタフェースを提供します。 定義されている主な型は次のとおりです:
プロトコル固有の要件は、Hypertext Transfer Protocol Version 2 (HTTP/2)、Hypertext Transfer Protocol (HTTP/1.1)および「WebSocketプロトコル」に定義されています。
一般に、非同期タスクは操作を起動するスレッド(例: 「送信」はHTTPリクエスト、クライアントexecutorによって提供されるスレッド)のいずれかで実行されます。 依存タスクとは、返されたCompletionStagesまたはCompletableFuturesによってトリガーされ、executorを明示的に指定しない依存タスクは、 CompletableFutureと同じdefault executorで実行されるか、または依存タスクが登録される前に操作が完了した場合は起動スレッドで実行されます。
このAPIによって返されるCompletableFutureは、obtrudeValueおよびobtrudeExceptionメソッドに対してUnsupportedOperationExceptionをスローします。 このAPIによって返されたCompletableFutureでcancelメソッドを起動すると、基礎となる操作が中断されない可能性がありますが、まだ完了していない、例外的に依存しているステージの完了に役立つ場合があります。
特に指定のない限り、nullのパラメータ値により、このパッケージ内のすべてのクラスのメソッドがNullPointerExceptionをスローします。
- 導入されたバージョン:
- 11
-
インタフェースのサマリー インタフェース 説明 HttpClient.Builder 「HTTPクライアント」のビルダー。HttpRequest.BodyPublisher BodyPublisherは、上位レベルのJavaオブジェクトをリクエスト本文として送信するのに適したバイト・バッファのフローに変換します。HttpRequest.Builder 「HTTPリクエスト」のビルダー。HttpResponse<T> HTTPレスポンス。HttpResponse.BodyHandler<T> レスポンス本文のハンドラ。HttpResponse.BodySubscriber<T> BodySubscriberはレスポンス本文のバイトを消費し、上位のJavaタイプに変換します。HttpResponse.PushPromiseHandler<T> プッシュ・プロミスのハンドラです。HttpResponse.ResponseInfo レスポンスが最初に受信されて本文が処理される前にBodyHandlerに提供される初期レスポンス情報。WebSocket WebSocketクライアント。WebSocket.Builder 「WebSocketクライアント」のビルダー。WebSocket.Listener WebSocketの受信インタフェース。 -
クラスのサマリー クラス 説明 HttpClient HTTPクライアント。HttpHeaders 一連のHTTPヘッダーの読み取り専用ビュー。HttpRequest HTTPリクエスト。HttpRequest.BodyPublishers Stringからのリクエスト本文の公開やファイルからの公開など、各種の便利なパブリッシャを実装するBodyPublisherの実装。HttpResponse.BodyHandlers レスポンス本文を文字列として処理したり、レスポンス本文をファイルにストリーミングするなど、様々な便利なハンドラを実装するBodyHandlerの実装。HttpResponse.BodySubscribers レスポンス本文バイトをStringに変換したり、バイトをファイルにストリーミングするなど、様々な有用なサブスクライバを実装するBodySubscriberの実装。 -
列挙型のサマリー 列挙型 説明 HttpClient.Redirect 自動リダイレクション・ポリシーを定義します。HttpClient.Version HTTPプロトコルのバージョン。 -
例外のサマリー 例外 説明 HttpConnectTimeoutException 指定された期間内にHttpRequestの送信を目的とした接続が正常に確立されなかった場合にスローされます。HttpTimeoutException レスポンスが指定された期間内に受信されない場合にスローされます。WebSocketHandshakeException 開梱に失敗したときにスローされます。