CKTIS / Java
IllegalArgumentException – neplatný argument
IllegalArgumentException signalizuje, že metoda obdržela nepovolený nebo nevhodný argument. Jde o nekontrolovanou výjimku: kompilátor nevyžaduje, aby ji volající zachytili nebo deklarovali pomocí throws.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException znamená, že předaný argument porušuje požadavky metody, například když je číslo mimo povolený rozsah. Naproti tomu IllegalStateException signalizuje, že operace byla vyvolána v nevhodném stavu nebo v nevhodnou dobu.
IllegalArgumentException dědí z RuntimeException, a je tedy nekontrolovanou výjimkou (unchecked). Není nutné ji zachytit ani uvádět v deklaraci throws. To však neznamená, že lze porušení smlouvy metody ignorovat.
Obvyklá syntaxe je throw new IllegalArgumentException("message");. Konstruktor přijímající String nastaví zprávu, kterou lze získat pomocí getMessage(). Argumenty je vhodné kontrolovat před provedením vedlejších účinků a ve zprávě popsat porušený požadavek. Výjimku zachyťte tam, kde lze problém smysluplně vyřešit, místo abyste ho skrývali.
V příkladu requirePercentage přijímá hodnoty od 0 do 100 včetně. Pro 75 vrátí argument a pro 101 výslovně vyvolá výjimku. Blok catch vypíše zprávu pouze pro demonstraci. Dokumentace se vztahuje k Java SE 21; verze produkčního běhového prostředí nebyla potvrzena.
Příklady
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());
}
}
}Výsledek
75 value must be between 0 and 100
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.