クラス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)。指定されたヘッダー・フィールドに単一値を設定して、値リストの既存の値をすべて上書きします。

Headersのインスタンスは、「変える」または「不変」です。 「可変ヘッダー」では、HttpExchange.getResponseHeaders()によって返されるインスタンスなど、ヘッダーの名前と値を追� 、削除または変更できます。 「不変ヘッダー」では、HttpExchange.getRequestHeaders()によって返されるインスタンスなど、ヘッダー名または値に対する変更は許可されません。 不変ヘッダー・インスタンスのミューテータ・メソッドは、無条件にUnsupportedOperationExceptionをスローします。

このクラスのすべてのメソッドは、キーおよび値のnull値を拒否します。nullキーは、HTTPリクエストまたはレスポンス・ヘッダーには存在しません。

導入されたバージョン:

1.6

ネストされたクラスのサマリー

インタフェースjava.util.Mapで宣言されたネストされたクラス/インタフェース

Map.Entry<K,V>

コンストラクタのサマリー

コンストラクタ

コンストラクタ	説明
Headers()	Headersの空のインスタンスを作成します。
Headers(Map<String, List<String>> headers)	指定されたheadersから、同じヘッダー名および値を使用して、可変Headersを作成します。

メソッドのサマリー

修飾子と型	メソッド	説明
void	add(String key, String value)	指定されたvalueを、指定されたkeyのヘッダーのリストに追� します。
void	clear()	マップからマッピングをすべて削除します(オプションの操作)。
boolean	containsKey(Object key)	指定されたキーのマッピングがこのマップに含まれている� �合にtrueを返します。
boolean	containsValue(Object value)	このマップが1つまたは複数のキーと指定された値をマッピングしている� �合にtrueを返します。
Set<Map.Entry<String, List<String>>>	entrySet()	このマップに含まれるマッピングのSetビューを返します。
boolean	equals(Object o)	指定されたオブジェクトがこのマップと等しいかどうかを比較します。
List<String>	get(Object key)	指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない� �合はnullを返します。
String	getFirst(String key)	指定されたkeyのString値のListから最初の値を返します。keyのマッピングが存在しない� �合はnullを返します。
int	hashCode()	マップのハッシュ・コード値を返します。
boolean	isEmpty()	このマップがキーと値のマッピングを保持しない� �合にtrueを返します。
Set<String>	keySet()	このマップに含まれるキーのSetビューを返します。
static Headers	of(String... headers)	指定された名前値のペアをヘッダーのセットとして、不変Headersを返します。
static Headers	of(Map<String, List<String>> headers)	ヘッダー名と値が同じ指定されているheadersから不変Headersを返します。
List<String>	put(String key, List<String> value)	指定された値と指定されたキーをこのマップで関連付けます(オプションの操作)。
void	putAll(Map<? extends String, ? extends List<String>> t)	指定されたマップのすべてのマッピングをこのマップにコピーします(オプションの操作)。
List<String>	remove(Object key)	このマップからキーのマッピング(ある� �合)を削除します(オプションの操作)。
void	set(String key, String value)	指定されたvalueを、指定されたkeyの唯一のヘッダー値として設定します。
int	size()	このマップ内のキー値マッピングの数を返します。
Collection<List<String>>	values()	このマップに含まれる値のCollectionビューを返します。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

インタフェースjava.util.Mapで宣言されたメソッド

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

コンストラクタの詳細

Headers

public Headers()

Headersの空のインスタンスを作成します。

Headers

public Headers(Map<String, List<String>> headers)

指定されたheadersから、同じヘッダー名および値を使用して、可変Headersを作成します。

パラメータ:

headers - ヘッダー名と値のマップ

スロー:

NullPointerException - headersまたはそのいずれかの名前または値がnullの� �合、またはいずれかの値にnullが含まれる� �合。

導入されたバージョン:

18

メソッドの詳細

size

public int size()

インタフェースからコピーされた説明: Map

このマップ内のキー値マッピングの数を返します。 マップにInteger.MAX_VALUEを超える要� が含まれている� �合は、Integer.MAX_VALUEを返します。

定義:

size、インタフェースMap<String, List<String>>

戻り値:

このマップ内のキーと値のマッピングの数

isEmpty

public boolean isEmpty()

インタフェースからコピーされた説明: Map

このマップがキーと値のマッピングを保持しない� �合にtrueを返します。

定義:

isEmpty、インタフェースMap<String, List<String>>

戻り値:

このマップがキーと値のマッピングを保持しない� �合はtrue

containsKey

public boolean containsKey(Object key)

インタフェースからコピーされた説明: Map

指定されたキーのマッピングがこのマップに含まれている� �合にtrueを返します。 より正式には、このマップにObjects.equals(key, k)などのキーkのマッピングが含まれている� �合のみ、trueを返します。 (このようなマッピングは1つのみ存在できます。)

定義:

containsKey、インタフェースMap<String, List<String>>

パラメータ:

key - このマップ内にあるかどうかが判定されるキー

戻り値:

指定されたキーのマッピングがこのマップに含まれている� �合はtrue

containsValue

public boolean containsValue(Object value)

インタフェースからコピーされた説明: Map

このマップが1つまたは複数のキーと指定された値をマッピングしている� �合にtrueを返します。 より正式には、このマップに値vへのマッピングがObjects.equals(value, v)のように少なくとも1つ含まれている� �合にのみ、trueを返します。 この操作では、Mapインタフェースのほとんどの実装で、マップ・サイズに時間線形が必要になる� �合があります。

定義:

containsValue、インタフェースMap<String, List<String>>

パラメータ:

value - このマップにあるかどうかが判定される値

戻り値:

このマップが1つまたは複数のキーを指定された値にマッピングしている� �合はtrue

get

public List<String> get(Object key)

インタフェースからコピーされた説明: Map

指定されたキーがマップされている値を返します。そのキーのマッピングがこのマップに含まれていない� �合はnullを返します。

より正式には、このマップにキーkから値vへのマッピング(Objects.equals(key, k)など)が含まれる� �合、このメソッドはvを返します。それ以外の� �合はnullを返します。 (このようなマッピングは1つのみ存在できます。)

このマップがnull値を許可する� �合、戻り値のnullは、マップがキーのマッピングを保持していないことを示すとはかぎりません。つまり、マップが明示的にキーをnullにマップすることもあります。 containsKey操作を使うと、これら2つのケースを見分けることができます。

定義:

get、インタフェースMap<String, List<String>>

パラメータ:

key - 関連付けられた値が返されるキー

戻り値:

指定されたキーがマップされている値。そのキーのマッピングがこのマップに含まれていない� �合はnull

getFirst

public String getFirst(String key)

指定されたkeyのString値のListから最初の値を返します。keyのマッピングが存在しない� �合はnullを返します。

パラメータ:

key - 検索するキー

戻り値:

キーに関連付けられた最初のString値、キーのマッピングが存在しない� �合はnull

put

public List<String> put(String key, List<String> value)

インタフェースからコピーされた説明: Map

指定された値と指定されたキーをこのマップで関連付けます(オプションの操作)。 マップにすでにこのキーに対するマッピングがある� �合、古い値は指定された値に置き換えられます。 (マップmには、m.containsKey(k)がtrueを返す� �合にのみ、キーkのマッピングが含まれていると記述されます。)

定義:

put、インタフェースMap<String, List<String>>

パラメータ:

key - 指定された値が関連付けられるキー

value - 指定されたキーに関連付けられる値

戻り値:

keyに以前に関連付けられていた値。keyのマッピングが存在しなかった� �合はnull。 (nullの戻り値は、実装でnull値がサポートされている� �合、マップが以前にnullをkeyに関連付けたことも示すことができます。)

add

public void add(String key, String value)

指定されたvalueを、指定されたkeyのヘッダーのリストに追� します。 マッピングがま� 存在しない� �合は、作成されます。

パラメータ:

key - ヘッダー名

value - ヘッダーに追� する値

set

public void set(String key, String value)

指定されたvalueを、指定されたkeyの唯一のヘッダー値として設定します。 マッピングがま� 存在しない� �合は、作成されます。

パラメータ:

key - ヘッダー名

value - 設定するヘッダー値

remove

public List<String> remove(Object key)

インタフェースからコピーされた説明: Map

このマップからキーのマッピング(ある� �合)を削除します(オプションの操作)。 より正式には、このマップにキーkから値vへのマッピングが含まれている� �合(Objects.equals(key, k)など)、そのマッピングは削除されます。 マップはこのようなマッピングを1つ� け含めることができます。

このマップが以前にキーを関連付けた値を返します。マップにキーのマッピングが含まれていない� �合はnullを返します。

このマップでNULL値が許可されている� �合、nullの戻り値は「必ずしも」マップにキーのマッピングが含まれていないことを示しません。マップによってキーがnullに明示的にマップされている可能性もあります。

呼出しが戻ると、マップは指定されたキーのマッピングを含まなくなります。

定義:

remove、インタフェースMap<String, List<String>>

パラメータ:

key - マッピングがマップから削除されるキー

戻り値:

keyに以前に関連付けられていた値。keyのマッピングが存在しなかった� �合はnull。

putAll

public void putAll(Map<? extends String, ? extends List<String>> t)

インタフェースからコピーされた説明: Map

指定されたマップのすべてのマッピングをこのマップにコピーします(オプションの操作)。 このコールの効果は、指定されたマップ内のキーkから値vへのマッピングごとに、このマップでput(k, v)を1回コールすることと同等です。 オペレーションの進行中に、指定されたマップが変更された� �合の、このオペレーションの動作は定義されていません。 指定したマップに「見つける」が定義されている� �合、そのマッピングの処理は通常、その� �序で実行されます。

定義:

putAll、インタフェースMap<String, List<String>>

パラメータ:

t - このマップに� �納されるマッピング

clear

public void clear()

インタフェースからコピーされた説明: Map

マップからマッピングをすべて削除します(オプションの操作)。 この呼出しが戻ると、マップは空になります。

定義:

clear、インタフェースMap<String, List<String>>

keySet

public Set<String> keySet()

インタフェースからコピーされた説明: Map

このマップに含まれるキーのSetビューを返します。 セットはマップと連動しているので、マップに対する変更はセットに反� され、また、セットに対する変更はマップに反� されます。 セットの反復処理中にマップが変更された� �合、反復処理の結果は定義されていません(イテレータ自身のremoveオペレーションを除く)。 セットは要� の削除をサポートします。Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションで対応するマッピングをマップから削除します。 addまたはaddAll操作はサポートされていません。

定義:

keySet、インタフェースMap<String, List<String>>

戻り値:

マップに含まれているキーのセット・ビュー

values

public Collection<List<String>> values()

インタフェースからコピーされた説明: Map

このマップに含まれる値のCollectionビューを返します。 コレクションはマップと連動しているので、マップに対する変更はコレクションに反� され、またコレクションに対する変更はマップに反� されます。 コレクションの反復処理中にマップが変更された� �合、反復処理の結果は定義されません(イテレータ自身のremoveオペレーションを除く)。 コレクションは要� の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、Iterator.remove、Collection.remove、removeAll、retainAll、およびclearオペレーションを通して行います。 addまたはaddAll操作はサポートされていません。

定義:

values、インタフェースMap<String, List<String>>

戻り値:

マップ内に含まれている値のコレクション・ビュー

entrySet

public Set<Map.Entry<String, List<String>>> entrySet()

インタフェースからコピーされた説明: Map

このマップに含まれるマッピングのSetビューを返します。 セットはマップと連動しているので、マップに対する変更はセットに反� され、また、セットに対する変更はマップに反� されます。 セットの反復処理中にマップが変更された� �合、反復処理の結果は定義されません(イテレータ自身のremoveオペレーション、またはイテレータにより返されるマップ・エントリに対するsetValueオペレーションを除く)。 セットは要� の削除をサポートしており、対応するマッピングをマップから削除できます。削除は、Iterator.remove、Set.remove、removeAll、retainAll、およびclearオペレーションを通して行います。 addまたはaddAll操作はサポートされていません。

定義:

entrySet、インタフェースMap<String, List<String>>

戻り値:

マップ内に保持されているマッピングのセット・ビュー

equals

public boolean equals(Object o)

インタフェースからコピーされた説明: Map

指定されたオブジェクトがこのマップと等しいかどうかを比較します。 指定されたオブジェクトもマップであり、2つのマップが同じマッピングを表す� �合にtrueを返します。 つまり、m1.entrySet().equals(m2.entrySet())である� �合、2つのマップm1とm2は同じマッピングを表します。 これにより、equalsメソッドがMapインタフェースのさまざまな実装間で正しく動作することが保証されます。

定義:

equals、インタフェースMap<String, List<String>>

オーバーライド:

equals、クラスObject

パラメータ:

o - このマップと等しいかどうかが比較されるオブジェクト

戻り値:

指定されたオブジェクトがこのマップと等しい� �合はtrue

関連� �目:

• Object.hashCode()
• HashMap

hashCode

public int hashCode()

インタフェースからコピーされた説明: Map

マップのハッシュ・コード値を返します。 マップのハッシュ・コードは、マップのentrySet()ビューの各エントリのハッシュ・コードの合計として定義されます。 これにより、Object.hashCode()の一般的な契約で必要となる、m1およびm2の2つのマップに対してm1.equals(m2)がm1.hashCode()==m2.hashCode()であることを意味します。

定義:

hashCode、インタフェースMap<String, List<String>>

オーバーライド:

hashCode、クラスObject

戻り値:

マップのハッシュ・コード値

関連� �目:

• Map.Entry.hashCode()
• Object.equals(Object)
• Map.equals(Object)

of

public static Headers of(String... headers)

指定された名前値のペアをヘッダーのセットとして、不変Headersを返します。

提供されたStringインスタンスは、ヘッダー名とヘッダー値として代替する必要があります。 同じ名前に複数の値を追� するには、新しい値ごとに同じ名前を指定する必要があります。 指定されたheadersが空の� �合は、空のHeadersが返されます。

パラメータ:

headers - 名前値のペアのリスト

戻り値:

指定された名前と値のペアを持つ不変ヘッダー

スロー:

NullPointerException - headersまたはそのいずれかの要� がnullの� �合。

IllegalArgumentException - 指定された文字列の数が奇数の� �合。

導入されたバージョン:

18

of

public static Headers of(Map<String, List<String>> headers)

ヘッダー名と値が同じ指定されているheadersから不変Headersを返します。

パラメータ:

headers - ヘッダー名と値のマップ

戻り値:

不変ヘッダー

スロー:

NullPointerException - headersまたはそのいずれかの名前または値がnullの� �合、またはいずれかの値にnullが含まれる� �合。

導入されたバージョン:

18