Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

ConcurrentModificationException — modificação não permitida durante a iteração

ConcurrentModificationException assinala uma modificação detetada que o contrato de um objeto não permite. Pode ocorrer num único thread; não é um mecanismo de sincronização nem um detetor de erros garantido.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

java.util.ConcurrentModificationException
public class ConcurrentModificationException extends RuntimeException

ConcurrentModificationException, do pacote java.util, estende RuntimeException e é uma exceção não verificada. Assinala uma modificação detetada que o contrato de um objeto proíbe. O nome não significa que tenha de estar envolvido outro thread.

Um iterador fail-fast pode detetar uma alteração à coleção feita fora desse iterador. Em ArrayList, adicionar e remover elementos são alterações estruturais; substituir um valor com set não é. Durante a iteração, remove os elementos através de Iterator.remove() após uma chamada bem-sucedida a next(), no máximo uma vez por elemento.

A deteção funciona segundo o princípio do melhor esforço: a ausência da exceção não prova que o código esteja correto. Não bases a sincronização nem a lógica do programa na captura da exceção. Corrige a forma como a coleção é modificada; o catch do exemplo serve apenas para demonstração.

O exemplo invalida primeiro o iterador stale através de values.add(4) e, em seguida, chama stale.next(). Um novo iterador, current, remove em segurança os números pares. O resultado esperado é ConcurrentModificationException, seguido de [1, 3] numa linha separada.

Exemplos

import java.util.ArrayList;
import java.util.ConcurrentModificationException;
import java.util.List;

public class Main {
    public static void main(String[] args) {
        var values = new ArrayList<>(List.of(1, 2, 3));
        var stale = values.iterator();
        values.add(4);

        try {
            stale.next();
        } catch (ConcurrentModificationException ex) {
            System.out.println(ex.getClass().getSimpleName());
        }

        var current = values.iterator();
        while (current.hasNext()) {
            if (current.next() % 2 == 0) {
                current.remove();
            }
        }
        System.out.println(values);
    }
}

Resultado

ConcurrentModificationException
[1, 3]

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes