Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła