ExpertiDict

Java · Essencial · Inglês · Técnico

checked exception

/tʃɛkt ɪkˈsɛpʃən/substantivo

Exceção que o compilador obriga a tratar com catch ou a declarar com throws, como IOException. Representa falhas esperadas e recuperáveis.

Onde usar

Aparece no erro 'unreported exception X; must be caught or declared to be thrown'. Em lambdas costuma atrapalhar.

Em código

void ler() throws IOException {
  Files.readString(Path.of("a.txt"));
}
try {
  ler();
} catch (IOException e) {
  System.err.println(e.getMessage());
}

Exemplos

IOException is a checked exception, so you must handle it.

IOException é uma checked exception, então você precisa tratá-la.

Wrap the checked exception in a runtime exception.

Embrulhe a checked exception numa exceção de runtime.

Cuidado

Não confunda com RuntimeException, que não exige tratamento. Capturar a checked e ignorá-la é pior do que propagá-la.

Sinônimos

exceção verificada

Antônimos

unchecked exception

Veja também

Todos os termos de Java