CKTIS / Java
Objects.hash: хеш-код от две полета
Обединете две полета в хеш-код от тип `int`, вижте защо Java автоматично преобразува `int` в `Integer` и разграничете `Objects.hash` от `Objects.hashCode`.
Версия: Java SE 21
Синтаксис
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В Java SE 21 статичният метод Objects.hash(Object... values) от класа java.util.Objects връща хеш-код от тип int за подредена последователност от стойности. При Objects.hash(label, number) Java автоматично обвива стойността на полето number от тип int в Integer (autoboxing) и предава двете стойности в масив Object[].
Резултатът следва Arrays.hashCode(Object[]): ако масивът не е null, изчислението започва с h = 1 и за всеки елемент e се прилага h = 31 * h + (e == null ? 0 : e.hashCode()). Редът може да повлияе на резултата. Objects.hash() връща 1, Objects.hash((Object) null) връща 31, а Objects.hash((Object[]) null) връща 0.
Дори с един елемент Objects.hash(x) комбинира неговия хеш-код с началната стойност. Objects.hashCode(x) връща направо x.hashCode() или 0, ако x е null. Съществуващ масив Object[], подаден като единствен аргумент, служи като самия масив с аргументи varargs. Преобразуван изрично към Object, той става един елемент, чието съдържание не се хешира рекурсивно.
Когато реализирате hashCode(), комбинирайте полетата в съответствие с начина, по който equals ги сравнява. Равните обекти трябва да имат еднакъв хеш-код, но и различни обекти могат да имат еднакъв код. Не използвайте резултата като постоянен идентификатор или криптографски хеш: общият договор на hashCode() не гарантира еднаква стойност при различни изпълнения.
Примери
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));
}
}Резултат
true true 2983 38 7
Генерираният метод `equals` за `Key` сравнява двата компонента на записа. Първите два реда (`true`) показват, че обектите са равни и хеш-кодовете им съвпадат. `2983` комбинира кодовете на `"A"` и `7`; `38` и `7` показват разликата между кода на последователност с един елемент и кода на самия елемент.
Свързани уроци
- Java · Урок 18 · Напреднало · Версия: 2
Източници
- 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