KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

Objects.equals: titels vergelijken die null kunnen zijn

Vergelijk titels ook als er een ontbreekt en controleer bij het maken van een label apart of de vereiste titel aanwezig is.

Versie: 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) is een statische methode uit java.util.Objects die twee argumenten van het type Object accepteert en een boolean teruggeeft. Zijn beide argumenten null, dan is het resultaat true. Is er maar één null, dan is het resultaat false, mits equals zich aan zijn contract houdt. Verwijzen beide referenties naar hetzelfde object, dan is het resultaat true; de implementatie in JDK 21 geeft dat resultaat terug zonder a.equals(b) aan te roepen. Bij twee verschillende referenties die niet null zijn, bepaalt a.equals(b) het resultaat.

Bij String-objecten betekent gelijkheid dat de tekenreeks hetzelfde is. Op referenties controleert == daarentegen of ze naar hetzelfde object verwijzen of allebei null zijn. Objects.equals vergelijkt geen array-elementen; gebruik Objects.deepEquals voor een diepe vergelijking van arrays. De methode herstelt geen gebrekkige equals-implementatie en vangt de uitzonderingen ervan niet af.

Twee ontbrekende titels kunnen bij de vergelijking gelijk zijn, maar true bewijst niet dat er een titel aanwezig is. Als een label een titel vereist, roep dan Objects.requireNonNull(title, "title is required") aan vóór strip(). Een ontbrekende titel leidt dan tot een NullPointerException met die melding. Deze controle weigert geen lege tekenreeksen of tekenreeksen die alleen uit witruimte bestaan.

Voorbeelden

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

Resultaat

true
false
true
false
Title: Atlas
title is required

Twee afzonderlijke `String`-objecten met de tekst `Atlas` zijn gelijk volgens `Objects.equals`, maar niet volgens `==`. Twee ontbrekende titels zijn gelijk bij de vergelijking, maar `label` weigert een ontbrekende titel; het voorbeeld vangt de uitzondering af en toont de melding.

Gerelateerde lessen

  • Java · Les 18 · Gevorderd · Versie: 2

Bronnen