Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

IllegalArgumentException – neveljaven argument

IllegalArgumentException sporoča, da je metoda prejela nedovoljen ali neustrezen argument. Gre za nenadzorovano izjemo: prevajalnik ne zahteva, da jo klicatelji prestrežejo ali deklarirajo z throws.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

throw new IllegalArgumentException("message");

java.lang.IllegalArgumentException pomeni, da podani argument krši zahteve metode, na primer če je število zunaj dovoljenega obsega. Nasprotno IllegalStateException sporoča, da je bila operacija priklicana v neustreznem stanju ali ob neustreznem času.

IllegalArgumentException deduje od RuntimeException in je zato nenadzorovana izjema (unchecked). Ni je treba prestreči ali vključiti v deklaracijo throws. To pa ne pomeni, da lahko prezremo kršitev pogodbe metode.

Običajna sintaksa je throw new IllegalArgumentException("message");. Konstruktor, ki sprejme String, nastavi sporočilo, ki ga pridobimo z getMessage(). Argumente je priporočljivo preveriti, preden pride do stranskih učinkov, in v sporočilu opisati kršeno zahtevo. Izjemo prestrezite tam, kjer je mogoče težavo smiselno obravnavati, namesto da jo prikrijete.

V primeru requirePercentage sprejema vrednosti od vključno 0 do 100. Za 75 vrne argument, za 101 pa izrecno sproži izjemo. Blok catch izpiše sporočilo samo za prikaz. Dokumentacija obravnava Java SE 21; različica produkcijskega izvajalnega okolja ni bila potrjena.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri