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

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