Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

Objects.hash: calcolare un codice hash da più valori

`Objects.hash` combina più valori in un codice hash di tipo `int`. Scopri come funzionano `Object...` e il boxing e come rispettare il contratto con `equals`.

Versione: Java SE 21

Sintassi

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 è un metodo statico di java.util.Objects. Restituisce un codice hash di tipo int per una sequenza ordinata di valori. In Objects.hash(42, "A", "B"), il parametro Object... (varargs) consente di passare i valori separatamente: Java li raccoglie in un array Object[]. Il valore primitivo int 42 viene convertito in Integer tramite boxing, mentre i due valori String sono già riferimenti.

Il risultato coincide con quello di Arrays.hashCode(Object[]). Si parte da 1: per ogni elemento si moltiplica il risultato corrente per 31 e si aggiunge il codice hash dell’elemento, oppure 0 se l’elemento è null. Cambiare l’ordine può cambiare il risultato. Per un singolo oggetto che non è un array, Objects.hash(x) calcola l’hash di una sequenza con un solo elemento. Usa Objects.hashCode(x) per ottenere il codice hash dell’oggetto stesso, oppure 0 per null.

Se passi direttamente un Object[], i suoi elementi formano la sequenza. Se un array è a sua volta un elemento della sequenza, l’hash del suo contenuto non viene calcolato ricorsivamente. Objects.hash((Object[]) null) restituisce 0 perché manca l’intero array, mentre Objects.hash((Object) null) restituisce 31 perché la sequenza contiene un elemento null.

Quando implementi hashCode(), scegli i valori in modo che oggetti uguali secondo equals producano sempre lo stesso risultato. Un modo semplice è usare gli stessi campi e tenere conto di come equals li confronta. Il contrario non vale: oggetti non uguali possono avere lo stesso codice hash (collisione). Non usare questo codice come identificatore persistente né come hash crittografico.

Esempi

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());
    }
}

Risultato

true
true
72234

Il metodo `equals` generato confronta i tre componenti di `Key`. Il metodo `hashCode()` personalizzato passa gli stessi componenti in un ordine fisso, quindi entrambe le chiavi sono uguali e hanno il codice hash `72234`.

Lezioni correlate

  • Java · Lezione 28 · Intermedio · Versione: 2

Fonti