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

CKTIS / Java

Objects.equals : comparer des titres qui peuvent être null

Comparez deux titres même lorsque l’un d’eux manque, puis vérifiez séparément la présence du titre avant de créer un libellé.

Version : Java SE 21

Syntaxe

import java.util.Objects;

// Declaration in java.util.Objects (Java SE 21):
public static boolean equals(Object a, Object b)

// Use in an expression or statement:
boolean equal = Objects.equals(a, b);

Objects.equals(a, b) est une méthode statique de java.util.Objects qui prend deux arguments de type Object et renvoie un boolean. Si les deux arguments sont null, elle renvoie true. Si un seul est null, le résultat est false, à condition que equals respecte son contrat. Si les deux références désignent le même objet, le résultat est true ; l’implémentation du JDK 21 le renvoie sans appeler a.equals(b). Pour deux références distinctes non null, le résultat vient de a.equals(b).

Pour des objets String, être égaux signifie contenir la même suite de caractères. Sur des références, == vérifie au contraire qu’elles désignent le même objet ou qu’elles valent toutes les deux null. Objects.equals ne compare pas les éléments des tableaux ; pour une comparaison en profondeur, utilisez Objects.deepEquals. La méthode ne corrige pas une implémentation défectueuse de equals et n’intercepte pas les exceptions qu’elle lève.

Deux titres absents peuvent être considérés comme égaux, mais true ne prouve pas qu’un titre est présent. Si le libellé exige un titre, appelez Objects.requireNonNull(title, "title is required") avant strip(). En l’absence de titre, ce contrôle lève une NullPointerException avec ce message. Il ne rejette pas les chaînes vides ni celles composées uniquement de caractères d’espacement.

Exemples

import java.util.Objects;

public class Main {
    private static String label(String title) {
        return "Title: " + Objects.requireNonNull(title, "title is required").strip();
    }

    public static void main(String[] args) {
        String title = "Atlas";
        String sameText = new String(title); // Deliberately distinct reference.
        String missing = null;

        System.out.println(Objects.equals(missing, null));
        System.out.println(Objects.equals(title, missing));
        System.out.println(Objects.equals(title, sameText));
        System.out.println(title == sameText);
        System.out.println(label(title));
        try {
            System.out.println(label(missing));
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Résultat

true
false
true
false
Title: Atlas
title is required

Deux objets `String` distincts contenant `Atlas` sont égaux avec `Objects.equals`, mais pas avec `==`. Deux titres absents sont égaux lors de la comparaison, mais `label` refuse un titre absent ; l’exemple intercepte l’exception et affiche son message.

Leçons associées

  • Java · Leçon 18 · Avancé · Version : 2

Sources