Java SequencedCollection.reversed 如何保持双向视图：首尾操作与修改传播

Java 21 把“有明确顺序、还能从两端操作”的集合抽成了 SequencedCollection。如果只是想倒序查看或从反方向修改，reversed() 返回的是一个反向视图，不会先复制一份新集合；因此首尾方法的含义会随着视图方向一起翻转。

把 reversed() 当成同一份集合的另一条观察路径：正向集合的 first 是反向视图的 last，反之亦然；视图上的修改在实现允许时会写回原集合。

先把正向集合和反向视图分开

下面的例子使用 Java 21 的 ArrayList。forward 保存业务处理顺序，reversed 只是从另一端观察同一组元素。

import java.util.ArrayList;
import java.util.SequencedCollection;

var forward = new ArrayList();
forward.add("draft");
forward.add("review");
forward.add("published");

SequencedCollection reversed = forward.reversed();
System.out.println(forward);  // [draft, review, published]
System.out.println(reversed); // [published, review, draft]

关键点是 reversed 仍然引用 forward 的数据。调用它的 iterator() 时，遍历顺序从原集合最后一个元素走到第一个元素；这里没有发生“重新排序后再保存”的第二份状态。

首尾方法会在视图方向上翻转

正向集合的第一个元素是 draft，所以 reversed.getFirst() 得到的是原集合的最后一个元素 published。这也是为什么反向视图适合“从最新记录开始处理”的场景。

System.out.println(forward.getFirst());  // draft
System.out.println(reversed.getFirst()); // published

reversed.addFirst("archived");
System.out.println(forward);  // [draft, review, published, archived]

执行 reversed.addFirst("archived")，语义是“把 archived 放到反向视图的第一位”。换回正向顺序，它自然落在原集合尾部。这个映射可概括为：reversed.getFirst 看原集合末端，reversed.addFirst 写原集合末端。

因此，调用方若只拿到 SequencedCollection，应先确认它要表达的是队首、队尾还是展示顺序，不要把 getFirst() 固定理解成业务上的“最早一条”。

LinkedHashSet 的反向视图仍保持去重

SequencedSet 继承了集合的唯一性约束。下面用 LinkedHashSet 表示按插入顺序保存的标签：反向视图只改变顺序，重复元素仍然不能插入。

var tags = new java.util.LinkedHashSet();
tags.add("java");
tags.add("collections");
tags.add("jdk21");

var reverseTags = tags.reversed();
reverseTags.removeFirst();
System.out.println(tags); // [java, collections]

这里的 removeFirst() 先移除反向视图里的 jdk21，随后从 tags 读取时也看不到它。视图上的删除与原集合保持同一份状态，但不能据此推断所有集合实现的外部并发变化都以相同方式可见。

它不是排序器，也不是安全快照

reversed() 只反转 encounter order，不会根据字符串、数字或比较器重新排序。要按自然顺序排列，仍然使用排序 API；要得到独立数据，则显式复制，例如 new ArrayList(forward.reversed())。

还要留意三个边界：

• 集合若是不可修改视图，调用 addFirst 或 removeFirst 可能抛出 UnsupportedOperationException。
• 遍历期间修改底层集合，依然要遵守具体实现的 fail-fast 或并发约束；反向视图不会自动提供线程安全。
• 不要长期缓存反向视图而忽略底层集合生命周期。它表达的是关联关系，不是当时数据的快照。

在业务代码里怎样选用

如果需求是“从最后一条开始读，同时偶尔从末端追加或删除”，优先把反向视图局部传给消费逻辑，并在接口注释中写明 first/last 的方向。若需求是跨线程传递一份稳定结果，先复制再传递，别把视图误当成不可变对象。

一个紧凑的验收顺序是：先打印正向和反向遍历结果，再分别调用反向视图的 getFirst、addFirst、removeFirst，最后从原集合读取状态。四次输出能确认方向映射、写回关系以及实现是否允许修改。

常见问题

reversed() 会复制集合吗？

API 语义是反向视图。是否共享底层存储由具体实现决定，但不能把返回值当成独立快照使用。

反向视图能用于排序吗？

不能。它只改变 encounter order；按比较器排序属于另一类操作。

Java 8 项目能直接调用它吗？

不能。SequencedCollection 与该接口方法自 Java 21 提供，旧运行时需要采用显式复制、索引倒序或双端队列等兼容写法。

小结

SequencedCollection.reversed() 的价值在于把“从另一端看同一份有序数据”变成了统一接口。理解 forward、reversed、addFirst 和 removeFirst 的方向映射后，就能在展示、消费和双端编辑之间复用集合，而不会误以为发生了复制或排序。