Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

IllegalArgumentException – neplatný argument

IllegalArgumentException signalizuje, že metóda dostala nepovolený alebo nevhodný argument. Je to nekontrolovaná výnimka: kompilátor nevyžaduje, aby ju volajúci zachytili alebo deklarovali pomocou throws.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

throw new IllegalArgumentException("message");

java.lang.IllegalArgumentException znamená, že odovzdaný argument porušuje požiadavky metódy, napríklad keď je číslo mimo povoleného rozsahu. Na rozdiel od nej IllegalStateException signalizuje, že operácia bola vyvolaná v nevhodnom stave alebo v nevhodnom čase.

IllegalArgumentException dedí z RuntimeException, a preto je nekontrolovanou výnimkou (unchecked). Nie je potrebné ju zachytiť ani uviesť v deklarácii throws. To však neznamená, že možno ignorovať porušenie zmluvy metódy.

Bežná syntax je throw new IllegalArgumentException("message");. Konštruktor prijímajúci String nastaví správu, ktorú možno získať pomocou getMessage(). Argumenty je vhodné kontrolovať pred vykonaním vedľajších účinkov a v správe opísať porušenú požiadavku. Výnimku zachyťte tam, kde sa problém dá zmysluplne vyriešiť, namiesto jeho skrývania.

V príklade requirePercentage prijíma hodnoty od 0 do 100 vrátane. Pre 75 vráti argument a pre 101 výslovne vyvolá výnimku. Blok catch vypíše správu iba na ukážku. Dokumentácia sa týka Java SE 21; verzia produkčného runtime prostredia nebola potvrdená.

Prí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ýsledok

75
value must be between 0 and 100

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje