CKTIS / Java
Objects.equals: comparar objetos com suporte para null
Usa `Objects.equals(a, b)` para comparar objetos segundo as regras de igualdade de `equals`, mesmo que um ou ambos os argumentos possam ser `null`.
Versão: Java SE 21
Sintaxe
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) é um método estático de java.util.Objects que devolve um boolean. No OpenJDK 21, se a == b, o método devolve true sem chamar a.equals(b). Isto acontece quando as duas referências apontam para o mesmo objeto ou quando ambos os argumentos são null. Se a == b der false, o método devolve false quando a é null; caso contrário, chama a.equals(b) e devolve o seu resultado. Nessa chamada, o contrato de equals exige que o resultado seja false quando b é null. Ao contrário de uma chamada direta a a.equals(b), o método não lança uma NullPointerException só porque a é null.
Para duas referências, == dá true quando ambas apontam para o mesmo objeto ou quando ambas são null. Não compara o conteúdo. Quando Objects.equals chama a.equals(b), aplica a regra de igualdade definida pela classe de a. Por exemplo, String.equals compara sequências de caracteres, enquanto a implementação herdada de Object.equals verifica apenas a identidade dos objetos.
Se houver uma chamada a a.equals(b), Objects.equals não corrige uma implementação incorreta de equals nem interceta as exceções que esta lance. Objects.equals não compara os elementos dos arrays; usa Objects.deepEquals(a, b) para comparar o conteúdo de arrays, mesmo quando estão aninhados.
Exemplos
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));
}
}Resultado
true false true false false
`new String(a)` cria um objeto `String` distinto com o mesmo texto. Por isso, `Objects.equals(a, b)` dá `true`, enquanto `a == b` dá `false`. As últimas três linhas mostram o resultado com dois argumentos `null` e com um único `null` em cada uma das duas posições.
Lições relacionadas
- Java · Lição 28 · Intermédio · Versão: 2