WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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