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