CKTIS / Java
IllegalArgumentException — ongeldig argument
IllegalArgumentException geeft aan dat een methode een ongeldig of ongeschikt argument heeft ontvangen. Het is een ongecontroleerde uitzondering: de compiler verplicht aanroepers niet om deze af te handelen of met throws te declareren.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException betekent dat een opgegeven argument niet voldoet aan de vereisten van een methode, bijvoorbeeld wanneer een getal buiten het toegestane bereik valt. IllegalStateException geeft daarentegen aan dat een bewerking in een ongeschikte toestand of op een ongeschikt moment is aangeroepen.
IllegalArgumentException is een subklasse van RuntimeException en is daarom een ongecontroleerde uitzondering (unchecked). Je hoeft deze niet af te handelen of in een throws-declaratie op te nemen. Dat betekent echter niet dat je de schending van het methodecontract kunt negeren.
De gebruikelijke syntax is throw new IllegalArgumentException("message");. De constructor die een String accepteert, stelt het bericht in dat je met getMessage() kunt ophalen. Controleer argumenten bij voorkeur voordat je neveneffecten veroorzaakt en beschrijf in het bericht aan welke eis niet is voldaan. Handel de uitzondering af op een plek waar het probleem zinvol kan worden opgelost, in plaats van het te verbergen.
In het voorbeeld accepteert requirePercentage waarden van 0 tot en met 100. Bij 75 retourneert de methode het argument; bij 101 werpt ze expliciet een uitzondering. Het catch-blok toont het bericht alleen ter demonstratie. De documentatie heeft betrekking op Java SE 21; de versie van de productieomgeving is niet bevestigd.
Voorbeelden
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());
}
}
}Resultaat
75 value must be between 0 and 100
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.