CKTIS / Java
Objects.hash: código hash a partir de dois campos
Combina dois campos num código hash do tipo `int`, percebe por que motivo o Java converte automaticamente um `int` em `Integer` e distingue `Objects.hash` de `Objects.hashCode`.
Versão: Java SE 21
Sintaxe
import java.util.Objects;
// Java SE 21 — method declaration in java.util.Objects:
// public static int hash(Object... values)
int hash = Objects.hash(label, number); // label: String, number: intNo Java SE 21, o método estático Objects.hash(Object... values) de java.util.Objects devolve um código hash do tipo int para uma sequência ordenada de valores. Em Objects.hash(label, number), o Java converte automaticamente o campo number do tipo int em Integer (autoboxing) e passa ambos os valores num array Object[].
O resultado segue Arrays.hashCode(Object[]): se o array não for null, começa-se com h = 1 e aplica-se h = 31 * h + (e == null ? 0 : e.hashCode()) a cada elemento e. A ordem pode alterar o resultado. Objects.hash() devolve 1, Objects.hash((Object) null) devolve 31 e Objects.hash((Object[]) null) devolve 0.
Mesmo com um só elemento, Objects.hash(x) combina o código hash desse elemento com o valor inicial. Objects.hashCode(x) devolve diretamente x.hashCode(), ou 0 se x for null. Um Object[] existente passado como único argumento é o próprio array de varargs. Com um cast para Object, passa a ser um único elemento, cujo conteúdo não é processado recursivamente no cálculo do hash.
Ao implementar hashCode(), combina os campos de forma coerente com a comparação feita por equals. Objetos iguais têm de ter o mesmo código hash, mas objetos diferentes também podem ter o mesmo código. Não uses o resultado como identificador persistente nem como hash criptográfico: o contrato geral de hashCode() não garante o mesmo resultado entre execuções.
Exemplos
import java.util.Objects;
public class Main {
record Key(String label, int number) {
@Override
public int hashCode() {
return Objects.hash(label, number);
}
}
public static void main(String[] args) {
Key first = new Key("A", 7);
Key second = new Key("A", 7);
System.out.println(first.equals(second));
System.out.println(first.hashCode() == second.hashCode());
System.out.println(first.hashCode());
System.out.println(Objects.hash(7));
System.out.println(Objects.hashCode(7));
}
}Resultado
true true 2983 38 7
O `equals` gerado para `Key` compara os dois componentes do record. As duas primeiras linhas (`true`) mostram que os objetos são iguais e que os respetivos códigos hash coincidem. `2983` combina os códigos de `"A"` e `7`; `38` e `7` distinguem o código de uma sequência com um só elemento do código do próprio elemento.
Lições relacionadas
- Java · Lição 18 · Avançado · Versão: 2
Fontes
- Objects — hash(Object...) and hashCode(Object), Java SE 21
- Arrays — hashCode(Object[]), Java SE 21
- List — hashCode(), Java SE 21
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Object — hashCode(), Java SE 21
- Record — equals(Object), Java SE 21
- String — hashCode(), Java SE 21
- Integer — hashCode(), Java SE 21