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

CKTIS / Java

Multi-catch: tratamento partilhado de exceções

A sintaxe `catch (A | B e)` permite tratar diferentes tipos de exceção num único bloco. Os tipos alternativos não podem ter uma relação de subtipo, e o parâmetro `e` é implicitamente final.

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

Sintaxe

try {
    // operation
} catch (A | B e) {
    // shared handler
}

catch (A | B e) disponibiliza um único gestor para exceções do tipo A ou B, incluindo os respetivos subtipos. | separa as alternativas; aqui, não é um operador bit a bit. e representa uma exceção capturada, não uma coleção.

As alternativas têm de ser classes de exceção e não podem ser subtipos umas das outras. Assim, catch (Exception | RuntimeException e) é um erro de compilação.

O parâmetro e é implicitamente final: não lhe pode ser atribuído outro valor. O seu tipo declarado é o limite superior mínimo (lub) dos tipos alternativos, que determina os membros disponíveis.

O exemplo percorre ambos os casos e espera A e, em seguida, B. Use um gestor partilhado quando o tratamento for idêntico; caso contrário, use cláusulas catch separadas.

Exemplos

public class MultiCatchDemo {
    static class A extends Exception {}
    static class B extends Exception {}

    static void fail(boolean first) throws A, B {
        if (first) {
            throw new A();
        }
        throw new B();
    }

    public static void main(String[] args) {
        for (boolean first : new boolean[] {true, false}) {
            try {
                fail(first);
            } catch (A | B e) {
                System.out.println(e.getClass().getSimpleName());
            }
        }
    }
}

Resultado

A
B

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