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

CKTIS / Java

Comparer des objets Integer : valeurs, références et null

Distinguez l’identité des objets de l’égalité des valeurs. Voyez quand `==` convertit un `Integer` en `int` et comment comparer des valeurs qui peuvent être `null`.

Version : Java SE 21

Syntaxe

Instance methods on java.lang.Integer: boolean equals(Object obj); int intValue(). Static method on java.util.Objects: static boolean equals(Object a, Object b). With Integer a and b and int n: a == b compares references; a == n unboxes a and compares values.

Quand les deux opérandes sont de type Integer, == compare les références. Il renvoie true si elles désignent le même objet ou si elles valent toutes les deux null. Deux objets distincts peuvent contenir le même int. Integer.valueOf(int) met en cache les valeurs de −128 à 127 inclus et peut en mettre d’autres en cache. N’utilisez pas == pour comparer les valeurs de deux objets Integer.

La méthode d’instance Integer.equals(Object) renvoie true uniquement si l’argument est un Integer qui contient le même int. Elle renvoie false pour un argument null ou un Long de même valeur numérique. Appeler la méthode sur une référence null déclenche une NullPointerException.

Integer.intValue() renvoie la valeur primitive int. Quand == compare un Integer à un int, Java déballe automatiquement l’Integer et compare les valeurs numériques. Appeler intValue() sur une référence null ou déballer automatiquement null déclenche une NullPointerException.

La méthode statique java.util.Objects.equals(Object, Object) renvoie true pour deux arguments null. Pour deux arguments de type Integer, elle renvoie false si un seul vaut null ; si aucun ne vaut null, elle applique la règle d’égalité des valeurs d’Integer. Utilisez cette méthode si l’une ou l’autre des références peut valoir null.

Exemples

import java.util.Objects;

public class IntegerComparison {
    @SuppressWarnings("removal") // Fresh objects for this demonstration only.
    public static void main(String[] args) {
        Integer a = new Integer(42);
        Integer b = new Integer(42);
        Integer missing = null;

        System.out.println("same reference: " + (a == b));
        System.out.println("Integer.equals: " + a.equals(b));
        System.out.println("Integer vs Long: " + a.equals(Long.valueOf(42L)));
        System.out.println("intValue comparison: " + (a.intValue() == b.intValue()));
        System.out.println("Integer vs int: " + (a == 42));
        System.out.println("Objects.equals, same value: " + Objects.equals(a, b));
        System.out.println("Objects.equals, one null: " + Objects.equals(a, missing));
        System.out.println("Objects.equals, both null: " + Objects.equals(missing, null));

        try {
            System.out.println(missing == 42);
        } catch (NullPointerException e) {
            System.out.println("null unboxing: NullPointerException");
        }
    }
}

Résultat

same reference: false
Integer.equals: true
Integer vs Long: false
intValue comparison: true
Integer vs int: true
Objects.equals, same value: true
Objects.equals, one null: false
Objects.equals, both null: true
null unboxing: NullPointerException

Les deux appels à `new Integer(42)` créent volontairement des objets distincts de même valeur, indépendamment du cache. Le constructeur est obsolète et destiné à être supprimé ; il sert uniquement à la démonstration. En pratique, utilisez le boxing automatique ou `Integer.valueOf(int)`. Le dernier bloc `catch` montre ce qui arrive quand on déballe `null`.

Leçons associées

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

Sources