CKTIS / Java
Objects.equals: сравняване на заглавия, които може да са null
Сравнявай заглавия дори когато някое липсва. При създаване на етикет провери отделно дали необходимото заглавие е налично.
Версия: Java SE 21
Синтаксис
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) е статичен метод на класа java.util.Objects, който приема два аргумента от тип Object и връща boolean. Ако и двата аргумента са null, резултатът е true. Ако само единият е null, резултатът е false, стига equals да спазва договора си. Ако и двете референции сочат към един и същ обект, резултатът е true; реализацията в JDK 21 го връща, без да извиква a.equals(b). При две различни референции, които не са null, резултатът се определя от a.equals(b).
При обекти от тип String равенство означава една и съща последователност от символи. За разлика от това == при референции проверява дали сочат към един и същ обект, или и двете са null. Objects.equals не сравнява елементите на масиви; за дълбоко сравнение на масиви използвай Objects.deepEquals. Методът не поправя неправилна реализация на equals и не прихваща изключенията, които тя хвърля.
Две липсващи заглавия може да се приемат за равни, но резултатът true не доказва, че има заглавие. Ако за етикета е необходимо заглавие, използвай Objects.requireNonNull(title, "title is required") преди извикването на strip(). При липсващо заглавие проверката хвърля NullPointerException с това съобщение. Тя не отхвърля празни низове или низове, съставени само от празни знаци.
Примери
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());
}
}
}Резултат
true false true false Title: Atlas title is required
Два различни обекта `String` с текст `Atlas` са равни според `Objects.equals`, но не и според `==`. Две липсващи заглавия се приемат за равни, но `label` отхвърля липсващо заглавие; примерът прихваща изключението и отпечатва съобщението му.
Свързани уроци
- Java · Урок 18 · Напреднало · Версия: 2
Източници
- 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)