CKTIS / Java
java.util.Objects — provjera, jednakost i hashiranje
Upoznajte Objects.requireNonNull, Objects.equals i Objects.hash: provjeru vrijednosti null, jednakost referenci koje mogu biti null i izračun hasha iz polja.
Verzija: 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 pruža statičke pomoćne metode. Opseg ovog zapisa: Java SE 21; okruženje izvođenja repozitorija i produkcijsko okruženje nisu potvrđeni.
Objects.requireNonNull(value, "value") vraća istu referencu ili izbacuje NullPointerException s navedenom porukom. Korisna je za provjeru parametara, ali, primjerice, ne provjerava je li tekst prazan.
Objects.equals(a, b) vraća true ako su oba argumenta null, a false ako samo a ima vrijednost null. Ako a nije null, jednakost se određuje metodom equals prvog argumenta. Ako vrijedi a == b i obje reference upućuju na isti objekt, API za Java SE 21 ne jamči da će poziv a.equals(b) biti preskočen. Metoda ne uspoređuje sadržaj polja.
Objects.hash(field1, field2) izračunava hash niza poput Arrays.hashCode(Object[]). Pri implementaciji hashCode() upotrijebite polja usklađena s metodom equals(): jednaki objekti moraju imati jednake hashove, no kolizije su moguće. Za jedan objekt Objects.hash(x) nije zamjena za Objects.hashCode(x).
Primjeri
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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.