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