在 Java 中从 for 循环中移出元素的原理及解决方案

在 Java 编程中，从集合中移除元素是常见操作。然而，直接在 for 循环中删除或移出元素往往会导致 ConcurrentModificationException（数组下标越界）。本文将详细解释这种情况发生的原因以及如何正确、安全地移出元素。

原理解释

Java 的集合框架如 ArrayList、HashSet 等在进行遍历时，通过创建一个迭代器来跟踪当前遍历的位置。这个迭代器会维护一个称为“修改计数器”（modCount）的变量，用于记录集合的结构性修改（例如添加或删除元素）。

在遍历过程中，如果集合的 modCount 与迭代器的 modCount 不一致，迭代器会检测到这一情况，并抛出 ConcurrentModificationException。这是一种快速失败机制，旨在防止在遍历时修改集合，避免可能的数据不一致和其他潜在问题。

错误示例

直接在 for-each 循环中删除元素会导致 ConcurrentModificationException。以下示例展示了这种情况：

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

public class RemoveElement {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("one");
        list.add("two");
        list.add("three");

        // 直接在for循环中移出元素，会抛出ConcurrentModificationException
        for (String item : list) {
            if (item.equals("two")) {
                list.remove(item); // 抛出异常
            }
        }
    }
}

运行上述代码会抛出 ConcurrentModificationException，因为在迭代时修改了集合。

解决方案

为了解决这个问题，有几种常用的方法可以安全地在循环中移除元素：

1. 使用 Iterator 的 remove 方法

使用 Iterator 的 remove 方法是推荐的方式，它可以安全地在遍历时移出元素。

import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;

public class RemoveElement {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("one");
        list.add("two");
        list.add("three");

        Iterator<String> iterator = list.iterator();
        while (iterator.hasNext()) {
            String item = iterator.next();
            if (item.equals("two")) {
                iterator.remove(); // 安全移除元素
            }
        }

        System.out.println(list); // 输出 [one, three]
    }
}

在上述代码中，Iterator 的 remove 方法确保在迭代过程中安全地移除元素。

2. 使用 ListIterator

对于 List 接口的实现，可以使用 ListIterator，它提供了 remove 方法，并且可以安全地在遍历时移出元素。

import java.util.ArrayList;
import java.util.List;
import java.util.ListIterator;

public class RemoveElement {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("one");
        list.add("two");
        list.add("three");

        ListIterator<String> iterator = list.listIterator();
        while (iterator.hasNext()) {
            String item = iterator.next();
            if (item.equals("two")) {
                iterator.remove(); // 安全移除元素
            }
        }

        System.out.println(list); // 输出 [one, three]
    }
}

3. 使用普通 for 循环（倒序遍历）

对于 ArrayList 这种随机访问列表，可以使用倒序遍历的普通 for 循环来避免问题。这种方式不会触发 ConcurrentModificationException，因为在倒序遍历时删除元素不会影响未遍历的元素。

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

public class RemoveElement {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("one");
        list.add("two");
        list.add("three");

        for (int i = list.size() - 1; i >= 0; i--) {
            if (list.get(i).equals("two")) {
                list.remove(i); // 安全移除元素
            }
        }

        System.out.println(list); // 输出 [one, three]
    }
}

4. 使用 Stream 的过滤操作

在 Java 8 及以上版本中，可以使用 Stream 的过滤操作来创建一个新的集合，不包含要移除的元素。

import java.util.ArrayList;
import java.util.List;
import java.util.stream.Collectors;

public class RemoveElement {
    public static void main(String[] args) {
        List<String> list = new ArrayList<>();
        list.add("one");
        list.add("two");
        list.add("three");

        list = list.stream()
                   .filter(item -> !item.equals("two"))
                   .collect(Collectors.toList()); // 过滤元素并收集到新的列表

        System.out.println(list); // 输出 [one, three]
    }
}