CKTIS / Java
Objects.equals: primerjanje naslovov, ki so lahko null
Primerjaj naslova, tudi če kateri manjka. Pred ustvarjanjem oznake posebej preveri, ali je zahtevani naslov na voljo.
Različica: Java SE 21
Sintaksa
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 statična metoda razreda java.util.Objects, ki sprejme dva argumenta tipa Object in vrne boolean. Če sta oba argumenta null, vrne true. Če je null samo eden, je rezultat false, če metoda equals upošteva svojo pogodbo. Če obe referenci kažeta na isti objekt, je rezultat true; implementacija v JDK 21 ga vrne brez klica a.equals(b). Pri dveh različnih referencah, ki nista null, rezultat določi a.equals(b).
Pri objektih String enakost pomeni, da imata enako zaporedje znakov. Operator == pri referencah nasprotno preveri, ali kažeta na isti objekt oziroma ali sta obe null. Objects.equals ne primerja elementov tabel; za globoko primerjavo tabel uporabi Objects.deepEquals. Metoda ne popravi napačne implementacije equals in ne prestreže izjem, ki jih ta sproži.
Dva manjkajoča naslova sta pri primerjavi lahko enaka, vendar true ne dokazuje, da je naslov na voljo. Če oznaka zahteva naslov, pred klicem strip() uporabi Objects.requireNonNull(title, "title is required"). Če naslov manjka, preverjanje sproži NullPointerException s tem sporočilom. Ne zavrne praznega niza ali niza, ki vsebuje samo bele znake.
Primeri
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());
}
}
}Rezultat
true false true false Title: Atlas title is required
Dva različna objekta `String`, ki vsebujeta `Atlas`, sta enaka po `Objects.equals`, ne pa po `==`. Dva manjkajoča naslova sta pri primerjavi enaka, vendar `label` manjkajoči naslov zavrne; primer prestreže izjemo in izpiše njeno sporočilo.
Povezane lekcije
- Java · Lekcija 18 · Napredna · Različica: 2
Viri
- 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)