CKTIS / Java
java.util.Objects — validácia, rovnosť a hashovanie
Spoznajte metódy Objects.requireNonNull, Objects.equals a Objects.hash: kontroly null, rovnosť referencií, ktoré môžu byť null, a výpočet hashu z polí.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);java.util.Objects poskytuje statické pomocné metódy. Rozsah tohto záznamu: Java SE 21; behové prostredie repozitára ani produkčné behové prostredie neboli potvrdené.
Objects.requireNonNull(value, "value") vráti tú istú referenciu alebo vyhodí NullPointerException s uvedenou správou. Je užitočná pri validácii parametrov, nekontroluje však napríklad, či je reťazec prázdny.
Objects.equals(a, b) vráti true, ak sú oba argumenty null, a false, ak je null iba a. Ak a nie je null, o rovnosti rozhoduje metóda equals prvého argumentu. Ak platí a == b a obe referencie odkazujú na ten istý objekt, API Java SE 21 nezaručuje, že sa volanie a.equals(b) vynechá. Metóda neporovnáva obsah polí.
Objects.hash(field1, field2) vypočíta hash postupnosti podobne ako Arrays.hashCode(Object[]). Pri implementácii hashCode() použite polia zodpovedajúce metóde equals(): rovnaké objekty musia mať rovnaké hashe, môžu však nastať kolízie. Pre jediný objekt nie je Objects.hash(x) náhradou za Objects.hashCode(x).
Príklady
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());
}
}
}Výsledok
Ada true false 994 name
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.