怎么利用 JDK 21 的 SequencedCollections 接口统一处理 List、Deque 与 Set 的首尾元素

JDK 21新增的SequencedCollections接口是集合框架的重要补充，它针对具备明确遍历顺序的集合定义了通用的首尾元素操作能力，让原本需要针对不同集合类型编写的操作逻辑可以实现统一。

SequencedCollections接口的核心定位

在JDK 21之前，List、Deque、Set三类集合的首尾元素操作方式差异很大：List通过get(0)和get(size()-1)获取首尾元素，Deque有专门的getFirst()、getLast()方法，而普通的HashSet没有顺序概念，LinkedHashSet虽然有序但没有统一的首尾操作接口。SequencedCollections接口的出现就是为了解决这个碎片化问题，它定义在java.util包下，所有具备确定顺序的集合都可以实现这个接口，从而获得统一的首尾操作能力。

SequencedCollections的核心方法

SequencedCollections接口定义了一系列用于操作首尾元素的通用方法，以下是几个最常用的方法说明：

• addFirst(E e)：将指定元素添加到集合的开头
• addLast(E e)：将指定元素添加到集合的末尾
• getFirst()：获取集合的第一个元素，集合为空时抛出NoSuchElementException
• getLast()：获取集合的最后一个元素，集合为空时抛出NoSuchElementException
• removeFirst()：移除并返回集合的第一个元素，集合为空时抛出NoSuchElementException
• removeLast()：移除并返回集合的最后一个元素，集合为空时抛出NoSuchElementException
• reversed()：返回集合的逆序视图，原集合修改会影响逆序视图，反之亦然

统一处理不同集合的首尾元素示例

下面通过具体代码示例展示如何用SequencedCollections统一处理List、Deque、LinkedHashSet的首尾元素操作。

1. 基础操作示例

首先将不同类型的集合转换为SequencedCollections类型，再调用统一的方法操作首尾元素：

import java.util.*;
import java.util.concurrent.LinkedBlockingDeque;

public class SequencedCollectionsDemo {
    public static void main(String[] args) {
        // 创建List实例
        List<String> list = new ArrayList<>();
        list.add("a");
        list.add("b");
        
        // 创建Deque实例
        Deque<String> deque = new LinkedBlockingDeque<>();
        deque.add("x");
        deque.add("y");
        
        // 创建LinkedHashSet实例（有序Set）
        Set<String> set = new LinkedHashSet<>();
        set.add("m");
        set.add("n");
        
        // 统一转换为SequencedCollection类型处理
        processSequencedCollection(list);
        processSequencedCollection(deque);
        processSequencedCollection(set);
    }
    
    private static void processSequencedCollection(SequencedCollection<String> collection) {
        System.out.println("原始集合：" + collection);
        
        // 统一添加首尾元素
        collection.addFirst("first");
        collection.addLast("last");
        System.out.println("添加首尾元素后：" + collection);
        
        // 统一获取首尾元素
        String first = collection.getFirst();
        String last = collection.getLast();
        System.out.println("首元素：" + first + "，尾元素：" + last);
        
        // 统一移除首尾元素
        collection.removeFirst();
        collection.removeLast();
        System.out.println("移除首尾元素后：" + collection);
        
        // 使用逆序视图
        SequencedCollection<String> reversed = collection.reversed();
        System.out.println("逆序视图：" + reversed);
        System.out.println("------------------------");
    }
}

2. 空集合的安全处理示例

调用getFirst、removeFirst等方法时如果集合为空会抛出异常，实际使用中可以先判断集合是否为空：

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

public class SafeOperationDemo {
    public static void main(String[] args) {
        List<String> emptyList = new ArrayList<>();
        safeGetFirst(emptyList);
        
        List<String> normalList = new ArrayList<>();
        normalList.add("test");
        safeGetFirst(normalList);
    }
    
    private static void safeGetFirst(SequencedCollection<String> collection) {
        if (!collection.isEmpty()) {
            String first = collection.getFirst();
            System.out.println("首元素：" + first);
        } else {
            System.out.println("集合为空，无法获取首元素");
        }
    }
}

注意事项

使用SequencedCollections接口时需要注意以下几点：

• 只有具备明确顺序的集合才实现了该接口，比如ArrayList、LinkedList、LinkedHashSet、LinkedBlockingDeque等，而HashSet、TreeSet（虽然有序但实现逻辑不同，JDK 21中TreeSet暂未实现该接口）等集合无法转换为SequencedCollection类型
• reversed()方法返回的是原集合的逆序视图，不是新的集合对象，修改原集合或者逆序视图都会影响对方
• 如果集合允许存储null元素，那么首尾元素也可能是null，操作时需要做好空值判断

总结

JDK 21的SequencedCollections接口为多类有序集合提供了统一的首尾元素操作规范，开发者不需要再针对List、Deque、Set分别编写操作逻辑，大幅减少了重复代码。在实际开发中，只要集合类型实现了SequencedCollections接口，就可以用统一的方法完成首尾元素的增删查以及逆序操作，提升了代码的可读性和可维护性。

JDK_21SequencedCollectionsListDequeSet修改时间：2026-06-10 21:30:38