CKTIS / Java
IllegalArgumentException — argumento no válido
IllegalArgumentException indica que un método ha recibido un argumento ilegal o inadecuado. Es una excepción no comprobada: el compilador no exige que se capture ni que se declare con throws.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException significa que un argumento proporcionado incumple los requisitos de un método, por ejemplo, porque un número está fuera del intervalo permitido. En cambio, IllegalStateException indica que una operación se ha invocado en un estado o en un momento inadecuado.
IllegalArgumentException hereda de RuntimeException, por lo que es una excepción no comprobada (unchecked). No es necesario capturarla ni incluirla en una declaración throws. Sin embargo, esto no significa que se pueda ignorar el incumplimiento del contrato del método.
La sintaxis habitual es throw new IllegalArgumentException("message");. El constructor que acepta un String establece el mensaje, que se obtiene mediante getMessage(). Es preferible comprobar los argumentos antes de realizar efectos secundarios y describir en el mensaje el requisito incumplido. Captura la excepción allí donde el problema pueda gestionarse de forma útil, en lugar de ocultarlo.
En el ejemplo, requirePercentage acepta valores de 0 a 100, ambos incluidos. Devuelve el argumento para 75 y lanza explícitamente una excepción para 101. El bloque catch muestra el mensaje solo a modo de demostración. El ámbito de la documentación es Java SE 21; no se ha confirmado la versión del entorno de ejecución de producción.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.