Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes