Module  java.base
软件包  java.util

Class ConcurrentModificationException

  • All Implemented Interfaces:
    Serializable
    已知直接子类:
    DirectoryIteratorException


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

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

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

    请注意,故障快速行为无法保证,因为一般来说,在不同步并发修改的情况下,无法做出任何硬性保证。 失败快速的操作ConcurrentModificationException抛出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()方法保存供以后检索)。 (A null值是允许的,表示原因不存在或未知。)
        从以下版本开始:
        1.7
      • ConcurrentModificationException

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

        请注意,与cause相关联的详细消息不会自动并入此异常的详细消息。

        参数
        message - 详细信息(保存以供 Throwable.getMessage()方法稍后检索)。
        cause - 原因(由Throwable.getCause()方法保存供以后检索)。 (A null值是允许的,并且表示原因不存在或未知。)
        从以下版本开始:
        1.7