Accueil › Architecture & design patterns › Ports primaires et secondaires : qui possède le contrat
Ports primaires et secondaires : qui possède le contrat
Ports, adaptateurs et hexagoneintermediaire
Un port est un contrat écrit par le domaine. Il décrit un besoin dans le vocabulaire du métier. Un adaptateur est le code qui relie ce contrat à une technologie précise.
Les ports vont par deux familles, selon qui déclenche l'appel.
// PORT PRIMAIRE (pilotant) — l'extérieur appelle le domaine.
// Le contrat est le cas d'usage lui-même.
export function creerClotureCommande({ commandes, horloge }) {
return function cloturer(idCommande) {
const c = commandes.parId(idCommande);
if (!c) return { ok: false, motif: "inconnue" };
if (c.lignes.length === 0) return { ok: false, motif: "vide" };
commandes.enregistrer({ ...c, closeLe: horloge.maintenant() });
return { ok: true };
};
}
commandes et horloge sont des ports secondaires : le domaine les appelle
pour agir sur le monde. cloturer est le port primaire : un adaptateur HTTP,
une commande en ligne, un consommateur de file le déclenchent.
// ADAPTATEUR PRIMAIRE — traduit du HTTP en appel de cas d'usage
app.post("/commandes/:id/cloture", (req, res) => {
const r = cloturer(req.params.id);
res.status(r.ok ? 200 : 409).json(r);
});
Le détail qui sépare une vraie hexagone d'un dossier interfaces/ est
ailleurs : qui possède le port. commandes.parId(id) est un besoin du
métier. base.executerRequete(sql) est une capacité de Postgres. Le second est
une indirection, pas une inversion.
Les termes à connaître
- Port
Un contrat défini par le domaine, exprimé avec son vocabulaire. Il décrit un besoin, pas une technologie.
- Port primaire
Le contrat par lequel on pilote l'application : un cas d'usage que le monde extérieur peut déclencher. On l'appelle aussi port pilotant.
- Port secondaire
Le contrat par lequel l'application pilote le monde extérieur : stocker, envoyer, lire l'heure. On l'appelle aussi port piloté.
- Adaptateur primaire
Le code qui traduit un événement extérieur — requête HTTP, commande CLI, message de file — en appel de port primaire.
- Adaptateur secondaire
L'implémentation concrète d'un port secondaire : dépôt SQL, client SMTP, horloge système.
- Propriété du port
Le critère décisif : le port appartient au domaine, qui le nomme selon son besoin. Un port écrit par l'infrastructure n'inverse rien.
- Dossier interfaces
Le contre-exemple courant : un paquet qui rassemble toutes les interfaces du projet. Les contrats y perdent leur propriétaire et leur sens.
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.