Java · Essencial · Inglês · Técnico
checked exception
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