java.lang.Object
com.sun.net.httpserver.Headers
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()
-
メソッドのサマリー
クラス java.lang.Objectで宣言されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
インタフェース java.util.Mapで宣言されたメソッド
clear, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, equals, forEach, get, getOrDefault, hashCode, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values
-
コンストラクタの詳細
-
Headers
public Headers()
-
-
メソッドの詳細
-
getFirst
指定されたキーについて、文字列値のリストの最初の値を返します(少なくとも1つ存在する場合)。- パラメータ:
key
- 検索するキー- 戻り値:
- キーに関連付けられた最初の文字列値
-
add
指定されたキーのヘッダーのリストに、指定された値を追加します。 マッピングがまだ存在しない場合は、作成されます。- パラメータ:
key
- ヘッダー名value
- ヘッダーに追加するヘッダー値
-
set
指定された値を指定されたキーの唯一のヘッダー値として設定します。 マッピングがまだ存在しない場合は、作成されます。- パラメータ:
key
- ヘッダー名value
- 設定するヘッダー値。
-