モジュール jdk.httpserver
パッケージ com.sun.net.httpserver

クラスHeaders

java.lang.Object
com.sun.net.httpserver.Headers
すべての実装されたインタフェース:
Map<String,​List<String>>
public class Headers
extends Object
implements Map<String,​List<String>>
HTTP要求および応答ヘッダーは、インタフェースMap<String, List <String>>を実装するこのクラスによって表されます。 キーはヘッダー名を表す文字列であり、大文字と小文字は区別されません。各キーに関連付けられた値は、要求または応答内に出現する各ヘッダー名に対して1つの要素を持つList<String>です。

たとえば、応答ヘッダーのインスタンスに「value1」と「value2」という2つの値を持つ1つのキー「HeaderName」が含まれている場合、このオブジェクトは2つのヘッダー行として出力されます。 

 HeaderName: value1
 HeaderName: value2

通常のMapメソッドがすべて提供されますが、次の追加の簡易メソッドがよく使用される可能性があります。

  • getFirst(String)。単一値ヘッダーまたは複数値ヘッダーの最初の値を返します。
  • add(String,String)。指定されたキーのリストに、指定されたヘッダー値を追加します。
  • set(String,String)。指定されたヘッダー・フィールドに単一値を設定して、値リストの既存の値をすべて上書きします。

このクラスのどのメソッドでも、キーおよび値でnull値が許容されます。 ただし、HTTP要求ヘッダーにnullキーが存在することはなく、応答ヘッダーで出力または送信されることもありません。 null値は、キーのnullエントリ(リストがnull)、またはキーにリストがあるがリストの1つ以上の値がnullである場合を表す可能性があります。 null値は、キーを含むが値が関連付けられていないヘッダー行として出力されます。

導入されたバージョン:
1.6

  • コンストラクタの詳細

    • Headers

      public Headers()

  • メソッドの詳細

    • getFirst

      public String getFirst​(String key)
      指定されたキーについて、文字列値のリストの最初の値を返します(少なくとも1つ存在する場合)。
      パラメータ:
      key - 検索するキー
      戻り値:
      キーに関連付けられた最初の文字列値

    • add

      public void add​(String key, String value)
      指定されたキーのヘッダーのリストに、指定された値を追加します。 マッピングがまだ存在しない場合は、作成されます。
      パラメータ:
      key - ヘッダー名
      value - ヘッダーに追加するヘッダー値

    • set

      public void set​(String key, String value)
      指定された値を指定されたキーの唯一のヘッダー値として設定します。 マッピングがまだ存在しない場合は、作成されます。
      パラメータ:
      key - ヘッダー名
      value - 設定するヘッダー値。