モジュール jdk.httpserver
パッケージ 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 - 設定するヘッダー値。