Интерфейс SequencedMap<K,V>

Массовые операции над этим отображением, включая методы forEach и replaceAll, работают с парами ключ-значение этого отображения в порядке следования элементов.

Множества представлений, предоставляемые методами keySet, values, entrySet, sequencedKeySet, sequencedValues и sequencedEntrySet, отражают порядок следования элементов в этом отображении. Хотя значения возвращаемых методами keySet, values, и entrySet не являются упорядоченными типами, элементы этих множеств представлений отражают порядок следования элементов этого отображения. Таким образом, итераторы, возвращаемые операторами

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

Этот интерфейс предоставляет методы для добавления, получения и удаления пар ключ-значение в начале или конце отображения.

Этот интерфейс также определяет метод reversed(), который предоставляет отображение с обратным порядком следования элементов. В обратном отображении понятия «первый» и «последний», а также «преемник» и «предшественник» меняются местами. Первая пара ключ-значение в этом отображении становится последней в обратном отображении, и наоборот. Преемник некоторой пары ключ-значение в этом отображении становится её предшественником в обратном отображении, и наоборот. Все методы, учитывающие порядок следования элементов, работают так, как будто порядок следования элементов инвертирован. Например, метод forEach обратного отображения сообщает пары ключ-значение в порядке от последней к первой паре в этом отображении. Кроме того, все множества представлений обратного отображения также отражают обратный порядок следования элементов этого отображения. Например,

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

Обратное отображение, как правило, не сериализуется, даже если исходное отображение сериализуемо.

Экземпляры Map.Entry, полученные при итерации по представлению Map.entrySet(), представлению sequencedEntrySet() и его обратному отображению, сохраняют связь с базовым отображением. Эта связь гарантируется только во время итерации. Не определено, сохраняется ли эта связь вне итерации. Если базовая карта это позволяет, вызов метода setValue элемента Entry изменит значение соответствующей пары ключ-значение в базовом отображении. Однако не определено, будут ли изменения значения в базовом отображении видны в экземпляре Entry.

Методы firstEntry(), lastEntry(), pollFirstEntry() и pollLastEntry() возвращают экземпляры Map.Entry, представляющие моментальные снимки пар ключ-значение на момент вызова. Они не поддерживают изменение базового отображения с помощью необязательного метода setValue.

В зависимости от реализации, экземпляры Entry , возвращаемые другими способами, могут быть или не быть связаны с базовым отображением. Например, рассмотрим экземпляр Entry , полученный следующим образом:

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

Этот интерфейс имеет те же требования к методам equals и hashCode , что и у методов Map.equals и Map.hashCode. Таким образом, экземпляры Map и SequencedMap сравниваются как равные, если и только если они имеют одинаковые пары ключ-значение, независимо от порядка.

Этот класс является членом Фреймворка Java Collections.