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.