CKTIS / Java
Objects.equals: bezpečné porovnávanie objektov s null
Pomocou `Objects.equals(a, b)` porovnáš objekty podľa pravidiel metódy `equals`, aj keď jeden alebo oba argumenty môžu mať hodnotu `null`.
Verzia: Java SE 21
Syntax
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á metóda triedy java.util.Objects, ktorá vracia hodnotu typu boolean. V OpenJDK 21, ak platí a == b, metóda hneď vráti true bez volania a.equals(b). Platí to, keď obe referencie odkazujú na ten istý objekt alebo keď majú oba argumenty hodnotu null. Ak je výsledkom a == b hodnota false, metóda vráti false, keď je a rovné null; inak zavolá a.equals(b) a vráti výsledok tohto volania. Pri tomto volaní kontrakt metódy equals vyžaduje výsledok false, ak je b rovné null. Na rozdiel od priameho volania a.equals(b) metóda nevyvolá NullPointerException len preto, že a má hodnotu null.
Pri dvoch referenciách dá == hodnotu true, ak obe odkazujú na ten istý objekt alebo ak sú obe null. Obsah neporovnáva. Keď Objects.equals zavolá a.equals(b), použije pravidlo rovnosti definované triedou objektu a. Napríklad String.equals porovnáva postupnosti znakov, zatiaľ čo zdedená implementácia Object.equals kontroluje iba identitu objektov.
Ak dôjde k volaniu a.equals(b), Objects.equals neopraví chybnú implementáciu equals ani nezachytí výnimky, ktoré táto implementácia vyvolá. Objects.equals neporovnáva prvky polí. Na porovnanie obsahu polí vrátane vnorených použi Objects.deepEquals(a, b).
Prí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ýsledok
true false true false false
`new String(a)` vytvorí samostatný objekt `String` s rovnakým textom, takže `Objects.equals(a, b)` vráti `true`, ale `a == b` vráti `false`. Posledné tri riadky ukazujú výsledok pre dva argumenty `null` a pre jediný argument `null` na každej z dvoch pozícií.
Súvisiace lekcie
- Java · Lekcia 28 · Stredne pokročilá · Verzia: 2