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, ExceptionType2throws é 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
- The Java Language Specification, Java SE 21, §3.9 Keywords
- The Java Language Specification, Java SE 21, §8.4.6 Method Throws
- The Java Language Specification, Java SE 21, §11.2 Compile-Time Checking of Exceptions
- The Java Language Specification, Java SE 21, §8.4.8.3 Requirements in Overriding and Hiding