Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

Objects.equals: porovnávanie názvov, ktoré môžu byť null

Porovnávajte názvy aj vtedy, keď niektorý chýba. Pred vytvorením popisu samostatne skontrolujte, či je požadovaný názov k dispozícii.

Verzia: Java SE 21

Syntax

import java.util.Objects;

// Declaration in java.util.Objects (Java SE 21):
public static boolean equals(Object a, Object b)

// Use in an expression or statement:
boolean equal = Objects.equals(a, b);

Objects.equals(a, b) je statická metóda triedy java.util.Objects. Prijíma dva argumenty typu Object a vracia boolean. Ak sú oba argumenty null, výsledok je true. Ak je null iba jeden, výsledok je false, pokiaľ equals dodržiava svoj kontrakt. Ak obe referencie odkazujú na ten istý objekt, výsledok je true; implementácia v JDK 21 ho vráti bez volania a.equals(b). Pri dvoch rôznych referenciách, ktoré nie sú null, výsledok určuje a.equals(b).

Pri objektoch String rovnosť znamená rovnakú postupnosť znakov. Operátor == pri referenciách naopak overuje, či odkazujú na ten istý objekt alebo či sú obe null. Objects.equals neporovnáva prvky polí; na hĺbkové porovnanie polí použite Objects.deepEquals. Metóda neopravuje chybnú implementáciu equals ani nezachytáva výnimky, ktoré táto implementácia vyvolá.

Dva chýbajúce názvy môžu pri porovnaní vyjsť ako rovnaké, ale true nedokazuje, že je názov k dispozícii. Ak popis vyžaduje názov, pred volaním strip() použite Objects.requireNonNull(title, "title is required"). Pri chýbajúcom názve kontrola vyvolá NullPointerException s touto správou. Neodmieta prázdne reťazce ani reťazce zložené iba z bielych znakov.

Príklady

import java.util.Objects;

public class Main {
    private static String label(String title) {
        return "Title: " + Objects.requireNonNull(title, "title is required").strip();
    }

    public static void main(String[] args) {
        String title = "Atlas";
        String sameText = new String(title); // Deliberately distinct reference.
        String missing = null;

        System.out.println(Objects.equals(missing, null));
        System.out.println(Objects.equals(title, missing));
        System.out.println(Objects.equals(title, sameText));
        System.out.println(title == sameText);
        System.out.println(label(title));
        try {
            System.out.println(label(missing));
        } catch (NullPointerException e) {
            System.out.println(e.getMessage());
        }
    }
}

Výsledok

true
false
true
false
Title: Atlas
title is required

Dva rôzne objekty `String` s textom `Atlas` sa podľa `Objects.equals` rovnajú, podľa `==` však nie. Dva chýbajúce názvy sa vyhodnotia ako rovnaké, ale `label` chýbajúci názov odmietne; príklad zachytí výnimku a vypíše jej správu.

Súvisiace lekcie

  • Java · Lekcia 18 · Pokročilá · Verzia: 2

Zdroje