CKTIS / Java
Třídy založené na hodnotě a identita objektů
Instance tříd založených na hodnotě, například LocalDate, porovnávejte pomocí equals, nikoli podle identity referencí. Stejné hodnoty považujte za zaměnitelné a nikdy je nepoužívejte jako zámky synchronizace.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
a.equals(b)Hodnota místo identity
Value-based classes and identity popisuje kontrakt tříd založených na hodnotě. U LocalDate záleží na datu: instance, které jsou podle equals stejné, považujte za zaměnitelné. Porovnávejte je pomocí a.equals(b), nikoli pomocí a == b.
Třídy založené na hodnotě mají pouze final instanční pole; odkazované objekty však mohou být proměnlivé. Jejich metody equals, hashCode a toString závisejí na hodnotách polí, nikoli na identitě. Tovární metody neslibují při každém volání novou identitu; přístupné konstruktory nejsou k dispozici nebo jsou zastaralé.
Nerozlišujte stejné instance pomocí hashování identity ani mechanismů serializace závislých na identitě. Nepoužívejte synchronized (a): výhradní vlastnictví monitoru není zaručeno. Chování související s identitou se může v budoucích vydáních změnit; synchronizace pak může selhat.
Příklad používá neměnný LocalDate. a a b představují stejné datum, takže equals vrátí true. plusDays(1) vytvoří následující datum, aniž změní a. Kód záměrně netestuje ==.
Příklady
import java.time.LocalDate;
public class Main {
public static void main(String[] args) {
LocalDate a = LocalDate.of(2024, 2, 29);
LocalDate b = LocalDate.parse("2024-02-29");
System.out.println(a.equals(b));
System.out.println(a.plusDays(1));
System.out.println(a);
}
}Výsledek
true 2024-03-01 2024-02-29
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.