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

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

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.

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.

Fontes