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

CKTIS / Java

java.util.Objects — проверка, равенство и хеширане

Запознайте се с Objects.requireNonNull, Objects.equals и Objects.hash: проверки за null, равенство на референции, които могат да бъдат null, и изчисляване на хеш от полета.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);

java.util.Objects предоставя статични помощни методи. Обхват на тази статия: Java SE 21; средата за изпълнение на хранилището и продукционната среда не са удостоверени.

Objects.requireNonNull(value, "value") връща същата референция или хвърля NullPointerException със зададеното съобщение. Полезен е за проверка на параметри, но например не проверява дали даден низ е празен.

Objects.equals(a, b) връща true, ако и двата аргумента са null, и false, ако само a е null. Когато a не е null, равенството се определя от метода equals на първия аргумент. Ако a == b и двете референции сочат към един и същ обект, API на Java SE 21 не гарантира, че извикването на a.equals(b) ще бъде пропуснато. Методът не сравнява съдържанието на масивите.

Objects.hash(field1, field2) изчислява хеш на последователност подобно на Arrays.hashCode(Object[]). При реализацията на hashCode() използвайте полета, съгласувани с equals(): равните обекти трябва да имат равни хешове, но са възможни колизии. За единичен обект Objects.hash(x) не е заместител на Objects.hashCode(x).

Примери

import java.util.Objects;

public class Main {
    public static void main(String[] args) {
        String name = Objects.requireNonNull("Ada", "name");
        System.out.println(name);
        System.out.println(Objects.equals(null, null));
        System.out.println(Objects.equals(name, null));
        System.out.println(Objects.hash(1, 2));
        try {
            Objects.requireNonNull(null, "name");
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Резултат

Ada
true
false
994
name

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници