База знанияИзпитен център
BGБългарски
Избери език13

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

Източници