パッケージ jakarta.ws.rs.core

クラス AbstractMultivaluedMap<K,​V>

    • フィールドの詳細

      • 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 を返さないことが保証されています。
      • hashCode

        public int hashCode()

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

        次で指定:
        インターフェース MapSE<K,​V>hashCode 
        オーバーライド:
        クラス ObjectSEhashCode 
        戻り値:
        基になる [ キー、複数値 ] ストアのハッシュコード値。
      • equals

        public boolean equals​(ObjectSE o)

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

        次で指定:
        インターフェース MapSE<K,​V>equalsSE 
        オーバーライド:
        クラス ObjectSEequalsSE 
        戻り値:
        指定されたオブジェクトが基礎となる [ キー、複数値 ] ストアと等しい場合は true、それ以外の場合は false
      • size

        public int size()
        次で指定:
        インターフェース MapSE<K,​V>size 
      • putAll

        public void putAll​(MapSE<? extends K,​? extends ListSE<V>> m)
        次で指定:
        インターフェース MapSE<K,​V>putAllSE 
      • keySet

        public SetSE<K> keySet()
        次で指定:
        インターフェース MapSE<K,​V>keySet 
      • isEmpty

        public boolean isEmpty()
        次で指定:
        インターフェース MapSE<K,​V>isEmpty 
      • clear

        public void clear()
        次で指定:
        インターフェース MapSE<K,​V>clear 
      • equalsIgnoreValueOrder

        public boolean equalsIgnoreValueOrder​(MultivaluedMap<K,​V> omap)
        インターフェースからコピーされた説明: MultivaluedMap
        指定されたマップをこのマップと比較して、各キーの値の順序を法とする等価性を調べます。具体的には、各キーに関連付けられた値が、順序付けられたリストであるかのように比較されます。
        次で指定:
        インターフェース MultivaluedMap<K,​V>equalsIgnoreValueOrder 
        パラメーター:
        omap - これと比較するマップ。
        戻り値:
        マップが等しいモジュロ値の順序である場合は true。