WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Objects.equals: Titel vergleichen, die null sein können

Vergleiche Titel auch dann, wenn einer fehlt. Prüfe beim Erstellen einer Beschriftung separat, ob der benötigte Titel vorhanden ist.

Version: 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) ist eine statische Methode aus java.util.Objects. Sie nimmt zwei Argumente vom Typ Object entgegen und liefert einen boolean. Sind beide Argumente null, ist das Ergebnis true. Ist nur eines null, lautet es false, sofern equals seinen Vertrag einhält. Zeigen beide Referenzen auf dasselbe Objekt, ist das Ergebnis true; die Implementierung im JDK 21 gibt es zurück, ohne a.equals(b) aufzurufen. Bei zwei verschiedenen Referenzen, die nicht null sind, bestimmt a.equals(b) das Ergebnis.

Bei String-Objekten bedeutet Gleichheit dieselbe Zeichenfolge. Dagegen prüft == bei Referenzen, ob beide auf dasselbe Objekt zeigen oder beide null sind. Objects.equals vergleicht keine Array-Elemente; verwende für einen tiefen Array-Vergleich Objects.deepEquals. Die Methode korrigiert weder eine fehlerhafte Implementierung von equals noch fängt sie deren Ausnahmen ab.

Zwei fehlende Titel können beim Vergleich gleich sein, doch true belegt nicht, dass ein Titel vorhanden ist. Falls eine Beschriftung einen Titel erfordert, verwende vor strip() die Prüfung Objects.requireNonNull(title, "title is required"). Fehlt der Titel, löst die Prüfung eine NullPointerException mit dieser Meldung aus. Leere Zeichenfolgen oder solche, die nur aus Leerraum bestehen, weist sie nicht zurück.

Beispiele

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

Ergebnis

true
false
true
false
Title: Atlas
title is required

Zwei verschiedene `String`-Objekte mit dem Text `Atlas` sind nach `Objects.equals` gleich, nach `==` aber nicht. Zwei fehlende Titel sind beim Vergleich gleich; `label` weist einen fehlenden Titel dennoch zurück. Das Beispiel fängt die Ausnahme ab und gibt ihre Meldung aus.

Zugehörige Lektionen

  • Java · Lektion 18 · Fortgeschritten · Version: 2

Quellen