インタフェースSequencedMap<K,V>

型パラメータ:

K - このマップによって保持されるキーのタイプ

V - マップされた値のタイプ

すべてのスーパー・インタフェース:

Map<K,V>

既知のすべてのサブインタフェース:

ConcurrentNavigableMap<K,V>, NavigableMap<K,V>, SortedMap<K,V>

既知のすべての実装クラス:

ConcurrentSkipListMap, LinkedHashMap, TreeMap

public interface SequencedMap<K,V> extends Map<K,V>

検出� �序が明確に定義され、両端での操作をサポートし、逆転可能なマップ。 SequencedMapの「見つける」は、SequencedCollectionの要� の「見つける」と似ていますが、� �序付けは個々の要� ではなくマッピングに適用されます。

このマップでのバルク操作(forEachおよびreplaceAllメソッドを含む)は、このマップのマッピングを検出� �に操作します。

keySet、values、entrySet、sequencedKeySet、sequencedValuesおよびsequencedEntrySetメソッドによって提供されるビュー・コレクションは、すべてこのマップの出現� �序を反� しています。 keySet、valuesおよびentrySetメソッドの戻り値はtypesの� �序付けではありませんが、これらのビュー・コレクションの要� は、このマップの出現� �序を反� します。 したがって、ステートメントによって返されるイテレータです

    var it1 = sequencedMap.entrySet().iterator();
    var it2 = sequencedMap.sequencedEntrySet().iterator();

両方とも、sequencedMapのマッピングをそのマップの出現� �に指定します。

このインタフェースには、マッピングの追� 、マッピングの取得、およびマップの検索� �序のいずれかの端にあるマッピングの削除を行うメソッドがあります。

このインタフェースは、このマップの逆� �viewを提供するreversed()メソッドも定義します。 � �序の逆のビューでは、後任者と前任者の概念と同様に、最初と最後の概念が反転します。 このマップの最初のマッピングは、� �序が逆のビューの最後のマッピングです。その逆も同様です。 このマップ内の一部のマッピングの後継は、逆方向ビューの先行作業です。その逆も同様です。 マップの出現� �序を尊重するすべてのメソッドは、発生� �序が反転しているかのように動作します。 たとえば、逆方向ビューのforEachメソッドは、このマップの最後のマッピングから最初のマッピングの� �にマッピングをレポートします。 また、逆方向ビューのすべてのビュー・コレクションには、このマップの出現� �序の逆も反� されます。 たとえば、

    var itr = sequencedMap.reversed().entrySet().iterator();

、このマップのマッピングを検出� �序の逆、つまり最後のマッピングから最初のマッピングへの逆になります。 reversedメソッドの可用性と、適用可能なすべてのメソッドおよびビューの� �序付けセマンティクスへの影響により、このマップのマッピングを� �方向または逆� �で簡単に反復、検索、コピーおよびストリーミングできます。

マップの逆� �ビューは通常、元のマップが直列化可能であっても、直列化可能ではありません。

Map.entrySet()ビュー、sequencedEntrySet()ビューおよびその逆� �ビューを反復して取得されたMap.Entryインスタンスは、基礎となるマップへの接続を維持します。 この接続は反復中にのみ保証されます。 接続が反復の外部で維持されるかどうかは不確定です。 基礎となるマップで許可されている� �合、エントリのsetValueメソッドをコールすると、基礎となるマッピングの値が変更されます。 た� し、基礎となるマッピングの値に対する変更がEntryインスタンスに表示されるかどうかは未指定です。

メソッドfirstEntry()、lastEntry()、pollFirstEntry()およびpollLastEntry()は、コール時点でのマッピングのスナップショットを表すMap.Entryインスタンスを返します。 オプションのsetValueメソッドを介した基礎となるマップの変更はサポートされていません。

実装によっては、他の方法で返されるEntryインスタンスが、基礎となるマップに接続される� �合と、そうでない� �合があります。 たとえば、次の方法で取得したEntryについて考えてみます:

    var entry = sequencedMap.sequencedEntrySet().getFirst();

このインタフェースでは、取得したEntryのsetValueメソッドが基礎となるマップのマッピングを更新するか、例外をスローするか、基礎となるマップへの変更をそのEntryで参照できるかは指定されません。

このインタフェースの要件は、Map.equalsおよびMap.hashCodeで定義されているequalsおよびhashCodeメソッドと同じです。 したがって、MapとSequencedMapは、� �序に関係なく、マッピングが等しい� �合にのみ等価を比較します。

このクラスは、Java Collections Frameworkのメンバーです。

導入されたバージョン:

21

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

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

Map.Entry<K,V>

メソッドのサマリー

修飾子と型	メソッド	説明
default Map.Entry<K,V>	firstEntry()	このマップの最初のキーと値のマッピングを返します。マップが空の� �合はnullを返します。
default Map.Entry<K,V>	lastEntry()	このマップの最後のキーと値のマッピングを返します。マップが空の� �合はnullを返します。
default Map.Entry<K,V>	pollFirstEntry()	このマップの最初のキー値マッピングを削除して返します。マップが空の� �合はnullを返します。 (オプションの操作)。
default Map.Entry<K,V>	pollLastEntry()	このマップの最後のキー/値マッピングを削除して返します。マップが空の� �合はnullを返します。 (オプションの操作)。
default V	putFirst(K k, V v)	指定されたマッピングがま� 存在しない� �合はマップに挿入し、すでに存在する� �合はマッピングの値を置換します (オプションの操作)。
default V	putLast(K k, V v)	指定されたマッピングがま� 存在しない� �合はマップに挿入し、すでに存在する� �合はマッピングの値を置換します (オプションの操作)。
SequencedMap<K,V>	reversed()	このマップの逆� �viewを返します。
default SequencedSet<Map.Entry<K,V>>	sequencedEntrySet()	このマップのentrySetのSequencedSetビューを返します。
default SequencedSet<K>	sequencedKeySet()	このマップのkeySetのSequencedSetビューを返します。
default SequencedCollection<V>	sequencedValues()	このマップのvaluesコレクションのSequencedCollectionビューを返します。

インタフェース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

メソッドの詳細

reversed

SequencedMap<K,V> reversed()

このマップの逆� �viewを返します。 返されるビューでのマッピングの検出� �序は、このマップでのマッピングの検出� �序の逆です。 逆の� �序付けは、返されるビューのビュー・コレクションに含まれるすべての� �序依存操作に影響します。 実装でこのビューの変更が許可されている� �合は、基礎となるマップに"ライトスルー"が変更されます。 実装によっては、基礎となるマップに対する変更が、この逆方向ビューに表示される� �合と表示されない� �合があります。

戻り値:

このマップの逆� �ビュー

firstEntry

default Map.Entry<K,V> firstEntry()

このマップの最初のキーと値のマッピングを返します。マップが空の� �合はnullを返します。

実装要件:

このインタフェースの実装では、このマップのentrySetのイテレータが取得されます。 イテレータに要� がある� �合、その要� の変更不可のコピーが返されます。 それ以外の� �合は、nullを返します。

戻り値:

最初のキー/値マッピング、またはこのマップが空の� �合はnull

lastEntry

default Map.Entry<K,V> lastEntry()

このマップの最後のキーと値のマッピングを返します。マップが空の� �合はnullを返します。

実装要件:

このインタフェースの実装では、このマップの逆方向表示のentrySetのイテレータが取得されます。 イテレータに要� がある� �合、その要� の変更不可のコピーが返されます。 それ以外の� �合は、nullを返します。

戻り値:

最後のキーと値のマッピング、またはこのマップが空の� �合はnull

pollFirstEntry

default Map.Entry<K,V> pollFirstEntry()

このマップの最初のキー値マッピングを削除して返します。マップが空の� �合はnullを返します。 (オプションの操作)。

実装要件:

このインタフェースの実装では、このマップのentrySetのイテレータが取得されます。 イテレータに要� がある� �合、イテレータでremoveをコールし、その要� の変更不可のコピーを返します。 それ以外の� �合は、nullを返します。

戻り値:

このマップの削除された最初のエントリ。このマップが空の� �合はnull

スロー:

UnsupportedOperationException - このコレクション実装がこの操作をサポートしていない� �合

pollLastEntry

default Map.Entry<K,V> pollLastEntry()

このマップの最後のキー/値マッピングを削除して返します。マップが空の� �合はnullを返します。 (オプションの操作)。

実装要件:

このインタフェースの実装では、このマップの逆方向表示のentrySetのイテレータが取得されます。 イテレータに要� がある� �合、イテレータでremoveをコールし、その要� の変更不可のコピーを返します。 それ以外の� �合は、nullを返します。

戻り値:

このマップの削除された最後のエントリ。このマップが空の� �合はnull

スロー:

UnsupportedOperationException - このコレクション実装がこの操作をサポートしていない� �合

putFirst

default V putFirst(K k, V v)

指定されたマッピングがま� 存在しない� �合はマップに挿入し、すでに存在する� �合はマッピングの値を置換します (オプションの操作)。 この操作が正常に完了すると、指定されたマッピングがこのマップに存在し、このマップの出現� �序の最初のマッピングになります。

実装要件:

このインタフェースの実装では、常にUnsupportedOperationExceptionがスローされます。

パラメータ:

k - キー

v - 値

戻り値:

以前kに関連付けられていた値。関連付けられていない� �合はnull

スロー:

UnsupportedOperationException - このコレクション実装がこの操作をサポートしていない� �合

putLast

default V putLast(K k, V v)

指定されたマッピングがま� 存在しない� �合はマップに挿入し、すでに存在する� �合はマッピングの値を置換します (オプションの操作)。 この操作が正常に完了すると、指定されたマッピングがこのマップに存在し、このマップの出現� �序の最後のマッピングになります。

実装要件:

このインタフェースの実装では、常にUnsupportedOperationExceptionがスローされます。

パラメータ:

k - キー

v - 値

戻り値:

以前kに関連付けられていた値。関連付けられていない� �合はnull

スロー:

UnsupportedOperationException - このコレクション実装がこの操作をサポートしていない� �合

sequencedKeySet

default SequencedSet<K> sequencedKeySet()

このマップのkeySetのSequencedSetビューを返します。

実装要件:

このインタフェースの実装では、次のように動作するSequencedSetインスタンスが返されます。 addおよびaddAllメソッドは、UnsupportedOperationExceptionをスローします。 reversedメソッドは、このマップのreversedビューのsequencedKeySetビューを返します。 他の各メソッドは、このマップのkeySetビューの対応するメソッドをコールします。

戻り値:

このマップのkeySetのSequencedSetビュー

sequencedValues

default SequencedCollection<V> sequencedValues()

このマップのvaluesコレクションのSequencedCollectionビューを返します。

実装要件:

このインタフェースの実装では、次のように動作するSequencedCollectionインスタンスが返されます。 addおよびaddAllメソッドは、UnsupportedOperationExceptionをスローします。 reversedメソッドは、このマップのreversedビューのsequencedValuesビューを返します。 equalsおよびhashCodeメソッドは、Objectから継承されます。 他の各メソッドは、このマップのvaluesビューの対応するメソッドをコールします。

戻り値:

このマップのvaluesコレクションのSequencedCollectionビュー

sequencedEntrySet

default SequencedSet<Map.Entry<K,V>> sequencedEntrySet()

このマップのentrySetのSequencedSetビューを返します。

実装要件:

このインタフェースの実装では、次のように動作するSequencedSetインスタンスが返されます。 addおよびaddAllメソッドは、UnsupportedOperationExceptionをスローします。 reversedメソッドは、このマップのreversedビューのsequencedEntrySetビューを返します。 他の各メソッドは、このマップのentrySetビューの対応するメソッドをコールします。

戻り値:

このマップのentrySetのSequencedSetビュー