Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori