CKTIS / Java
Objects.equals: comparar títulos que podem ser null
Compara títulos mesmo quando falta um deles e verifica separadamente se existe um título antes de gerar uma etiqueta.
Versão: Java SE 21
Sintaxe
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) é um método estático de java.util.Objects que recebe dois argumentos do tipo Object e devolve um boolean. Se ambos os argumentos forem null, devolve true. Se apenas um for null, o resultado é false, desde que equals respeite o seu contrato. Se ambas as referências apontarem para o mesmo objeto, o resultado é true; a implementação do JDK 21 devolve esse resultado sem chamar a.equals(b). Para duas referências distintas que não são null, o resultado é determinado por a.equals(b).
Para objetos String, a igualdade significa que a sequência de caracteres é a mesma. Já ==, quando aplicado a referências, verifica se apontam para o mesmo objeto ou se ambas são null. Objects.equals não compara os elementos de arrays; usa Objects.deepEquals para uma comparação em profundidade. O método não corrige uma implementação defeituosa de equals nem interceta exceções lançadas por essa implementação.
Dois títulos em falta podem ser considerados iguais, mas true não prova que existe um título. Se a etiqueta exigir um título, usa Objects.requireNonNull(title, "title is required") antes de chamar strip(). Se o título estiver em falta, a verificação lança uma NullPointerException com essa mensagem. Não rejeita cadeias de caracteres vazias nem compostas apenas por espaços em branco.
Exemplos
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());
}
}
}Resultado
true false true false Title: Atlas title is required
Dois objetos `String` distintos que contêm `Atlas` são iguais com `Objects.equals`, mas não com `==`. Dois títulos em falta são considerados iguais, mas `label` rejeita um título em falta; o exemplo interceta a exceção e apresenta a respetiva mensagem.
Lições relacionadas
- Java · Lição 18 · Avançado · Versão: 2
Fontes
- 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)