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

CKTIS / Java

java.util.Objects — validação, igualdade e hash

Aprenda a usar Objects.requireNonNull, Objects.equals e Objects.hash: verificações de null, igualdade entre referências que podem ser null e cálculo de um hash a partir de campos.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);

java.util.Objects disponibiliza métodos utilitários estáticos. Âmbito desta entrada: Java SE 21; os ambientes de execução do repositório e de produção não foram atestados.

Objects.requireNonNull(value, "value") devolve a mesma referência ou lança uma NullPointerException com a mensagem indicada. É útil para validar parâmetros, mas não verifica, por exemplo, se uma cadeia de caracteres está vazia.

Objects.equals(a, b) devolve true se ambos os argumentos forem null e false se apenas a for null. Quando a não é null, a igualdade é determinada pelo método equals do primeiro argumento. Se a == b e ambas as referências apontarem para o mesmo objeto, a API de Java SE 21 não garante que a chamada a a.equals(b) seja omitida. O método não compara o conteúdo dos arrays.

Objects.hash(field1, field2) calcula o hash de uma sequência de forma semelhante a Arrays.hashCode(Object[]). Ao implementar hashCode(), utilize campos coerentes com equals(): objetos iguais têm de ter hashes iguais, mas podem ocorrer colisões. Para um único objeto, Objects.hash(x) não substitui Objects.hashCode(x).

Exemplos

import java.util.Objects;

public class Main {
    public static void main(String[] args) {
        String name = Objects.requireNonNull("Ada", "name");
        System.out.println(name);
        System.out.println(Objects.equals(null, null));
        System.out.println(Objects.equals(name, null));
        System.out.println(Objects.hash(1, 2));
        try {
            Objects.requireNonNull(null, "name");
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Resultado

Ada
true
false
994
name

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes