モジュール jdk.httpserver

パッケージ com.sun.net.httpserver

インタフェース・リクエスト

既知のすべての実装クラス:

HttpExchange, HttpsExchange

public interface Request

HTTP交換の不変リクエスト状態のビュー。

導入されたバージョン:

18

メソッドのサマリー

修飾子と型	メソッド	説明
Headers	getRequestHeaders()	このリクエストに含められたHTTPヘッダーを含む不変のHeadersを返します。
String	getRequestMethod()	リクエスト・メソッドを返します。
URI	getRequestURI()	リクエストURIを返します。
default Request	with(String headerName, List<String> headerValues)	追加のヘッダーを持つ同一のRequestを返します。

メソッドの詳細

getRequestURI

URI getRequestURI()

リクエストURIを返します。

戻り値:

リクエストURI

getRequestMethod

String getRequestMethod()

リクエスト・メソッドを返します。

戻り値:

リクエスト・メソッド文字列

getRequestHeaders

Headers getRequestHeaders()

このリクエストに含められたHTTPヘッダーを含む不変のHeadersを返します。

このHeadersのキーはヘッダー名ですが、値は「文字列」のListで、リクエストに含まれる各値を含む順序で含まれます。 複数回表示されるヘッダー・フィールドは、複数の文字列値として表されます。

Headersのキーでは、大文字と小文字は区別されません。

戻り値:

リクエスト・ヘッダーへのアクセスに使用できる読取り専用Headers。

with

default Request with(String headerName, List<String> headerValues)

追加のヘッダーを持つ同一のRequestを返します。

戻されるRequestには、thisリクエストと同じheadersセットがありますが、指定されたヘッダーが追加されています。 その他のリクエスト状態は変更されません。

thisリクエストに、指定されたheaderNameと同じ名前のヘッダーがすでに含まれている場合、その値は置換されません。

実装要件:

デフォルトの実装では、最初に新しいHeaders、hを作成し、次にthisリクエストのすべてのリクエスト・ヘッダーをhに追加し、headerNameがhに存在しない場合、指定された名前-値マッピングを追加します。 次に、変更できないビューh'(h)および新しいRequest, rが作成されます。 rのgetRequestMethodおよびgetRequestURIメソッドは、thisリクエストの同等の名前付きメソッドを呼び出すだけです。 getRequestHeadersメソッドはh'を返します。 最後に、rが返されます。

パラメータ:

headerName - ヘッダー名

headerValues - ヘッダー値のリスト

戻り値:

リクエスト

例外:

NullPointerException - 引数がnullの場合、またはheaderValuesの要素がnullの場合。