java.util

クラス ConcurrentModificationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

java.util.ConcurrentModificationException

すべての実装されたインタフェース:

Serializable

直系の既知のサブクラス:

DirectoryIteratorException

public class ConcurrentModificationException
extends RuntimeException

この例外は、オブジェクトの並行変更を検出したメソッドによって、そのような変更が許可されていない場合にスローされます。

たとえば、あるスレッドが Collection で繰り返し処理を行なっている間に、別のスレッドがその Collection を変更することは一般に許可されません。通常、そのような環境では、繰り返し処理の結果は保証されません。いくつかのイテレータ (Iterator) の実装 (JRE が提供するすべての一般的な目的のコレクションの実装の、イテレータの実装を含む) は、その動作が検出された場合にこの例外をスローすることを選択できます。この例外をスローするイテレータは、フェイルファストイテレータと呼ばれます。イテレータは、将来の予測できない時点において予測できない動作が発生する危険を回避するために、ただちにかつ手際よく例外をスローします。

この例外は、オブジェクトが別のスレッドによって並行して更新されていないことを必ずしも示しているわけではありません。単一のスレッドが、オブジェクトの規約に違反する一連のメソッドを発行した場合、オブジェクトはこの例外をスローします。たとえば、フェイルファストイテレータを持つコレクションの繰り返し処理を行いながら、スレッドがコレクションを直接修正する場合、イテレータはこの例外をスローします。

通常、非同期の並行変更がある場合、確かな保証を行うことは不可能なので、フェイルファストの動作を保証することはできません。フェイルファストオペレーションは最善努力原則に基づき、ConcurrentModificationException をスローします。したがって、正確を期すためにこの例外に依存するプログラムを書くことは誤りです。ConcurrentModificationException は、バグを検出するためにのみ使用してください。

導入されたバージョン:

1.2

関連項目:

Collection, Iterator, ListIterator, Vector, LinkedList, HashSet, Hashtable, TreeMap, AbstractList, 直列化された形式

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
ConcurrentModificationException() 詳細メッセージを指定しないで ConcurrentModificationException を構築します。
ConcurrentModificationException(String message) 指定された詳細メッセージを持つ ConcurrentModificationException を構築します。
ConcurrentModificationException(String message, Throwable cause) 指定された詳細メッセージおよび原因を使用して新規例外を構築します。
ConcurrentModificationException(Throwable cause) 指定された原因と詳細メッセージ ((cause==null ? null : cause.toString())) を持つ新しい例外を構築します (通常、クラスとcause の詳細メッセージを含みます)。

メソッドのサマリー

クラス java.lang.Throwable から継承されたメソッド

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

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