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.