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

CKTIS / Java

throw — lançamento explícito de exceção

throw — lançamento explícito de exceção: A instrução throw avalia uma expressão Throwable e termina abruptamente, passando a exceção ao catch compatível mais próximo ou ao chamador.

Versão: Java SE 21 (JLS and Java SE API); examples verified on the repository Java runtime

Sintaxe

throw

A instrução throw avalia uma expressão Throwable e termina abruptamente, passando a exceção ao catch compatível mais próximo ou ao chamador.

Lança uma exceção de domínio específica com a causa se o contrato falhar; declara uma checked com throws ou trata-a.

Não uses exceções como fluxo normal, não percas a cause ao envolver nem captures amplamente apenas para relançar sem informação.

throw null causa NullPointerException; a instrução throw difere da cláusula throws e o precise rethrow pode estreitar um tipo checked.

O valor -2 aciona throw com negative:-2, catch imprime a mensagem e o valor válido 3 retorna normalmente.

Exemplos

public class Main {
    static int requireNonNegative(int value) {
        if (value < 0) throw new IllegalArgumentException("negative:" + value);
        return value;
    }

    public static void main(String[] args) {
        try {
            requireNonNegative(-2);
        } catch (IllegalArgumentException exception) {
            System.out.println(exception.getMessage());
        }
        System.out.println(requireNonNegative(3));
    }
}

Resultado

negative:-2
3

O valor -2 aciona throw com negative:-2, catch imprime a mensagem e o valor válido 3 retorna normalmente.

Fontes