CKTIS / Java
IllegalArgumentException — argumento inválido
IllegalArgumentException indica que um método recebeu um argumento ilegal ou inadequado. É uma exceção não verificada: o compilador não exige que seja capturada nem declarada com throws.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException significa que um argumento fornecido viola os requisitos de um método, por exemplo, quando um número está fora do intervalo permitido. Em contrapartida, IllegalStateException indica que uma operação foi invocada num estado ou num momento inadequado.
IllegalArgumentException herda de RuntimeException e, por isso, é uma exceção não verificada (unchecked). Não é necessário capturá-la nem incluí-la numa declaração throws. No entanto, isto não significa que se possa ignorar a violação do contrato do método.
A sintaxe habitual é throw new IllegalArgumentException("message");. O construtor que aceita um String define a mensagem, que pode ser obtida através de getMessage(). É preferível verificar os argumentos antes de produzir efeitos secundários e descrever na mensagem o requisito violado. Capture a exceção onde o problema possa ser tratado de forma adequada, em vez de o ocultar.
No exemplo, requirePercentage aceita valores de 0 a 100, inclusive. Devolve o argumento para 75 e lança explicitamente uma exceção para 101. O bloco catch apresenta a mensagem apenas para fins de demonstração. O âmbito da documentação é Java SE 21; a versão do ambiente de execução de produção não foi atestada.
Exemplos
public class Main {
static int requirePercentage(int value) {
if (value < 0 || value > 100) {
throw new IllegalArgumentException("value must be between 0 and 100");
}
return value;
}
public static void main(String[] args) {
System.out.println(requirePercentage(75));
try {
requirePercentage(101);
} catch (IllegalArgumentException e) {
System.out.println(e.getMessage());
}
}
}Resultado
75 value must be between 0 and 100
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.