Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources