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