Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

IllegalArgumentException — argomento non valido

IllegalArgumentException segnala che un metodo ha ricevuto un argomento illegale o inappropriato. È un’eccezione non controllata: il compilatore non richiede di intercettarla né di dichiararla con throws.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

throw new IllegalArgumentException("message");

java.lang.IllegalArgumentException significa che un argomento fornito viola i requisiti di un metodo, per esempio perché un numero è fuori dall’intervallo consentito. Al contrario, IllegalStateException segnala che un’operazione è stata invocata in uno stato o in un momento inappropriato.

IllegalArgumentException estende RuntimeException ed è quindi un’eccezione non controllata (unchecked). Non è necessario intercettarla né inserirla in una dichiarazione throws. Questo, però, non significa che si possa ignorare la violazione del contratto del metodo.

La sintassi tipica è throw new IllegalArgumentException("message");. Il costruttore che accetta un String imposta il messaggio, recuperabile tramite getMessage(). È preferibile controllare gli argomenti prima di produrre effetti collaterali e descrivere nel messaggio il requisito violato. Intercetta l’eccezione nel punto in cui il problema può essere gestito in modo appropriato, invece di nasconderlo.

Nell’esempio, requirePercentage accetta valori da 0 a 100 inclusi. Restituisce l’argomento per 75 e lancia esplicitamente un’eccezione per 101. Il blocco catch stampa il messaggio solo a scopo dimostrativo. La documentazione riguarda Java SE 21; la versione dell’ambiente di esecuzione di produzione non è stata attestata.

Esempi

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());
        }
    }
}

Risultato

75
value must be between 0 and 100

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti