CKTIS / Java
java.util.Objects — validation, égalité et hachage
Découvrez Objects.requireNonNull, Objects.equals et Objects.hash : vérification de null, égalité de références pouvant être null et calcul d’un hachage à partir de champs.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);java.util.Objects fournit des méthodes utilitaires statiques. Portée de cette fiche : Java SE 21 ; l’environnement d’exécution du dépôt et celui de production n’ont pas été attestés.
Objects.requireNonNull(value, "value") renvoie la même référence ou lance une NullPointerException avec le message fourni. Cette méthode est utile pour valider les paramètres, mais ne vérifie pas, par exemple, si une chaîne est vide.
Objects.equals(a, b) renvoie true si les deux arguments valent null, et false si seul a vaut null. Si a n’est pas null, l’égalité est déterminée par la méthode equals du premier argument. Si a == b et que les deux références désignent le même objet, l’API de Java SE 21 ne garantit pas que l’appel à a.equals(b) soit omis. La méthode ne compare pas le contenu des tableaux.
Objects.hash(field1, field2) calcule le hachage d’une séquence comme Arrays.hashCode(Object[]). Lors de l’implémentation de hashCode(), utilisez des champs cohérents avec equals() : des objets égaux doivent avoir des hachages égaux, mais des collisions sont possibles. Pour un objet unique, Objects.hash(x) ne remplace pas Objects.hashCode(x).
Exemples
import java.util.Objects;
public class Main {
public static void main(String[] args) {
String name = Objects.requireNonNull("Ada", "name");
System.out.println(name);
System.out.println(Objects.equals(null, null));
System.out.println(Objects.equals(name, null));
System.out.println(Objects.hash(1, 2));
try {
Objects.requireNonNull(null, "name");
} catch (NullPointerException e) {
System.out.println(e.getMessage());
}
}
}Résultat
Ada true false 994 name
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.