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
- Java SE 21 API — Objects.equals(Object, Object)
- Java SE 21 API — Object.equals(Object)
- Java SE 21 API — String.equals(Object)
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=
- Java SE 21 API — Objects.deepEquals(Object, Object)
- Java SE 21 API — Objects.requireNonNull(T, String)