CKTIS / Java
IllegalArgumentException — nieprawidłowy argument
IllegalArgumentException sygnalizuje, że metoda otrzymała niedozwolony lub nieodpowiedni argument. Jest wyjątkiem niekontrolowanym: kompilator nie wymaga jego przechwycenia ani deklaracji throws.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException oznacza, że przekazany argument narusza wymagania metody, na przykład liczba nie mieści się w dopuszczalnym zakresie. W odróżnieniu od niego IllegalStateException sygnalizuje wywołanie operacji w nieodpowiednim stanie lub momencie.
IllegalArgumentException dziedziczy po RuntimeException, więc jest wyjątkiem niekontrolowanym (unchecked). Nie trzeba go przechwytywać ani umieszczać w deklaracji throws. Nie oznacza to jednak, że można ignorować naruszony kontrakt metody.
Typowy zapis to throw new IllegalArgumentException("message");. Konstruktor przyjmujący String ustawia komunikat dostępny przez getMessage(). Warto sprawdzać argumenty przed wykonaniem skutków ubocznych i opisywać w komunikacie naruszone wymaganie. Przechwytuj wyjątek tam, gdzie można sensownie obsłużyć problem, zamiast go ukrywać.
W przykładzie requirePercentage dopuszcza wartości od 0 do 100 włącznie. Dla 75 zwraca argument, a dla 101 jawnie rzuca wyjątek. Blok catch wypisuje komunikat wyłącznie w celach demonstracyjnych. Zakres dokumentacji to Java SE 21; wersja środowiska produkcyjnego nie została potwierdzona.
Przykłady
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());
}
}
}Wynik
75 value must be between 0 and 100
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.