CKTIS / Java
IllegalArgumentException – nevažeći argument
IllegalArgumentException označava da je metoda primila nedopušten ili neprikladan argument. To je nekontrolirana iznimka: prevoditelj ne zahtijeva da je pozivatelji uhvate ili deklariraju pomoću throws.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException znači da predani argument krši zahtjeve metode, primjerice kada je broj izvan dopuštenog raspona. Nasuprot tome, IllegalStateException označava da je operacija pozvana u neprikladnom stanju ili u neprikladnom trenutku.
IllegalArgumentException nasljeđuje RuntimeException i zato je nekontrolirana iznimka (unchecked). Ne morate je uhvatiti niti navesti u deklaraciji throws. To, međutim, ne znači da se kršenje ugovora metode može zanemariti.
Uobičajena sintaksa je throw new IllegalArgumentException("message");. Konstruktor koji prima String postavlja poruku, dostupnu putem getMessage(). Preporučuje se provjeriti argumente prije izvođenja nuspojava i u poruci opisati prekršeni zahtjev. Uhvatite iznimku ondje gdje se problem može smisleno riješiti, umjesto da ga prikrivate.
U primjeru requirePercentage prihvaća vrijednosti od 0 do uključivo 100. Za 75 vraća argument, a za 101 izričito izbacuje iznimku. Blok catch ispisuje poruku samo radi demonstracije. Dokumentacija se odnosi na Java SE 21; verzija produkcijskog okruženja za izvođenje nije potvrđena.
Primjeri
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());
}
}
}Rezultat
75 value must be between 0 and 100
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.