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

CKTIS / Java

Objects.equals: porovnávání názvů, které mohou být null

Porovnávejte názvy, i když některý chybí. Při vytváření popisku samostatně ověřte, zda je požadovaný název k dispozici.

Verze: Java SE 21

Syntaxe

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á metoda třídy java.util.Objects. Přijímá dva argumenty typu Object a vrací boolean. Jsou-li oba argumenty null, vrátí true. Je-li null jen jeden, vrátí false, pokud equals dodržuje svůj kontrakt. Pokud obě reference odkazují na stejný objekt, je výsledek true; implementace v JDK 21 jej vrátí bez volání a.equals(b). Pro dvě různé reference, které nejsou null, určuje výsledek a.equals(b).

U objektů String rovnost znamená stejnou posloupnost znaků. Operátor == u referencí naproti tomu ověřuje, zda odkazují na stejný objekt nebo zda jsou obě null. Objects.equals neporovnává prvky polí; k hloubkovému porovnání polí použijte Objects.deepEquals. Metoda neopravuje chybnou implementaci equals ani nezachytává výjimky, které tato implementace vyvolá.

Dva chybějící názvy si mohou být při porovnání rovny, ale výsledek true nedokazuje, že je název k dispozici. Pokud popisek vyžaduje název, zavolejte před strip() metodu Objects.requireNonNull(title, "title is required"). U chybějícího názvu vyvolá NullPointerException s touto zprávou. Tato kontrola neodmítá prázdné řetězce ani řetězce tvořené pouze bílými znaky.

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

true
false
true
false
Title: Atlas
title is required

Dva různé objekty `String` obsahující `Atlas` jsou si podle `Objects.equals` rovny, ale podle `==` ne. Dva chybějící názvy se vyhodnotí jako stejné, ale `label` chybějící název odmítne; příklad výjimku zachytí a vypíše její zprávu.

Související lekce

  • Java · Lekce 18 · Pokročilá · Verze: 2

Zdroje