模块  java.base
软件包  java.util

Class ConcurrentModificationException

  • 实现的所有接口
    Serializable
    已知直接子类：
    DirectoryIteratorException 
    public class ConcurrentModificationException
extends RuntimeException
    当不允许这样的修改时，检测到对象的并发修改的方法可能抛出此异常。

    例如，一个线程通常不允许修改Collection，而另一个线程正在迭代它。 通常，在这些情况下，迭代的结果是不确定的。 如果检测到此行为，某些Iterator实现（包括JRE提供的所有通用集合实现的实现）可能会选择抛出此异常。 执行此操作的迭代器称为故障快速迭代器，因为它们快速且干净地失败，而不是在未来的未确定时间冒着任意的，非确定性行为的风险。

    请注意，此异常并不总是表示某个对象已被另一个线程同时修改。 如果单个线程发出违反对象合同的一系列方法调用，则该对象可能会抛出此异常。 例如，如果线程在使用失败快速迭代器迭代集合时直接修改集合，则迭代器将抛出此异常。

    请注意，无法保证快速失败的行为，因为一般来说，在存在不同步的并发修改时，不可能做出任何硬性保证。 失败快速操作会尽最大努力抛出ConcurrentModificationException 。 因此，编写一个依赖于此异常的程序以确保其正确性是错误的 ： ConcurrentModificationException应仅用于检测错误。

    从以下版本开始：
    1.2
    另请参见：
    Collection ， Iterator ， Spliterator ， ListIterator ， Vector ， LinkedList ， HashSet ， Hashtable ， TreeMap ， AbstractList ， Serialized Form

    • 构造方法详细信息

      • ConcurrentModificationException

        public ConcurrentModificationException()
        构造一个没有详细消息的ConcurrentModificationException。

      • ConcurrentModificationException

        public ConcurrentModificationException​(String message)
        使用指定的详细消息构造 ConcurrentModificationException 。
        参数
        message - 与此异常有关的详细消息。

      • ConcurrentModificationException

        public ConcurrentModificationException​(Throwable cause)
        构造具有指定的原因和详细消息的新异常 (cause==null ? null : cause.toString()) （它通常包含的类和详细消息 cause 。
        参数
        cause - 原因（保存以供以后通过Throwable.getCause()方法检索）。 （允许值为null ，表示原因不存在或未知。）
        从以下版本开始：
        1.7

      • ConcurrentModificationException

        public ConcurrentModificationException​(String message,
                                       Throwable cause)
        使用指定的详细消息和原因构造一个新的异常。

        请注意，与cause关联的详细消息不会自动合并到此异常的详细消息中。

        参数
        message - 详细消息（保存以供以后通过 Throwable.getMessage()方法检索）。
        cause - 原因（保存以供以后通过Throwable.getCause()方法检索）。 （允许值为null ，表示原因不存在或未知。）
        从以下版本开始：
        1.7