异常教程

Java ArrayList subList() 方法（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Java 开发中，ArrayList 是最常用的数据结构之一，而 subList() 方法则是操作列表片段的利器。无论是数据分页、局部数据处理，还是结合其他集合方法进行复杂操作，subList() 都能提供简洁高效的解决方案。本文将深入解析 Java ArrayList subList() 方法 的原理、用法及注意事项，通过实例帮助读者掌握这一工具的核心价值。

一、从基础到进阶：理解 ArrayList 的 subList() 方法

1.1 什么是 subList() 方法？

subList() 是 List 接口提供的方法，允许开发者通过指定起始和结束索引，获取列表的子集。例如，若有一个包含 10 个元素的列表，可以通过 list.subList(2, 5) 获得第 3 到第 5 个元素（索引从 2 开始，到 4 结束）。

核心语法：

List<YourType> subList = originalList.subList(int fromIndex, int toIndex);
  • fromIndex：子列表的起始索引（包含）。
  • toIndex：子列表的结束索引（不包含）。

形象比喻：
可以将 subList() 视为“切片工具”，就像用刀将列表切成两半或中间的一段，但切片本身仍与原列表共享“同一块蛋糕”（即底层数据）。

1.2 初次使用：简单示例

示例 1：基础用法

ArrayList<Integer> numbers = new ArrayList<>(Arrays.asList(1, 2, 3, 4, 5, 6, 7, 8, 9));  
List<Integer> sub = numbers.subList(2, 5); // 获取索引 2~4 的元素  
System.out.println(sub); // 输出 [3, 4, 5]

示例 2：结合循环遍历

for (Integer num : numbers.subList(0, 3)) {  
    System.out.print(num + " ");  
}  
// 输出 1 2 3

二、原理剖析：为什么修改子列表会影响原列表？

2.1 共享底层数据

subList() 返回的子列表并非新列表的拷贝，而是原列表的视图（View）。两者共享同一个 ArrayList 的底层 Object[] elementData 数组。因此，对子列表的任何增删改操作，都会直接反映到原列表中。

代码验证：

ArrayList<String> mainList = new ArrayList<>(Arrays.asList("A", "B", "C", "D"));  
List<String> sub = mainList.subList(1, 3); // 获取 ["B", "C"]  
sub.set(0, "X"); // 修改子列表的第一个元素  
System.out.println(mainList); // 输出 [A, X, C, D]

2.2 索引范围的陷阱

subList() 的 toIndex 参数是不包含的。若误将结束索引设为列表长度（如 list.subList(0, list.size())），虽然不会报错，但实际效果等同于复制整个列表，可能造成性能浪费。

三、关键注意事项与常见问题

3.1 修改子列表与原列表的同步性

由于子列表与原列表共享数据，以下操作均会双向影响：

  • 增删操作：如 subList.add()、subList.remove() 会改变原列表长度。
  • 直接赋值：如 subList.set(index, value) 会同步更新原列表。

案例演示：

ArrayList<Integer> list = new ArrayList<>(Arrays.asList(10, 20, 30, 40));  
List<Integer> sub = list.subList(1, 3); // [20, 30]  
sub.add(25); // 在子列表索引 1 插入  
System.out.println(list); // 输出 [10, 20, 25, 30, 40]

3.2 线程安全与并发修改

若在遍历子列表时修改其内容，可能引发 ConcurrentModificationException 异常。例如：

List<String> sub = mainList.subList(0, 2);  
for (String s : sub) {  
    if (s.equals("B")) sub.remove(s); // 可能抛出异常  
}

解决方案：

  • 使用迭代器的 remove() 方法。
  • 或者先创建子列表的拷贝：new ArrayList<>(subList)。

3.3 索引越界的边界条件

调用 subList() 时，若参数不满足以下条件，会抛出 IndexOutOfBoundsException：

  • fromIndex < 0 或 toIndex > list.size()
  • fromIndex > toIndex

防御性编程建议：
在实际开发中，建议先验证索引范围：

int from = 2;  
int to = 5;  
if (from >= 0 && to <= list.size() && from < to) {  
    List<?> sub = list.subList(from, to);  
} else {  
    throw new IllegalArgumentException("Invalid indices");  
}

四、实战案例：如何高效使用 subList()

案例 1：分页功能实现

在 Web 开发中，分页是常见需求。subList() 可直接实现“跳过前 n 条，获取 m 条”的逻辑：

// 假设每页显示 10 条数据  
int page = 2; // 当前页码（从 1 开始）  
int pageSize = 10;  
int fromIndex = (page - 1) * pageSize;  
List<User> pageData = allUsers.subList(fromIndex, fromIndex + pageSize);

案例 2：局部数据排序

若需对列表的某个片段排序，可结合 subList() 和 Collections.sort()：

List<Integer> nums = new ArrayList<>(Arrays.asList(5, 3, 8, 1, 9));  
List<Integer> sub = nums.subList(1, 4); // 获取 [3, 8, 1]  
Collections.sort(sub); // 排序后子列表变为 [1, 3, 8]  
System.out.println(nums); // 输出 [5, 1, 3, 8, 9]

案例 3：统计特定范围的元素

通过 subList() 可快速统计列表中某一区间的元素总和：

List<Double> sales = Arrays.asList(100.0, 150.0, 200.0, 120.0);  
double total = sales.subList(1, 3).stream()  
                    .mapToDouble(Double::doubleValue)  
                    .sum(); // 计算索引 1~2 的元素总和（150 + 200 = 350）

五、对比与替代方案

5.1 subList() vs Arrays.copyOfRange()

  • subList()：动态视图，修改双向同步，适合需要与原列表保持关联的场景。
  • Arrays.copyOfRange()：返回新数组的拷贝，修改互不影响，适合需要独立操作的场景。

5.2 subList() vs 自定义循环

直接通过循环遍历并收集元素，虽然能避免同步问题，但代码冗长且效率较低。例如：

// 不推荐的替代方案  
List<Integer> customSub = new ArrayList<>();  
for (int i = start; i < end; i++) {  
    customSub.add(original.get(i));  
}

六、进阶技巧：结合其他集合方法

6.1 链式操作与 Stream

subList() 可与 Stream 链式调用，实现复杂逻辑：

List<String> filtered = list.subList(0, 5)  
                            .stream()  
                            .filter(s -> s.length() > 3)  
                            .collect(Collectors.toList());

6.2 避免“空指针异常”

若子列表可能为空（如 fromIndex == toIndex），需提前处理：

List<Item> sub = list.subList(start, end);  
if (!sub.isEmpty()) {  
    // 安全操作  
}

七、结论

Java ArrayList subList() 方法 是一个功能强大且灵活的工具，但其“视图共享”的特性也要求开发者谨慎使用。通过理解底层原理、规避常见陷阱，并结合实际场景（如分页、局部排序），开发者可以显著提升代码的简洁性和性能。掌握这一方法，不仅能解决日常开发中的常见问题，还能为更复杂的集合操作打下坚实基础。

希望本文能帮助读者从“会用”到“用好” subList() 方法，享受高效编程的乐趣！

最新发布

查看更多文章