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.