模块  java.base
软件包  java.util

Class ConcurrentModificationException

  • 实现的所有接口
    Serializable
    已知直接子类:
    DirectoryIteratorException

    public class ConcurrentModificationException
    extends RuntimeException
    当不允许这样的修改时,检测到对象的并发修改的方法可能抛出此异常。

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

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

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

    从以下版本开始:
    1.2
    另请参见:
    CollectionIteratorSpliteratorListIteratorVectorLinkedListHashSetHashtableTreeMapAbstractListSerialized 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