Java集合遍历与过滤：从传统循环到Stream API实践

1. 为什么需要遍历List并返回匹配集合？

在Java开发中，遍历List并筛选出符合条件的元素是最基础但高频的操作之一。想象你正在处理一个包含1000个用户对象的List，需要找出所有VIP用户——这就是典型的集合过滤场景。这种需求在数据处理、业务逻辑实现和API响应构建中无处不在。

Java 8之前，开发者通常需要手动编写for循环配合if条件判断来实现过滤。这种方式虽然直接，但随着业务复杂度提升，代码会变得冗长且难以维护。更糟的是，在多线程环境下手动操作集合容易引发并发修改异常(ConcurrentModificationException)。

2. 基础实现方案对比

2.1 传统for循环方式

最基础的实现是使用for循环遍历+条件判断：

java复制List<User> vipUsers = new ArrayList<>();
for (User user : userList) {
    if (user.isVip()) {
        vipUsers.add(user);
    }
}

这种写法的优点是：

• 兼容所有Java版本
• 逻辑直观，适合初学者理解
• 调试时可以单步跟踪每个元素

但存在明显缺陷：

• 需要手动创建结果集合
• 代码行数较多
• 在多线程环境下需要额外同步处理

2.2 迭代器(Iterator)方式

使用Iterator可以避免并发修改问题：

java复制List<User> vipUsers = new ArrayList<>();
Iterator<User> iterator = userList.iterator();
while (iterator.hasNext()) {
    User user = iterator.next();
    if (user.isVip()) {
        vipUsers.add(user);
    }
}

注意：虽然Iterator解决了并发修改异常，但代码复杂度反而增加了。除非确实需要边遍历边删除元素，否则不建议优先采用这种方式。

2.3 Java 8的Stream API

现代Java项目中最优雅的解决方案是使用Stream：

java复制List<User> vipUsers = userList.stream()
    .filter(User::isVip)
    .collect(Collectors.toList());

这种写法的优势非常明显：

• 代码简洁，表达性强
• 天然支持并行处理(parallelStream)
• 可以链式调用其他操作(map/sorted等)
• 延迟执行特性提高性能

3. 性能对比与选型建议

我通过JMH对上述三种方式进行了基准测试(处理100万条数据)：

从测试结果可以看出：

1. 小数据量(<1万)时性能差异可以忽略，应优先考虑代码可读性
2. 大数据量时parallelStream有明显优势
3. 内存消耗差异在实际应用中通常不是关键因素

实际项目中我的经验法则是：除非在明确的热点代码路径上，否则优先使用Stream API。它的可读性和维护性优势远大于微小的性能差异。

4. 高级应用场景

4.1 多条件复杂过滤

当需要多个条件组合过滤时，Stream的优势更加明显：

java复制List<User> result = userList.stream()
    .filter(user -> user.isVip() 
        && user.getAge() > 18 
        && !user.isBanned())
    .collect(Collectors.toList());

可以轻松扩展条件而不破坏代码结构。

4.2 并行处理优化

对于CPU密集型的过滤操作，可以轻松切换到并行流：

java复制List<User> result = userList.parallelStream()
    .filter(this::computeIntensivePredicate)
    .collect(Collectors.toList());

但要注意：

• 并行化有额外开销，数据量小时可能适得其反
• 确保谓词(predicate)是线程安全的
• 避免在parallelStream中使用有状态的操作

4.3 与其他Stream操作组合

过滤常与其他操作链式调用：

java复制Map<Integer, List<String>> result = userList.stream()
    .filter(User::isActive)
    .sorted(comparing(User::getJoinDate))
    .collect(groupingBy(
        User::getDepartmentId,
        mapping(User::getName, toList())
    ));

这种声明式的风格让复杂的数据处理变得清晰可读。

5. 常见陷阱与最佳实践

5.1 空指针问题

当List本身可能为null时：

java复制List<User> result = Optional.ofNullable(userList)
    .orElseGet(Collections::emptyList)
    .stream()
    .filter(Objects::nonNull)
    .filter(User::isVip)
    .collect(Collectors.toList());

双重防御：既处理List为null的情况，又过滤掉元素中的null。

5.2 性能优化技巧

1. 预分配集合大小：如果知道大致匹配数量，可以优化ArrayList初始容量

java复制List<User> result = userList.stream()
    .filter(User::isVip)
    .collect(Collectors.toCollection(
        () -> new ArrayList<>(userList.size() / 2) // 预估50%匹配
    ));

2. 短路操作：当只需要前N个匹配项时使用limit

java复制List<User> result = userList.stream()
    .filter(User::isVip)
    .limit(10) // 只要前10个
    .collect(Collectors.toList());

3. 避免重复计算：复杂的谓词可以先计算再过滤

java复制Map<User, Boolean> precomputed = userList.stream()
    .collect(Collectors.toMap(
        Function.identity(),
        this::computeComplexPredicate
    ));

List<User> result = userList.stream()
    .filter(precomputed::get)
    .collect(Collectors.toList());

5.3 不可变集合

当需要返回不可变集合时：

java复制List<User> result = userList.stream()
    .filter(User::isVip)
    .collect(Collectors.collectingAndThen(
        Collectors.toList(),
        Collections::unmodifiableList
    ));

这可以防止调用方意外修改集合内容。

6. 扩展思考：何时不该使用Stream

虽然Stream API很强大，但有些场景传统方式更合适：

1. 需要直接操作索引时：

java复制for (int i = 0; i < list.size(); i++) {
    if (list.get(i).isVip()) {
        processIndex(i); // 需要索引位置
    }
}

2. 需要在遍历过程中修改原集合时：

java复制for (Iterator<User> it = list.iterator(); it.hasNext();) {
    User user = it.next();
    if (shouldRemove(user)) {
        it.remove(); // 直接删除元素
    }
}

3. 非常简单的条件判断：

java复制// 只是检查是否存在VIP用户
for (User user : userList) {
    if (user.isVip()) {
        return true;
    }
}
// 比 userList.stream().anyMatch(User::isVip) 更直观

在实际项目中，我通常会根据代码的上下文和团队习惯来选择合适的实现方式。对于复杂的业务逻辑处理链，Stream API的表达能力无可替代；而对于简单的遍历检查，传统for循环可能更直白。