CKTIS / Java
Objects.hash: einen Hashcode aus mehreren Werten berechnen
`Objects.hash` kombiniert mehrere Werte zu einem Hashcode vom Typ `int`. Lerne, wie `Object...` und Boxing funktionieren und wie der Hashcode zu `equals` passt.
Version: Java SE 21
Syntax
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 ist eine statische Methode in java.util.Objects. Sie liefert einen Hashcode vom Typ int für eine geordnete Folge von Werten. Beim Aufruf Objects.hash(42, "A", "B") kannst du die Werte dank des Parameters Object... (Varargs) einzeln übergeben: Java fasst sie in einem Object[] zusammen. Der primitive int-Wert 42 wird durch Boxing zu einem Integer; die beiden String-Werte sind bereits Referenzen.
Das Ergebnis entspricht Arrays.hashCode(Object[]). Beginnend bei 1 wird das Zwischenergebnis für jedes Element mit 31 multipliziert und dessen Hashcode addiert, bei einem null-Element stattdessen 0. Eine andere Reihenfolge kann das Ergebnis ändern. Für ein einzelnes Objekt, das kein Array ist, berechnet Objects.hash(x) den Hashcode einer Folge mit einem Element. Mit Objects.hashCode(x) erhältst du den eigenen Hashcode des Objekts oder 0 für null.
Übergibst du ein Object[] direkt, bilden seine Elemente die Folge. Ist ein Array selbst ein Element der Folge, wird sein Inhalt nicht rekursiv gehasht. Objects.hash((Object[]) null) ergibt 0, weil das gesamte Array fehlt. Objects.hash((Object) null) ergibt dagegen 31, weil die Folge ein null-Element enthält.
Wähle bei der Implementierung von hashCode() die Werte so, dass laut equals gleiche Objekte stets dasselbe Ergebnis liefern. Am einfachsten ist es, dieselben Felder zu verwenden und zu berücksichtigen, wie equals sie vergleicht. Die Umkehrung gilt nicht: Ungleiche Objekte können denselben Hashcode haben (Kollision). Verwende den Hashcode weder als dauerhafte Kennung noch als kryptografischen Hash.
Beispiele
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());
}
}Ergebnis
true true 72234
Die generierte Methode `equals` vergleicht die drei Komponenten von `Key`. Die eigene Methode `hashCode()` übergibt dieselben Komponenten in fester Reihenfolge. Daher sind beide Schlüssel gleich und haben den Hashcode `72234`.
Zugehörige Lektionen
- Java · Lektion 28 · Mittlere Stufe · Version: 2
Quellen
- 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()