Formations — 1 037 leçons en français

Accueil › Architecture & design patterns › Entité ou objet-valeur, et comment trancher

Entité ou objet-valeur, et comment trancher

Modéliser le domaineintermediaire

Deux sortes d'objets, et un seul critère pour choisir.

Une entité a une identité qui lui survit. Changez son nom, son adresse, son statut : c'est toujours la même personne, la même commande, le même compte. On suit son histoire.

Un objet-valeur est défini par ses attributs. Deux instances portant les mêmes valeurs sont interchangeables. Personne ne demande « quel exemplaire du montant 10 EUR est-ce ? ».

// Objet-valeur : égal par valeur, immuable, remplacé et non modifié
class Argent {
  constructor(centimes, devise) {
    this.centimes = centimes;
    this.devise = devise;
    Object.freeze(this);
  }
  egale(autre) {
    return this.centimes === autre.centimes && this.devise === autre.devise;
  }
  plus(autre) {
    if (autre.devise !== this.devise) throw new Error("devises differentes");
    return new Argent(this.centimes + autre.centimes, this.devise);
  }
}

// Entité : égale par identifiant, son état évolue
class Commande {
  constructor(id) {
    this.id = id;
    this.lignes = [];
  }
  egale(autre) {
    return this.id === autre.id;
  }
}

Le test de décision tient en trois questions. Son identité survit-elle au changement de tous ses attributs ? Deux exemplaires aux mêmes valeurs sont-ils interchangeables ? Suit-on son histoire dans le temps ? Une seule réponse « oui » à la première ou à la troisième suffit à en faire une entité.

Par défaut, préférez l'objet-valeur : il est immuable, comparable, testable sans contexte, et il n'exige ni identifiant ni cycle de vie.

Les termes à connaître

Entité

Un objet défini par une identité qui lui survit : ses attributs peuvent tous changer, c'est toujours lui.

Objet-valeur

Un objet défini par ses attributs : deux instances aux mêmes valeurs sont interchangeables, et on ne suit pas leur histoire.

Égalité par valeur

Comparer deux objets sur l'ensemble de leurs attributs, et non sur une référence ou un identifiant.

Immuabilité

La propriété d'un objet dont l'état ne change jamais après construction : on le remplace au lieu de le modifier.

Identifiant

La clé stable d'une entité, attribuée à la création et jamais réutilisée — ce n'est pas une donnée métier modifiable.

Obsession des types primitifs

La tendance à représenter un concept métier par une chaîne ou un nombre nu, ce qui disperse ses règles de validité dans les appelants.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.