Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje