Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Classes baseadas em valores e identidade dos objetos

Compare instâncias de classes baseadas em valores, como LocalDate, com equals e não pela identidade das referências. Trate valores iguais como permutáveis e nunca os utilize como bloqueios de sincronização.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

a.equals(b)

O valor em vez da identidade

Value-based classes and identity descreve o contrato das classes baseadas em valores. Em LocalDate, a data é o que importa: as instâncias que são iguais segundo equals devem ser tratadas como permutáveis. Compare-as com a.equals(b), não com a == b.

As classes baseadas em valores têm apenas campos de instância final; os objetos referenciados podem, ainda assim, ser mutáveis. Os métodos equals, hashCode e toString dependem dos valores dos campos, não da identidade. As fábricas não prometem uma identidade nova em cada chamada; os construtores acessíveis não existem ou estão obsoletos.

Não distingua instâncias iguais através do hash de identidade nem de mecanismos de serialização sensíveis à identidade. Não utilize synchronized (a): a propriedade exclusiva do respetivo monitor não é garantida. O comportamento relacionado com a identidade pode mudar em versões futuras; a sincronização pode deixar de funcionar.

O exemplo utiliza LocalDate, que é imutável. a e b representam a mesma data, pelo que equals devolve true. plusDays(1) produz a data seguinte sem alterar a. O código não testa == deliberadamente.

Exemplos

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);
    }
}

Resultado

true
2024-03-01
2024-02-29

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes