Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

Objects.equals: porównywanie tytułów, które mogą być null

Porównuj tytuły, nawet gdy któregoś brakuje, używając `Objects.equals`. Przed utworzeniem etykiety sprawdź osobno, czy tytuł nie jest `null`.

Wersja: Java SE 21

Składnia

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) to statyczna metoda klasy java.util.Objects, która przyjmuje dwa argumenty typu Object i zwraca boolean. Gdy oba argumenty są null, wynik to true; gdy tylko jeden jest null, wynik to false, o ile metoda equals przestrzega swojego kontraktu. Gdy obie referencje wskazują ten sam obiekt, wynik to true; implementacja w JDK 21 zwraca ten wynik bez wywoływania a.equals(b). Dla dwóch różnych referencji innych niż null wynik określa a.equals(b).

Dla obiektów String równość oznacza ten sam ciąg znaków. Operator == dla referencji sprawdza natomiast, czy wskazują ten sam obiekt albo czy obie są null. Objects.equals nie porównuje elementów tablic; do głębokiego porównania tablic użyj Objects.deepEquals. Metoda nie naprawia wadliwej implementacji equals ani nie przechwytuje zgłaszanych przez nią wyjątków.

W porównaniu tytułów dwa braki mogą być sobie równe, ale wynik true nie dowodzi, że tytuł istnieje. Jeśli utworzenie etykiety wymaga tytułu, użyj Objects.requireNonNull(title, "title is required") przed wywołaniem strip(). Przy braku tytułu otrzymasz NullPointerException z podanym komunikatem. To sprawdzenie nie odrzuca pustego napisu ani napisu złożonego wyłącznie z białych znaków.

Przykłady

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

Wynik

true
false
true
false
Title: Atlas
title is required

Dwa obiekty `String` z tekstem `Atlas` są równe według `Objects.equals`, lecz nie według `==`. Dwa braki są równe w porównaniu, ale `label` odrzuca brak tytułu; przykład przechwytuje wyjątek i wypisuje jego komunikat.

Powiązane lekcje

  • Java · Lekcja 18 · Zaawansowany · Wersja: 2

Źródła