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

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: int

No 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