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: intW 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
- Objects — hash(Object...) and hashCode(Object), Java SE 21
- Arrays — hashCode(Object[]), Java SE 21
- List — hashCode(), Java SE 21
- Java Language Specification, Java SE 21 — §5.1.7 Boxing Conversion
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Object — hashCode(), Java SE 21
- Record — equals(Object), Java SE 21
- String — hashCode(), Java SE 21
- Integer — hashCode(), Java SE 21