CKTIS / Java
IllegalArgumentException — argument invalide
IllegalArgumentException indique qu’une méthode a reçu un argument illégal ou inapproprié. C’est une exception non vérifiée : le compilateur n’oblige pas les appelants à la capturer ni à la déclarer avec throws.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
throw new IllegalArgumentException("message");java.lang.IllegalArgumentException signifie qu’un argument fourni ne respecte pas les exigences d’une méthode, par exemple lorsqu’un nombre est en dehors de la plage autorisée. À l’inverse, IllegalStateException indique qu’une opération a été appelée dans un état ou à un moment inapproprié.
IllegalArgumentException hérite de RuntimeException et constitue donc une exception non vérifiée (unchecked). Il n’est pas nécessaire de la capturer ni de l’inclure dans une déclaration throws. Cela ne signifie pas pour autant que la violation du contrat de la méthode peut être ignorée.
La syntaxe courante est throw new IllegalArgumentException("message");. Le constructeur qui accepte un String définit le message récupéré avec getMessage(). Il est préférable de vérifier les arguments avant de produire des effets de bord et de décrire dans le message l’exigence qui n’est pas respectée. Capturez l’exception là où le problème peut être traité de façon pertinente, plutôt que de le masquer.
Dans l’exemple, requirePercentage accepte les valeurs de 0 à 100 inclus. Elle renvoie l’argument pour 75 et lance explicitement une exception pour 101. Le bloc catch affiche le message uniquement à titre de démonstration. La documentation porte sur Java SE 21 ; la version de l’environnement d’exécution en production n’a pas été attestée.
Exemples
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());
}
}
}Résultat
75 value must be between 0 and 100
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.