Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

java.util.Objects — validace, rovnost a hashování

Poznejte metody Objects.requireNonNull, Objects.equals a Objects.hash: kontroly null, rovnost referencí, které mohou být null, a výpočet hashe z polí.

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

Syntaxe

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

java.util.Objects poskytuje statické pomocné metody. Rozsah tohoto záznamu: Java SE 21; běhové prostředí repozitáře ani produkční běhové prostředí nebyly potvrzeny.

Objects.requireNonNull(value, "value") vrátí stejnou referenci, nebo vyhodí NullPointerException s uvedenou zprávou. Hodí se k validaci parametrů, nekontroluje však například, zda je řetězec prázdný.

Objects.equals(a, b) vrátí true, pokud jsou oba argumenty null, a false, pokud je null pouze a. Pokud a není null, o rovnosti rozhoduje metoda equals prvního argumentu. Pokud platí a == b a obě reference odkazují na tentýž objekt, API Java SE 21 nezaručuje, že se volání a.equals(b) vynechá. Metoda neporovnává obsah polí.

Objects.hash(field1, field2) vypočítá hash sekvence podobně jako Arrays.hashCode(Object[]). Při implementaci hashCode() použijte pole odpovídající metodě equals(): stejné objekty musí mít stejné hashe, ke kolizím však může dojít. Pro jediný objekt není Objects.hash(x) náhradou za Objects.hashCode(x).

Pří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ýsledek

Ada
true
false
994
name

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje