CKTIS / Java
Objects.equals: confrontare titoli che possono essere null
Confronta i titoli anche se uno dei due manca e verifica separatamente che il titolo sia presente prima di generare un’etichetta.
Versione: Java SE 21
Sintassi
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) è un metodo statico di java.util.Objects che accetta due argomenti di tipo Object e restituisce un boolean. Se entrambi gli argomenti sono null, restituisce true. Se solo uno è null, il risultato è false, purché equals rispetti il proprio contratto. Se entrambi i riferimenti indicano lo stesso oggetto, il risultato è true; l’implementazione del JDK 21 lo restituisce senza chiamare a.equals(b). Per due riferimenti distinti non null, il risultato è determinato da a.equals(b).
Per gli oggetti String, l’uguaglianza indica che la sequenza di caratteri è la stessa. Invece ==, applicato ai riferimenti, verifica se indicano lo stesso oggetto o se sono entrambi null. Objects.equals non confronta gli elementi degli array: usa Objects.deepEquals per un confronto in profondità. Il metodo non corregge un’implementazione difettosa di equals e non intercetta le eccezioni che questa lancia.
Due titoli mancanti possono risultare uguali, ma true non dimostra che sia presente un titolo. Se l’etichetta richiede un titolo, usa Objects.requireNonNull(title, "title is required") prima di chiamare strip(). Se il titolo manca, il controllo lancia una NullPointerException con quel messaggio. Non rifiuta le stringhe vuote o composte soltanto da caratteri di spaziatura.
Esempi
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());
}
}
}Risultato
true false true false Title: Atlas title is required
Due oggetti `String` distinti che contengono `Atlas` sono uguali con `Objects.equals`, ma non con `==`. Due titoli mancanti risultano uguali, ma `label` rifiuta un titolo mancante; l’esempio intercetta l’eccezione e ne stampa il messaggio.
Lezioni correlate
- Java · Lezione 18 · Avanzato · Versione: 2
Fonti
- Java SE 21 API — Objects.equals(Object, Object)
- Java SE 21 API — Object.equals(Object)
- Java SE 21 API — String.equals(Object)
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=
- Java SE 21 API — Objects.deepEquals(Object, Object)
- Java SE 21 API — Objects.requireNonNull(T, String)