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

既知のすべての実装クラス:
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の場合。