パッケージ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
-
クラス説明HTTPクライアント。「HTTPクライアント」のビルダー。自動リダイレクション・ポリシーを定義します。HTTPプロトコルのバージョン。指定された期間内に
HttpRequestの送信を目的とした接続が正常に確立されなかった場合にスローされます。一連のHTTPヘッダーの読み取り専用ビュー。HTTPリクエスト。BodyPublisherは、上位レベルのJavaオブジェクトをリクエスト本文として送信するのに適したバイト・バッファのフローに変換します。Stringからのリクエスト本文の公開やファイルからの公開など、各種の便利なパブリッシャを実装するBodyPublisherの実装。「HTTPリクエスト」のビルダー。HttpResponse<T>HTTPレスポンス。レスポンス本文のハンドラ。レスポンス本文を文字列として処理したり、レスポンス本文をファイルにストリーミングするなど、様々な便利なハンドラを実装するBodyHandlerの実装。BodySubscriberはレスポンス本文のバイトを消費し、上位のJavaタイプに変換します。レスポンス本文バイトをStringに変換したり、バイトをファイルにストリーミングするなど、様々な有用なサブスクライバを実装するBodySubscriberの実装。プッシュ・プロミスのハンドラです。レスポンスが最初に受信されて本文が処理される前にBodyHandlerに提供される初期レスポンス情報。レスポンスが指定された期間内に受信されない場合にスローされます。WebSocketクライアント。「WebSocketクライアント」のビルダー。WebSocketの受信インタフェース。開梱に失敗したときにスローされます。