CKTIS / Java
Objects.equals : comparer des objets en présence de null
Utilisez `Objects.equals(a, b)` pour comparer des objets selon leurs règles d’égalité `equals`, même si l’un des arguments ou les deux peuvent valoir `null`.
Version : Java SE 21
Syntaxe
import java.util.Objects;
// Java SE 21 API signature: public static boolean equals(Object a, Object b)
boolean equal = Objects.equals(a, b);Objects.equals(a, b) est une méthode statique de java.util.Objects qui renvoie un boolean. Dans OpenJDK 21, si a == b, la méthode renvoie immédiatement true sans appeler a.equals(b). C’est le cas si les deux références désignent le même objet ou si les deux arguments valent null. Si a == b vaut false, la méthode renvoie false lorsque a vaut null ; sinon, elle appelle a.equals(b) et en renvoie le résultat. Lors de cet appel, le contrat de equals impose un résultat de false lorsque b vaut null. Contrairement à un appel direct à a.equals(b), cette méthode ne déclenche pas de NullPointerException simplement parce que a vaut null.
Pour deux références, == vaut true si elles désignent le même objet ou si elles valent toutes les deux null. L’opérateur ne compare pas le contenu. Lorsque Objects.equals appelle a.equals(b), elle applique la règle d’égalité définie par la classe de a. Par exemple, String.equals compare des suites de caractères, tandis que l’implémentation héritée de Object.equals ne vérifie que l’identité des objets.
Si a.equals(b) est appelée, Objects.equals ne corrige pas une implémentation défectueuse de equals et n’intercepte pas les exceptions qu’elle déclenche. Objects.equals ne compare pas les éléments des tableaux ; utilisez Objects.deepEquals(a, b) pour comparer leur contenu, y compris celui des tableaux imbriqués.
Exemples
import java.util.Objects;
public class Main {
public static void main(String[] args) {
String a = "Java";
String b = new String(a);
System.out.println(Objects.equals(a, b));
System.out.println(a == b);
System.out.println(Objects.equals(null, null));
System.out.println(Objects.equals(null, b));
System.out.println(Objects.equals(a, null));
}
}Résultat
true false true false false
`new String(a)` crée un objet `String` distinct contenant le même texte. Ainsi, `Objects.equals(a, b)` vaut `true`, tandis que `a == b` vaut `false`. Les trois dernières lignes montrent le résultat avec deux arguments `null`, puis avec un seul `null` dans chacune des deux positions.
Leçons associées
- Java · Leçon 28 · Intermédiaire · Version : 2