CKTIS / Java
Objects.equals: usporedba naslova koji mogu biti null
Usporedi naslove čak i kad neki nedostaje, a pri izradi oznake zasebno provjeri je li potreban naslov dostupan.
Verzija: 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) statička je metoda klase java.util.Objects koja prima dva argumenta tipa Object i vraća boolean. Ako su oba argumenta null, vraća true. Ako je samo jedan null, rezultat je false pod uvjetom da equals poštuje svoj ugovor. Ako obje reference upućuju na isti objekt, rezultat je true; implementacija u JDK-u 21 vraća ga bez poziva a.equals(b). Za dvije različite reference koje nisu null rezultat određuje a.equals(b).
Za objekte String jednakost znači isti slijed znakova. Operator == pri usporedbi referenci provjerava upućuju li na isti objekt ili su obje null. Objects.equals ne uspoređuje elemente polja; za dubinsku usporedbu polja upotrijebi Objects.deepEquals. Metoda ne ispravlja neispravnu implementaciju metode equals niti hvata iznimke koje ona baca.
Dva naslova koja nedostaju mogu se smatrati jednakima, ali true ne dokazuje da je naslov dostupan. Ako je naslov obvezan pri izradi oznake, prije poziva strip() upotrijebi Objects.requireNonNull(title, "title is required"). Ako naslov nedostaje, provjera baca NullPointerException s tom porukom. Ne odbija prazne znakovne nizove ni one sastavljene samo od bjelina.
Primjeri
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čita objekta `String` koja sadrže `Atlas` jednaka su prema `Objects.equals`, ali ne prema `==`. Dva naslova koja nedostaju smatraju se jednakima, no `label` odbija naslov koji nedostaje; primjer hvata iznimku i ispisuje njezinu poruku.
Povezane lekcije
- Java · Lekcija 18 · Napredno · Verzija: 2
Izvori
- 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)