CKTIS / Java
IllegalArgumentException – ungültiges Argument
IllegalArgumentException signalisiert, dass eine Methode ein unzulässiges oder ungeeignetes Argument erhalten hat. Es handelt sich um eine ungeprüfte Ausnahme: Der Compiler verlangt weder, dass sie abgefangen wird, noch, dass sie mit throws deklariert wird.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException bedeutet, dass ein übergebenes Argument die Anforderungen einer Methode verletzt, zum Beispiel wenn eine Zahl außerhalb des zulässigen Bereichs liegt. Im Gegensatz dazu signalisiert IllegalStateException, dass ein Vorgang in einem ungeeigneten Zustand oder zu einem ungeeigneten Zeitpunkt aufgerufen wurde.
IllegalArgumentException erbt von RuntimeException und ist daher eine ungeprüfte Ausnahme (unchecked). Sie muss weder abgefangen noch in einer throws-Deklaration aufgeführt werden. Das bedeutet jedoch nicht, dass der verletzte Methodenvertrag ignoriert werden kann.
Die übliche Syntax lautet throw new IllegalArgumentException("message");. Der Konstruktor, der einen String annimmt, legt die Nachricht fest, die über getMessage() abgerufen wird. Prüfe Argumente möglichst, bevor Nebenwirkungen ausgeführt werden, und beschreibe in der Nachricht die verletzte Anforderung. Fange die Ausnahme dort ab, wo sich das Problem sinnvoll behandeln lässt, statt es zu verbergen.
Im Beispiel akzeptiert requirePercentage Werte von einschließlich 0 bis 100. Bei 75 gibt die Methode das Argument zurück, bei 101 löst sie ausdrücklich eine Ausnahme aus. Der catch-Block gibt die Nachricht nur zu Demonstrationszwecken aus. Der Dokumentationsumfang ist Java SE 21; die Version der Produktionslaufzeit wurde nicht bestätigt.
Beispiele
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());
}
}
}Ergebnis
75 value must be between 0 and 100
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.