CKTIS / Java
java.util.Objects — preverjanje, enakost in zgoščevanje
Spoznajte Objects.requireNonNull, Objects.equals in Objects.hash: preverjanje vrednosti null, enakost referenc, ki so lahko null, ter izračun zgoščene vrednosti iz polj.
Različica: Java SE 21; repository runtime, production runtime not attested
Sintaksa
import java.util.Objects;
Objects.requireNonNull(value, "value");
Objects.equals(a, b);
Objects.hash(field1, field2);java.util.Objects ponuja statične pomožne metode. Obseg tega zapisa: Java SE 21; izvajalno okolje repozitorija in produkcijsko izvajalno okolje nista bila potrjena.
Objects.requireNonNull(value, "value") vrne isto referenco ali vrže NullPointerException z navedenim sporočilom. Uporabna je za preverjanje parametrov, vendar na primer ne preveri, ali je niz prazen.
Objects.equals(a, b) vrne true, če sta oba argumenta null, in false, če je samo a enak null. Če a ni null, enakost določa metoda equals prvega argumenta. Če velja a == b in obe referenci kažeta na isti objekt, API za Java SE 21 ne zagotavlja, da bo klic a.equals(b) izpuščen. Metoda ne primerja vsebine polj.
Objects.hash(field1, field2) izračuna zgoščeno vrednost zaporedja podobno kot Arrays.hashCode(Object[]). Pri implementaciji hashCode() uporabite polja, skladna z equals(): enaki objekti morajo imeti enake zgoščene vrednosti, vendar so trki mogoči. Za en sam objekt Objects.hash(x) ni nadomestilo za Objects.hashCode(x).
Primeri
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());
}
}
}Rezultat
Ada true false 994 name
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.