Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

Classes fondées sur la valeur et identité des objets

Comparez les instances de classes fondées sur la valeur, comme LocalDate, avec equals plutôt qu’avec l’identité des références. Traitez les valeurs égales comme interchangeables et ne les utilisez jamais comme verrous de synchronisation.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

a.equals(b)

La valeur plutôt que l’identité

Value-based classes and identity décrit le contrat des classes fondées sur la valeur. Pour LocalDate, c’est la date qui compte : les instances égales selon equals doivent être considérées comme interchangeables. Comparez-les avec a.equals(b), et non avec a == b.

Les classes fondées sur la valeur n’ont que des champs d’instance final ; les objets référencés peuvent néanmoins être mutables. Leurs méthodes equals, hashCode et toString dépendent des valeurs des champs, et non de l’identité. Les fabriques ne garantissent pas une nouvelle identité à chaque appel ; les constructeurs accessibles sont absents ou obsolètes.

Ne distinguez pas des instances égales au moyen du hachage d’identité ou de mécanismes de sérialisation sensibles à l’identité. N’utilisez pas synchronized (a) : la propriété exclusive de son moniteur n’est pas garantie. Le comportement lié à l’identité peut changer dans de futures versions ; la synchronisation peut alors échouer.

L’exemple utilise LocalDate, qui est immuable. a et b représentent la même date, donc equals renvoie true. plusDays(1) produit la date suivante sans modifier a. Le code ne teste volontairement pas ==.

Exemples

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

Résultat

true
2024-03-01
2024-02-29

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources