CKTIS / Java
Objects.hash: kod skrótu z kilku wartości
`Objects.hash` łączy wartości w jeden kod skrótu typu `int`. Zobacz, jak działa `Object...`, kiedy zachodzi boxing i jak zachować zgodność z `equals`.
Wersja: Java SE 21
Składnia
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 to statyczna metoda klasy java.util.Objects. Zwraca kod skrótu typu int dla uporządkowanej sekwencji wartości. W wywołaniu Objects.hash(42, "A", "B") parametr Object... (varargs) pozwala przekazać wartości osobno: Java umieszcza je w tablicy Object[]. Prymitywne int o wartości 42 podlega boxingowi do Integer, a oba obiekty String są już wartościami referencyjnymi.
Wynik jest taki sam jak dla Arrays.hashCode(Object[]). Obliczenie zaczyna się od 1: dla każdego elementu metoda mnoży dotychczasowy wynik przez 31 i dodaje kod skrótu elementu albo 0, jeśli element to null. Zmiana kolejności może zmienić wynik. Dla pojedynczego obiektu niebędącego tablicą Objects.hash(x) oblicza skrót sekwencji jednoelementowej. Jeśli potrzebujesz kodu skrótu samego obiektu lub 0 dla null, użyj Objects.hashCode(x).
Jeśli przekażesz Object[] bezpośrednio, jego elementy tworzą sekwencję. Jeśli tablica jest jednym z elementów sekwencji, jej zawartość nie jest przetwarzana rekurencyjnie. Objects.hash((Object[]) null) zwraca 0, bo brakuje całej tablicy, natomiast Objects.hash((Object) null) zwraca 31, bo sekwencja ma jeden element null.
Implementując hashCode(), dobierz wartości tak, by obiekty równe według equals zawsze dawały ten sam wynik. Najprościej użyć tych samych pól i uwzględnić sposób, w jaki equals je porównuje. Odwrotna zależność nie zachodzi: różne obiekty mogą mieć ten sam kod skrótu (kolizja). Nie traktuj tego kodu jako trwałego identyfikatora ani skrótu kryptograficznego.
Przykłady
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());
}
}Wynik
true true 72234
Wygenerowana metoda `equals` porównuje trzy składowe rekordu `Key`. Własna metoda `hashCode()` przekazuje te same składowe w ustalonej kolejności, więc oba klucze są równe i mają kod skrótu `72234`.
Powiązane lekcje
- Java · Lekcja 28 · Średniozaawansowany · Wersja: 2
Źródła
- 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()