Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Objects.equals: confrontare oggetti gestendo null

Usa `Objects.equals(a, b)` per confrontare gli oggetti secondo le loro regole di uguaglianza, anche quando uno o entrambi gli argomenti possono essere `null`.

Versione: Java SE 21

Sintassi

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) è un metodo statico di java.util.Objects che restituisce un boolean. In OpenJDK 21, se a == b, il metodo restituisce true senza chiamare a.equals(b). Questo vale sia quando i due riferimenti puntano allo stesso oggetto, sia quando entrambi gli argomenti sono null. Se a == b vale false, il metodo restituisce false quando a è null; altrimenti chiama a.equals(b) e ne restituisce il risultato. Per questa chiamata, il contratto di equals richiede che il risultato sia false quando b è null. A differenza di una chiamata diretta a a.equals(b), il metodo non lancia una NullPointerException solo perché a è null.

Per due riferimenti, == restituisce true se entrambi puntano allo stesso oggetto oppure se sono entrambi null. Non confronta il contenuto. Quando Objects.equals chiama a.equals(b), applica la regola di uguaglianza definita dalla classe di a. Per esempio, String.equals confronta sequenze di caratteri, mentre l’implementazione ereditata di Object.equals verifica solo l’identità degli oggetti.

Se viene chiamato a.equals(b), Objects.equals non corregge un’implementazione errata di equals e non intercetta le eccezioni lanciate da tale implementazione. Objects.equals non confronta gli elementi degli array; usa Objects.deepEquals(a, b) per confrontare il contenuto degli array, anche se sono annidati.

Esempi

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));
    }
}

Risultato

true
false
true
false
false

`new String(a)` crea un oggetto `String` distinto con lo stesso testo. Perciò `Objects.equals(a, b)` restituisce `true`, mentre `a == b` restituisce `false`. Le ultime tre righe mostrano il risultato con due argomenti `null` e con un solo `null` in ciascuna delle due posizioni.

Lezioni correlate

  • Java · Lezione 28 · Intermedio · Versione: 2

Fonti