Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes