База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

IllegalArgumentException — невалиден аргумент

IllegalArgumentException сигнализира, че метод е получил недопустим или неподходящ аргумент. Това е непроверено изключение: компилаторът не изисква извикващият код да го прихваща или декларира с throws.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

throw new IllegalArgumentException("message");

java.lang.IllegalArgumentException означава, че подаден аргумент нарушава изискванията на даден метод, например когато число е извън разрешения диапазон. За разлика от него, IllegalStateException сигнализира, че операция е извикана в неподходящо състояние или в неподходящ момент.

IllegalArgumentException наследява RuntimeException и затова е непроверено изключение (unchecked). Не е необходимо да го прихващате или да го включвате в декларация throws. Това обаче не означава, че нарушаването на договора на метода може да бъде пренебрегнато.

Обичайният синтаксис е throw new IllegalArgumentException("message");. Конструкторът, който приема String, задава съобщението, достъпно чрез getMessage(). Препоръчително е аргументите да се проверяват преди извършване на странични ефекти и в съобщението да се описва нарушеното изискване. Прихванете изключението там, където проблемът може да бъде обработен смислено, вместо да го прикривате.

В примера requirePercentage приема стойности от 0 до 100 включително. За 75 връща аргумента, а за 101 изрично хвърля изключение. Блокът catch отпечатва съобщението само с демонстрационна цел. Документацията е за Java SE 21; версията на производствената среда за изпълнение не е потвърдена.

Примери

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());
        }
    }
}

Резултат

75
value must be between 0 and 100

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници