CKTIS / Java
Objects.hash: calcular um código de hash a partir de vários valores
`Objects.hash` combina vários valores num código de hash do tipo `int`. Vê como funcionam `Object...` e o boxing e como manter a coerência com `equals`.
Versão: Java SE 21
Sintaxe
import java.util.Objects;
// Static method declared in java.util.Objects:
public static int hash(Object... values)
// Example call:
int hash = Objects.hash(42, "A", "B");Objects.hash é um método estático de java.util.Objects. Devolve um código de hash do tipo int para uma sequência ordenada de valores. Em Objects.hash(42, "A", "B"), o parâmetro Object... (varargs) permite passar os valores separadamente: o Java agrupa-os num array Object[]. O valor primitivo int 42 é convertido em Integer por boxing, enquanto os dois valores String já são referências.
O resultado é igual ao de Arrays.hashCode(Object[]). Começa-se em 1: por cada elemento, multiplica-se o resultado acumulado por 31 e soma-se o código de hash do elemento, ou 0 se o elemento for null. Mudar a ordem pode alterar o resultado. Para um único objeto que não seja um array, Objects.hash(x) calcula o hash de uma sequência com um elemento. Usa Objects.hashCode(x) para obter o código de hash do próprio objeto, ou 0 para null.
Se passares diretamente um Object[], os seus elementos formam a sequência. Se um array for, ele próprio, um elemento da sequência, o hash do seu conteúdo não é calculado recursivamente. Objects.hash((Object[]) null) devolve 0 porque falta o array inteiro, ao passo que Objects.hash((Object) null) devolve 31 porque há um elemento null.
Ao implementares hashCode(), escolhe os valores de forma a que objetos iguais segundo equals produzam sempre o mesmo resultado. Uma forma simples é usar os mesmos campos e ter em conta a forma como equals os compara. O inverso não se verifica: objetos não iguais podem ter o mesmo código de hash (colisão). Não uses este código como identificador persistente nem como hash criptográfico.
Exemplos
import java.util.Objects;
public class Main {
record Key(int id, String first, String second) {
@Override
public int hashCode() {
return Objects.hash(id, first, second);
}
}
public static void main(String[] args) {
Key left = new Key(42, "A", "B");
Key right = new Key(42, "A", "B");
System.out.println(left.equals(right));
System.out.println(left.hashCode() == right.hashCode());
System.out.println(left.hashCode());
}
}Resultado
true true 72234
O método `equals` gerado compara os três componentes de `Key`. O método `hashCode()` personalizado passa esses componentes numa ordem fixa, pelo que as duas chaves são iguais e têm o código de hash `72234`.
Lições relacionadas
- Java · Lição 28 · Intermédio · Versão: 2
Fontes
- Java SE 21 API — Objects.hash(Object...)
- Java SE 21 API — Objects.hashCode(Object)
- Java SE 21 API — Arrays.hashCode(Object[])
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java SE 21 API — Object.hashCode()
- Java SE 21 API — Record.equals(Object)
- Java SE 21 API — List.hashCode()
- Java SE 21 API — Integer.hashCode()
- Java SE 21 API — String.hashCode()