フィールドの詳細

• store

  protected final MapSE<K,ListSE<V>> store

  [ キー、複数値 ] ペアのバッキングストア。

コンストラクターの詳細

• AbstractMultivaluedMap

  public AbstractMultivaluedMap(MapSE<K,ListSE<V>> store)

  抽象親多値マップ実装でバッキングストアを初期化します。

  パラメーター:

  store - [ キー、複数値 ] ストアとして使用されるバッキング MapSE null であってはなりません。

  例外:

  NullPointerExceptionSE - 基になる store パラメーターが null の場合。

メソッドの詳細

• putSingle

  public final void putSingle(K key,
                              V value)

  キーの値を、提供された値で構成される 1 つの項目リストになるように設定します。既存の値は置き換えられます。

  NOTE: この実装は null 値を無視します。指定された null の値は無視され、パージされた値のリストには追加されません。このような操作の結果、提供されたキーに空の値リストが登録されます。実装をオーバーライドすると、addNull(java.util.List) メソッドを再定義することにより、この動作が変更される場合があります。

  次で指定:

  インターフェース MultivaluedMap<K, V> の putSingle 

  パラメーター:

  key - キー

  value - キーの単一の値。値が null の場合は無視されます。

• addNull

  protected void addNull(ListSE<V> values)

  null 値を値リストに追加するための動作を定義します。

  デフォルトの実装は何もしない、つまり null 値は無視されます。オーバーライドする実装は、このメソッドの独自の定義を提供することにより、この動作を変更する場合があります。

  パラメーター:

  values - null 値の追加がリクエストされている値のリスト。

• addFirstNull

  protected void addFirstNull(ListSE<V> values)

  値リストの最初の位置に null 値を追加するための動作を定義します。

  デフォルトの実装は何もしない、つまり null 値は無視されます。オーバーライドする実装は、このメソッドの独自の定義を提供することにより、この動作を変更する場合があります。

  パラメーター:

  values - null 値の追加がリクエストされている値のリスト。

• add

  public final void add(K key,
                        V value)

  指定されたキーの現在の値のリストに値を追加します。

  NOTE: この実装は null 値を無視します。指定された null の値は無視され、値リストに追加されません。実装をオーバーライドすると、addNull(java.util.List) メソッドを再定義することにより、この動作が変更される場合があります。

  次で指定:

  インターフェース MultivaluedMap<K, V> の add 

  パラメーター:

  key - キー

  value - 追加する値。

• addAll

  public final void addAll(K key,
                           V... newValues)

  指定されたキーの現在の値のリストに複数の値を追加します。指定された新しい値の配列が空の場合、メソッドはすぐに戻ります。指定された値の配列が null の場合、メソッドは NullPointerException をスローします。

  NOTE: この実装は null 値を無視します。指定された null の値はすべて無視され、値リストに追加されません。実装をオーバーライドすると、addNull(java.util.List) メソッドを再定義することにより、この動作が変更される場合があります。

  次で指定:

  インターフェース MultivaluedMap<K, V> の addAll 

  パラメーター:

  key - キー。

  newValues - 追加する値。

  例外:

  NullPointerExceptionSE - 指定された新しい値の配列が null の場合

• addAll

  public final void addAll(K key,
                           ListSE<V> valueList)

  指定された値リストのすべての値を、指定されたキーの現在の値のリストに追加します。指定された値リストが空の場合、メソッドはすぐに戻ります。指定された値の配列が null の場合、メソッドは NullPointerException をスローします。

  NOTE: この実装は null 値を無視します。提供された値リスト内の null 値は無視され、値リストに追加されません。実装をオーバーライドすると、addNull(java.util.List) メソッドを再定義することにより、この動作が変更される場合があります。

  次で指定:

  インターフェース MultivaluedMap<K, V> の addAll 

  パラメーター:

  key - キー。

  valueList - 追加する値のリスト。

  例外:

  NullPointerExceptionSE - 指定された値リストが null の場合。

• getFirst

  public final V getFirst(K key)

  インターフェースからコピーされた説明: MultivaluedMap
  指定されたキーの最初の値を取得するためのショートカット。

  次で指定:

  インターフェース MultivaluedMap<K, V> の getFirst 

  パラメーター:

  key - キー

  戻り値:

  指定されたキーの最初の値、またはキーがマップにない場合は null

• addFirst

  public final void addFirst(K key,
                             V value)

  指定されたキーの現在の値リストの最初の位置に値を追加します。

  NOTE: この実装は null 値を無視します。指定された null の値は無視され、パージされた値のリストには追加されません。実装をオーバーライドすると、addFirstNull(java.util.List) メソッドを再定義することにより、この動作が変更される場合があります。

  次で指定:

  インターフェース MultivaluedMap<K, V> の addFirst 

  パラメーター:

  key - キー

  value - 追加する値。

• getValues

  protected final ListSE<V> getValues(K key)

  指定されたキーの値の null 以外のリストを返します。返されるリストは空の場合があります。

  マップにキーのエントリがない場合、新しい空の ListSE インスタンスが作成され、キーの値を保持するためにマップ内に登録され、メソッドから返されます。

  パラメーター:

  key - キー。

  戻り値:

  キーに登録された値リスト。このメソッドは決して null を返さないことが保証されています。

• toString

  public StringSE toString()

  オーバーライド:

  クラス ObjectSE の toStringSE 

• hashCode

  public int hashCode()

  この実装は、メソッドの呼び出しを基礎となる [ キー、複数値 ] ストアに委譲します。

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の hashCodeSE 

  オーバーライド:

  クラス ObjectSE の hashCodeSE 

  戻り値:

  基になる [ キー、複数値 ] ストアのハッシュコード値。

• equals

  public boolean equals(ObjectSE o)

  この実装は、メソッドの呼び出しを基礎となる [ キー、複数値 ] ストアに委譲します。

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の equalsSE 

  オーバーライド:

  クラス ObjectSE の equalsSE 

  戻り値:

  指定されたオブジェクトが基礎となる [ キー、複数値 ] ストアと等しい場合は true、それ以外の場合は false。

• values

  public CollectionSE<ListSE<V>> values()

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の valuesSE 

• size

  public int size()

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の sizeSE 

• remove

  public ListSE<V> remove(ObjectSE key)

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の removeSE 

• putAll

  public void putAll(MapSE<? extends K,? extends ListSE<V>> m)

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の putAllSE 

• put

  public ListSE<V> put(K key,
                     ListSE<V> value)

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の putSE 

• keySet

  public SetSE<K> keySet()

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の keySetSE 

• isEmpty

  public boolean isEmpty()

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の isEmptySE 

• get

  public ListSE<V> get(ObjectSE key)

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の getSE 

• entrySet

  public SetSE<Map.EntrySE<K,ListSE<V>>> entrySet()

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の entrySetSE 

• containsValue

  public boolean containsValue(ObjectSE value)

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の containsValueSE 

• containsKey

  public boolean containsKey(ObjectSE key)

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の containsKeySE 

• clear

  public void clear()

  次で指定:

  インターフェース MapSE<K, ListSE<V>> の clearSE 

• equalsIgnoreValueOrder

  public boolean equalsIgnoreValueOrder(MultivaluedMap<K,V> omap)

  インターフェースからコピーされた説明: MultivaluedMap
  指定されたマップをこのマップと比較して、各キーの値の順序を法とする等価性を調べます。具体的には、各キーに関連付けられた値が、順序付けられたリストであるかのように比較されます。

  次で指定:

  インターフェース MultivaluedMap<K, V> の equalsIgnoreValueOrder 

  パラメーター:

  omap - これと比較するマップ。

  戻り値:

  マップが等しいモジュロ値の順序である場合は true。