CKTIS / Java
A cláusula catch
A cláusula catch: Uma cláusula catch trata uma exceção lançada pelo try associado quando o tipo em runtime é atribuível ao tipo declarado do parâmetro catch.
Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime
Sintaxe
catchUma cláusula catch trata uma exceção lançada pelo try associado quando o tipo em runtime é atribuível ao tipo declarado do parâmetro catch.
Captura a exceção mais restrita que possas tratar com sentido, adiciona contexto ou restaura a interrupção e deixa propagar falhas não tratadas.
Um catch mais amplo não pode preceder outro restrito, um catch vazio esconde falhas e Exception não inclui Error nem outros ramos de Throwable.
Multi-catch separa alternativas com | e dá um parâmetro effectively final; try-with-resources anexa a falha de close como suppressed à exceção do corpo.
O primeiro catch imprime number; o segundo preserva primary=body e lê a falha de fecho como suppressed=close.
Exemplos
import java.io.IOException;
public class Main {
static final class Broken implements AutoCloseable { public void close() throws IOException {throw new IOException("close");} }
public static void main(String[] args){
try { Integer.parseInt("x"); } catch(NumberFormatException ex){System.out.println("number");}
try(var ignored=new Broken()){throw new IllegalStateException("body");}catch(Exception ex){System.out.println("primary="+ex.getMessage());System.out.println("suppressed="+ex.getSuppressed()[0].getMessage());}
}
}
Resultado
number primary=body suppressed=close
O primeiro catch imprime number; o segundo preserva primary=body e lê a falha de fecho como suppressed=close.