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

CKTIS / Java

throws — declarar exceções

A palavra-chave throws na declaração de um método ou construtor especifica os tipos de exceção que podem sair do seu corpo. É especialmente importante para exceções verificadas: o código que chama tem de as tratar ou declarar que podem ser propagadas.

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

Sintaxe

throws ExceptionType1, ExceptionType2

throws é uma palavra-chave reservada. A cláusula surge depois da lista de parâmetros de um método ou construtor, antes do corpo ou do ponto e vírgula que termina a declaração. Separe os tipos por vírgulas; cada um tem de ser um subtipo de Throwable. Também são permitidas variáveis de tipo com limites adequados.

Se uma exceção verificada puder sair do corpo, a declaração tem de indicar o seu tipo ou um supertipo. O código que chama tem de capturar essa exceção com try/catch ou declará-la na sua própria cláusula throws. Os subtipos de RuntimeException e Error não são verificados: é permitido indicá-los, mas não é obrigatório.

Não confunda throws com throw: o primeiro declara uma possível propagação, enquanto o segundo lança efetivamente uma exceção. Uma cláusula throws não lança nem trata nada e não garante que ocorra uma exceção.

Ao redefinir um método (JLS §8.4.8.3), cada tipo de exceção verificada declarado tem de coincidir com um tipo da cláusula throws do método redefinido após o apagamento de tipos, ou ser um subtipo desse tipo. Caso contrário, ocorre um erro de compilação. Se a condição só for satisfeita após o apagamento, o compilador emite um aviso do tipo unchecked. Por exemplo, um método não genérico void run() throws Exception pode redefinir <E extends Exception> void run() throws E com esse aviso em vez de um erro: E passa a Exception após o apagamento, mas antes do apagamento Exception não é um subtipo de E.

No exemplo, check(false) lança a exceção verificada Exception, e main captura-a e apresenta a sua mensagem. O tipo geral Exception simplifica a demonstração; numa API real, prefira tipos específicos que descrevam as possíveis falhas.

Exemplos

public class ThrowsDemo {
    static void check(boolean valid) throws Exception {
        if (!valid) {
            throw new Exception("Invalid input");
        }
    }

    public static void main(String[] args) {
        try {
            check(false);
        } catch (Exception e) {
            System.out.println(e.getMessage());
        }
    }
}

Resultado

Invalid input

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