- java.lang.Object
- 
- java.net.http.HttpRequest
 
- 
 public abstract class HttpRequest extends Object HTTPリクエスト。HttpRequestインスタンスは、HttpRequestbuilderを介して構築されます。HttpRequestビルダーは、newBuilderメソッドのいずれかから取得されます。 リクエストURI、ヘッダーおよび本文を設定できます。 リクエスト本体は、POST、PUTまたはmethodメソッドの1つに提供されているBodyPublisherを介して提供されます。 必要なパラメータがすべてビルダーに設定されると、buildはHttpRequestを返します。 一部のパラメータが異なる複数の関連リクエストを作成するために、ビルダーを何度でもコピーおよび変更できます。レスポンス本文を文字列として出力するGETリクエストの例を次に示します。 HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("http://foo.com/")) .build(); client.sendAsync(request, BodyHandlers.ofString()) .thenApply(HttpResponse::body) .thenAccept(System.out::println) .join();クラス BodyPublishersは、多くの共通パブリッシャの実装を提供します。 または、カスタムBodyPublisherの実装を使用できます。- 導入されたバージョン:
- 11
 
- 
- 
ネストされたクラスのサマリーネストされたクラス 修飾子と型 クラス 説明 static interfaceHttpRequest.BodyPublisherBodyPublisherは、上位レベルのJavaオブジェクトをリクエスト本文として送信するのに適したバイト・バッファのフローに変換します。static classHttpRequest.BodyPublishersStringからのリクエスト本文の公開やファイルからの公開など、各種の便利なパブリッシャを実装するBodyPublisherの実装。static interfaceHttpRequest.Builder「HTTPリクエスト」のビルダー。
 - 
コンストラクタのサマリーコンストラクタ 修飾子 コンストラクタ 説明 protectedHttpRequest()HttpRequestを作成します。
 - 
メソッドのサマリー修飾子と型 メソッド 説明 abstract Optional<HttpRequest.BodyPublisher>bodyPublisher()このリクエストで設定されたHttpRequest.BodyPublisherを含むOptionalを返します。booleanequals(Object obj)このHTTPリクエスト・インスタンスが指定されたオブジェクトと等しいかどうかをテストします。abstract booleanexpectContinue()このリクエスト「続行の予定」設定を返します。inthashCode()このHTTPリクエスト・インスタンスのハッシュ・コードを計算します。abstract HttpHeadersheaders()(user-accessible)リクエスト・ヘッダーは、このリクエストが送信された(または)でした。abstract Stringmethod()このリクエストのリクエスト・メソッドを返します。static HttpRequest.BuildernewBuilder()HttpRequestビルダーを作成します。static HttpRequest.BuildernewBuilder(URI uri)指定されたURIのHttpRequestビルダーを作成します。abstract Optional<Duration>timeout()このリクエスト・タイムアウト期間を含むOptionalを返します。abstract URIuri()このリクエストURIを返します。abstract Optional<HttpClient.Version>version()このHttpRequestにリクエストされるHTTPプロトコル・バージョンを含むOptionalを返します。
 
- 
- 
- 
メソッドの詳細- 
newBuilderpublic static HttpRequest.Builder newBuilder(URI uri) 指定されたURIのHttpRequestビルダーを作成します。- パラメータ:
- uri- リクエストURI
- 戻り値:
- 新しいリクエスト・ビルダー
- 例外:
- IllegalArgumentException- URIスキームがサポートされていない場合。
 
 - 
newBuilderpublic static HttpRequest.Builder newBuilder() HttpRequestビルダーを作成します。- 戻り値:
- 新しいリクエスト・ビルダー
 
 - 
bodyPublisherpublic abstract Optional<HttpRequest.BodyPublisher> bodyPublisher() このリクエストで設定されたHttpRequest.BodyPublisherを含むOptionalを返します。BodyPublisherがリクエスト・ビルダーに設定されていない場合、Optionalは空です。- 戻り値:
- このリクエストを含むOptionalBodyPublisher
 
 - 
methodpublic abstract String method() このリクエストのリクエスト・メソッドを返します。 明示的に設定されていない場合、任意のリクエストに対するデフォルトのメソッドは"GET"です。- 戻り値:
- このリクエスト・メソッド
 
 - 
timeoutpublic abstract Optional<Duration> timeout() このリクエスト・タイムアウト期間を含むOptionalを返します。 リクエスト・ビルダーでタイムアウト時間が設定されていない場合、Optionalは空です。- 戻り値:
- このリクエスト・タイムアウト時間を含むOptional
 
 - 
expectContinuepublic abstract boolean expectContinue() このリクエスト「続行の予定」設定を返します。- 戻り値:
- このリクエストは設定を続けることを期待しています
 
 - 
uripublic abstract URI uri() このリクエストURIを返します。- 戻り値:
- このリクエストURI
 
 - 
versionpublic abstract Optional<HttpClient.Version> version() このHttpRequestにリクエストされるHTTPプロトコル・バージョンを含むOptionalを返します。 リクエスト・ビルダーにバージョンが設定されていない場合、Optionalは空です。 その場合、リクエストされたバージョンは送信するHttpClientのバージョンになります。 実際に使用されたバージョンを確認するには、対応するHttpResponseを問合せする必要があります。- 戻り値:
- HTTPプロトコル・バージョン
 
 - 
headerspublic abstract HttpHeaders headers() (user-accessible)リクエスト・ヘッダーは、このリクエストが送信された(または)でした。- 戻り値:
- このリクエストHttpHeaders
 
 - 
equalspublic final boolean equals(Object obj) このHTTPリクエスト・インスタンスが指定されたオブジェクトと等しいかどうかをテストします。指定されたオブジェクトが HttpRequestでない場合、このメソッドはfalseを返します。 URI、メソッド、およびヘッダー・フィールドがすべて等しい場合、2つのHTTPリクエストは等しいです。このメソッドは Object.equalsメソッドの汎用規約を満たします。- オーバーライド:
- equals、クラス:- Object
- パラメータ:
- obj- このオブジェクトが比較されるオブジェクト
- 戻り値:
- 指定されたオブジェクトがこのHTTPリクエストと等しいHttpRequestである場合にのみtrue
- 関連項目:
- Object.hashCode()、- HashMap
 
 - 
hashCodepublic final int hashCode() このHTTPリクエスト・インスタンスのハッシュ・コードを計算します。ハッシュ・コードは、HTTPリクエストのURI、メソッド、およびヘッダー・コンポーネントに基づいており、 Object.hashCodeメソッドの汎用規約を満たしています。- オーバーライド:
- hashCode、クラス:- Object
- 戻り値:
- このHTTPリクエストのハッシュ・コード値
- 関連項目:
- Object.equals(java.lang.Object),- System.identityHashCode(java.lang.Object)
 
 
- 
 
-