CKTIS / Java
Objects.equals: porovnávání názvů, které mohou být null
Porovnávejte názvy, i když některý chybí. Při vytváření popisku samostatně ověřte, zda je požadovaný název k dispozici.
Verze: Java SE 21
Syntaxe
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 statická metoda třídy java.util.Objects. Přijímá dva argumenty typu Object a vrací boolean. Jsou-li oba argumenty null, vrátí true. Je-li null jen jeden, vrátí false, pokud equals dodržuje svůj kontrakt. Pokud obě reference odkazují na stejný objekt, je výsledek true; implementace v JDK 21 jej vrátí bez volání a.equals(b). Pro dvě různé reference, které nejsou null, určuje výsledek a.equals(b).
U objektů String rovnost znamená stejnou posloupnost znaků. Operátor == u referencí naproti tomu ověřuje, zda odkazují na stejný objekt nebo zda jsou obě null. Objects.equals neporovnává prvky polí; k hloubkovému porovnání polí použijte Objects.deepEquals. Metoda neopravuje chybnou implementaci equals ani nezachytává výjimky, které tato implementace vyvolá.
Dva chybějící názvy si mohou být při porovnání rovny, ale výsledek true nedokazuje, že je název k dispozici. Pokud popisek vyžaduje název, zavolejte před strip() metodu Objects.requireNonNull(title, "title is required"). U chybějícího názvu vyvolá NullPointerException s touto zprávou. Tato kontrola neodmítá prázdné řetězce ani řetězce tvořené pouze bílými znaky.
Příklady
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());
}
}
}Výsledek
true false true false Title: Atlas title is required
Dva různé objekty `String` obsahující `Atlas` jsou si podle `Objects.equals` rovny, ale podle `==` ne. Dva chybějící názvy se vyhodnotí jako stejné, ale `label` chybějící název odmítne; příklad výjimku zachytí a vypíše její zprávu.
Související lekce
- Java · Lekce 18 · Pokročilá · Verze: 2
Zdroje
- 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)