Module  java.base
软件包  java.util

Class ConcurrentModificationException

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

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

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

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

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

      • ConcurrentModificationException

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

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

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