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