Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri