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.