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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.