Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Objects.hash: kod skrótu z dwóch pól

Połącz dwa pola w kod skrótu typu `int` i zobacz, dlaczego Java automatycznie opakowuje `int` w `Integer` oraz czym `Objects.hash` różni się od `Objects.hashCode`.

Wersja: Java SE 21

Składnia

import java.util.Objects;

// Java SE 21 — method declaration in java.util.Objects:
// public static int hash(Object... values)
int hash = Objects.hash(label, number); // label: String, number: int

W Java SE 21 statyczna metoda Objects.hash(Object... values) z klasy java.util.Objects zwraca kod skrótu typu int dla uporządkowanej sekwencji wartości. W wywołaniu Objects.hash(label, number) Java automatycznie opakowuje number typu int w Integer (autoboxing) i przekazuje obie wartości w tablicy Object[].

Wynik jest taki jak w Arrays.hashCode(Object[]): dla tablicy innej niż null obliczenia zaczynają się od h = 1, a następnie dla każdego elementu e wykonuje się h = 31 * h + (e == null ? 0 : e.hashCode()). Kolejność może zmienić wynik. Objects.hash() zwraca 1, Objects.hash((Object) null) zwraca 31, a Objects.hash((Object[]) null) zwraca 0.

Objects.hash(x) z jednym elementem nadal miesza jego kod skrótu z wartością początkową. Objects.hashCode(x) zwraca bezpośrednio x.hashCode() albo 0, gdy x to null. Istniejąca tablica Object[] przekazana jako jedyny argument staje się tablicą argumentów varargs; rzutowanie jej na Object czyni z niej jeden element, którego zawartość nie jest haszowana rekurencyjnie.

W implementacji hashCode() łącz pola w sposób zgodny z tym, jak equals je porównuje. Równe obiekty muszą mieć ten sam kod skrótu, ale różne obiekty mogą mieć ten sam wynik. Nie używaj tego kodu jako trwałego identyfikatora ani skrótu kryptograficznego; ogólny kontrakt hashCode() nie gwarantuje tego samego wyniku między uruchomieniami.

Przykłady

import java.util.Objects;

public class Main {
    record Key(String label, int number) {
        @Override
        public int hashCode() {
            return Objects.hash(label, number);
        }
    }

    public static void main(String[] args) {
        Key first = new Key("A", 7);
        Key second = new Key("A", 7);
        System.out.println(first.equals(second));
        System.out.println(first.hashCode() == second.hashCode());
        System.out.println(first.hashCode());
        System.out.println(Objects.hash(7));
        System.out.println(Objects.hashCode(7));
    }
}

Wynik

true
true
2983
38
7

Wygenerowane `equals` rekordu `Key` porównuje oba komponenty. Dwa pierwsze wiersze (`true`) potwierdzają równość obiektów i ich kodów skrótu. Wynik `2983` łączy kody wartości `"A"` i `7`; wartości `38` i `7` pokazują różnicę między haszowaniem sekwencji jednoelementowej a pobraniem kodu samego elementu.

Powiązane lekcje

  • Java · Lekcja 18 · Zaawansowany · Wersja: 2

Źródła