Java SequencedCollection 怎么统一首尾操作：reversed、getFirst 与不可变视图

处理「最近几条订单事件」这类场景时，我们写的代码经常混着 list.get(0)、list.get(list.size() - 1) 和手写倒序循环的逻辑。Java 21 新增的 SequencedCollection 把这类操作统一收拢成 getFirst()、getLast() 与 reversed()，同一套接口就能覆盖 ArrayList、LinkedList 和 Deque 的有序访问需求。

先把集合的顺序语义说清楚

SequencedCollection 不是“所有集合都能套的通用别名”，它要求集合有稳定的 encounter order，同时支持从首尾两端观察或操作元素。ArrayList、LinkedList、ArrayDeque 都属于常见实现；没有顺序保证的 HashSet 不应该被强行当成最近记录列表使用。

这种统一设计的价值在于：业务方法可以接受 SequencedCollection 作为入参，而不必绑定某一个具体容器。真正需要随机下标能力时，仍然可以把参数声明为 List；不用为了追求接口统一反而丢掉调用方需要的能力。

用 getFirst 和 getLast 取订单事件两端

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

record OrderEvent(String id, String status) {}

static String edgeSummary(SequencedCollection events) {
    if (events.isEmpty()) {
        return "没有可展示的订单事件";
    }
    OrderEvent first = events.getFirst();
    OrderEvent last = events.getLast();
    return first.id() + " -> " + last.id();
}

var events = new ArrayList();
events.add(new OrderEvent("evt-100", "CREATED"));
events.add(new OrderEvent("evt-101", "PAID"));
System.out.println(edgeSummary(events)); // evt-100 -> evt-101

这里先判断 isEmpty()，是因为 getFirst() 和 getLast() 的语义是“集合里必须存在至少一个元素”。如果业务希望“没有事件就返回 null”，应在业务方法里显式做转换，不要依赖异常来控制正常业务分支。

reversed 返回视图，不是复制出来的新列表

reversed() 的核心属性是“view 视图”。它让遍历、读取首尾和所有顺序相关操作按照相反方向工作；在支持修改的实现上，对这个视图的修改会直接同步到原集合。

var pending = new ArrayList();
pending.add("支付校验");
pending.add("库存锁定");
pending.add("出库通知");

var newestFirst = pending.reversed();
System.out.println(newestFirst);       // [出库通知, 库存锁定, 支付校验]
System.out.println(newestFirst.getFirst()); // 出库通知

newestFirst.set(0, "出库通知-已确认");
System.out.println(pending.getLast()); // 出库通知-已确认

这段代码的验收点不能只看“输出内容看起来倒序了”，要确认两件事：第一，倒序视图的首元素就是原集合的末元素；第二，修改视图后原集合的对应位置同步发生变化。如果调用方只需要做内容展示，不应该把这个可写视图直接暴露出去。

对外返回时加上不可变边界

展示层往往需要“最新事件排在前面”，但不能让调用方直接修改服务内部维护的列表。可以先构造反向视图，再用 Collections.unmodifiableSequencedCollection() 建立只读边界。

import java.util.Collections;
import java.util.SequencedCollection;

static SequencedCollection newestEvents(SequencedCollection source) {
    return Collections.unmodifiableSequencedCollection(source.reversed());
}

var source = new ArrayList();
source.add("created");
source.add("paid");
var result = newestEvents(source);
System.out.println(result); // [paid, created]
try {
    result.add("shipped");
} catch (UnsupportedOperationException expected) {
    System.out.println("只读边界生效");
}

这是“只读视图”，不是深拷贝。源列表后续新增元素，返回的结果视图可能直接看到变化；如果需要冻结某一时刻的数据快照，应该先复制为全新的列表再做包装。两种需求不要混在同一个方法里实现，避免调用方预期错乱。

从 Java 17 迁移时检查这几个边界

• 编译环境至少升级到 Java 21；运行环境也要同步升级，否则 SequencedCollection 会在编译或项目启动阶段失败。
• 空集合先做判空，再调用 getFirst() 或 getLast()；需要支持可空语义时，自己封装对应的返回类型即可。
• 不要把 reversed() 当成数据快照；它会和源集合共享修改状态。
• 只读包装保护的是集合本身的增删改结构操作，不会自动深拷贝元素对象。
• 如果输入集合本身没有稳定顺序，先重新梳理数据模型，不要只为了调用新 API 强行做类型转换。

最小验收程序怎么写

验收逻辑可以只覆盖四个核心断言：首尾读取、倒序顺序、视图写回和不可变拒绝。实际项目中把这些断言放在集合适配器的单元测试里，比在每个业务服务里重复验证更容易长期维护。

static void require(boolean condition, String message) {
    if (!condition) throw new AssertionError(message);
}

var data = new ArrayList();
data.add("a");
data.add("b");
var reverse = data.reversed();
require(reverse.getFirst().equals("b"), "首元素方向错误");
reverse.set(0, "B");
require(data.getLast().equals("B"), "视图没有写回");
var readOnly = Collections.unmodifiableSequencedCollection(reverse);
try {
    readOnly.removeFirst();
    throw new AssertionError("只读集合意外可修改");
} catch (UnsupportedOperationException expected) {
    System.out.println("验收通过");
}

常见问题

SequencedCollection 是 Java 多少版本加入的？

它从 Java 21 开始正式提供。使用 Java 17 的项目不能只替换 import 语句就直接用，需要升级编译器和运行时环境，或者继续沿用原来的 List/Deque API。

reversed() 会复制集合吗？

把它理解成视图而非复制会更安全。它返回反向顺序视图，源集合和视图的可见变化取决于具体实现；需要快照时请显式执行复制操作。

空集合调用 getFirst() 会返回 null 吗？

不会。空集合调用该方法会抛出 NoSuchElementException，调用前应判断 isEmpty()，或在自己的 API 里转成可选结果返回。

只读反向视图会保护元素内部字段吗？

不会。不可变包装主要用来阻止增删改集合结构的操作；元素对象本身如果是可变的，仍需要自行复制元素或使用不可变数据类型做保护。

小结

Java 21 的 SequencedCollection 解决的是“有顺序集合的首尾操作缺少共同抽象”这个小但非常普遍的问题。先确认集合的顺序语义，再使用 getFirst()、getLast() 和 reversed()；对外返回时明确选择共享视图还是数据快照，代码就能同时保持简洁和边界清晰。