CKTIS / Java
Objects.equals: bezpečné porovnávání objektů s null
Pomocí `Objects.equals(a, b)` porovnáš objekty podle pravidel metody `equals`, i když jeden nebo oba argumenty mohou mít hodnotu `null`.
Verze: Java SE 21
Syntaxe
import java.util.Objects;
// Java SE 21 API signature: public static boolean equals(Object a, Object b)
boolean equal = Objects.equals(a, b);Objects.equals(a, b) je statická metoda třídy java.util.Objects, která vrací hodnotu typu boolean. V OpenJDK 21 při splnění podmínky a == b metoda rovnou vrátí true, aniž zavolá a.equals(b). To platí, pokud obě reference odkazují na stejný objekt nebo pokud mají oba argumenty hodnotu null. Pokud je výsledek a == b roven false, metoda vrátí false, je-li a rovno null; jinak zavolá a.equals(b) a vrátí výsledek tohoto volání. Podle kontraktu metody equals musí být při tomto volání výsledek false, pokud je b rovno null. Na rozdíl od přímého volání a.equals(b) metoda nevyvolá NullPointerException jen proto, že a má hodnotu null.
U dvou referencí vrací == hodnotu true, pokud obě odkazují na stejný objekt nebo jsou obě null. Obsah neporovnává. Když Objects.equals zavolá a.equals(b), použije pravidlo rovnosti definované třídou objektu a. Například String.equals porovnává posloupnosti znaků, zatímco zděděná implementace Object.equals ověřuje pouze totožnost objektů.
Pokud dojde k volání a.equals(b), Objects.equals neopraví chybnou implementaci equals ani nezachytí výjimky, které tato implementace vyvolá. Objects.equals neporovnává prvky polí. K porovnání obsahu polí, včetně vnořených, použij Objects.deepEquals(a, b).
Příklady
import java.util.Objects;
public class Main {
public static void main(String[] args) {
String a = "Java";
String b = new String(a);
System.out.println(Objects.equals(a, b));
System.out.println(a == b);
System.out.println(Objects.equals(null, null));
System.out.println(Objects.equals(null, b));
System.out.println(Objects.equals(a, null));
}
}Výsledek
true false true false false
`new String(a)` vytvoří samostatný objekt `String` se stejným textem, takže `Objects.equals(a, b)` vrátí `true`, ale `a == b` vrátí `false`. Poslední tři řádky ukazují výsledek pro dva argumenty `null` a pro jediný argument `null` na každé ze dvou pozic.
Související lekce
- Java · Lekce 28 · Středně pokročilá · Verze: 2