CKTIS / Java
Objects.hash: výpočet hash kódu z více hodnot
`Objects.hash` spojuje více hodnot do jednoho hash kódu typu `int`. Zjisti, jak fungují `Object...` a boxing a jak dodržet smlouvu s metodou `equals`.
Verze: Java SE 21
Syntaxe
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 je statická metoda třídy java.util.Objects. Vrací hash kód typu int pro posloupnost hodnot v daném pořadí. Při volání Objects.hash(42, "A", "B") umožňuje parametr Object... (varargs) předat hodnoty samostatně: Java je seskupí do pole Object[]. Primitivní hodnota int 42 se pomocí boxingu převede na Integer, zatímco obě hodnoty typu String už jsou reference.
Výsledek je stejný jako u Arrays.hashCode(Object[]). Výpočet začíná od 1: pro každý prvek se průběžný výsledek vynásobí 31 a přičte se hash kód prvku, nebo 0, pokud je prvek null. Změna pořadí může změnit výsledek. Pro jediný objekt, který není polem, počítá Objects.hash(x) hash kód jednoprvkové posloupnosti. Pokud chceš hash kód samotného objektu nebo 0 pro null, použij Objects.hashCode(x).
Pokud přímo předáš Object[], posloupnost tvoří jeho prvky. Pokud je pole samo prvkem posloupnosti, jeho obsah se nehashuje rekurzivně. Objects.hash((Object[]) null) vrací 0, protože celé pole chybí, zatímco Objects.hash((Object) null) vrací 31, protože posloupnost obsahuje jeden prvek null.
Při implementaci hashCode() vybírej hodnoty tak, aby objekty shodné podle equals vždy dávaly stejný výsledek. Jednoduchý postup je použít stejné atributy a zohlednit, jak je equals porovnává. Obráceně to neplatí: i neshodné objekty mohou mít stejný hash kód (kolize). Nepoužívej tento kód jako trvalý identifikátor ani jako kryptografický hash.
Příklady
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());
}
}Výsledek
true true 72234
Vygenerovaná metoda `equals` porovnává tři komponenty `Key`. Vlastní metoda `hashCode()` předává tytéž komponenty v pevném pořadí, takže oba klíče jsou shodné a mají hash kód `72234`.
Související lekce
- Java · Lekce 28 · Středně pokročilá · Verze: 2
Zdroje
- 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()