Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

java.util.Objects — walidacja, równość i haszowanie

Poznaj Objects.requireNonNull, Objects.equals i Objects.hash: sprawdzanie null, porównywanie referencji dopuszczających null oraz obliczanie hasza z pól.

Wersja: Java SE 21; repository runtime, production runtime not attested

Składnia

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

java.util.Objects udostępnia statyczne metody pomocnicze. Zakres wpisu: Java SE 21; środowisko repozytorium i środowisko produkcyjne nie zostały potwierdzone.

Objects.requireNonNull(value, "value") zwraca tę samą referencję albo rzuca NullPointerException z podanym komunikatem. Przydaje się przy walidacji parametrów, ale nie sprawdza np. pustego tekstu.

Objects.equals(a, b) zwraca true, gdy oba argumenty są null, oraz false, gdy tylko a jest null. Gdy a nie jest null, o równości rozstrzyga metoda equals pierwszego argumentu. Jeśli a == b i obie referencje wskazują na ten sam obiekt, API Java SE 21 nie gwarantuje pominięcia wywołania a.equals(b). Metoda nie porównuje zawartości tablic.

Objects.hash(field1, field2) oblicza hasz sekwencji jak Arrays.hashCode(Object[]). W implementacji hashCode() używaj pól zgodnych z equals(): równe obiekty muszą mieć równe hasze, ale kolizje są możliwe. Objects.hash(x) nie jest zamiennikiem Objects.hashCode(x) dla pojedynczego obiektu.

Przykłady

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());
        }
    }
}

Wynik

Ada
true
false
994
name

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła