Aller au contenu
Cabinet d'expertise en transformation technologique · ARDIANE Group Innover, sécuriser, réussir

Lexique

Architecture hexagonale : définition, ports et adaptateurs

Domaine

Ingénierie

L'essentiel

L'architecture hexagonale, aussi appelée ports et adaptateurs, est un modèle de conception décrit par Alistair Cockburn qui sépare le cœur d'une application de ce qui l'entoure : interface, base de données, autres systèmes. L'application échange avec l'extérieur par des ports, définis par l'objet de l'échange, et chaque technologie s'y branche par un adaptateur remplaçable.

Sommaire de la page

Définition de l’architecture hexagonale

L’architecture hexagonale est un modèle de conception d’une application qui en sépare l’intérieur, où se trouve la logique métier, de l’extérieur, où se trouvent les interfaces, les bases de données et les autres systèmes. Elle a été décrite par Alistair Cockburn dans un rapport technique publié sur son site (alistair.cockburn.us) et daté de 2005. Le modèle y porte le nom de « Ports and Adapters », ports et adaptateurs, avec « Hexagonal Architecture » pour autre nom.

L’intention affichée par l’auteur tient en une phrase : permettre qu’une application soit pilotée indifféremment par des utilisateurs, des programmes, des tests automatisés ou des traitements par lots, et qu’elle soit développée et testée à l’écart des équipements et des bases de données qu’elle utilisera en service.

Le défaut visé : une logique métier mêlée à l’interface et à la base

Cockburn part de deux constats. Du côté de l’utilisateur, la logique métier s’infiltre dans le code de l’interface : les tests automatisés dépendent alors de détails d’affichage, et l’application ne peut être pilotée ni par un traitement par lots, ni par un autre programme. Du côté des données, la logique se lie à une base précise : lorsque celle-ci est indisponible ou remplacée, les développeurs sont arrêtés.

Il y voit une seule erreur, l’enchevêtrement de la logique métier et des échanges avec l’extérieur, et en tire une règle : ce qui appartient à l’intérieur ne doit pas fuir vers l’extérieur. Les tests de non-régression exécutés sans interface servent aussi à détecter une telle fuite. Notre article sur les tests automatisés traite de leur organisation.

Ports, adaptateurs, côté primaire et côté secondaire

Le modèle repose sur deux notions et une distinction.

  • Le port est une conversation entre l’application et l’extérieur, définie par son objet et non par une technologie. Il prend la forme d’une interface de programmation.
  • L’adaptateur convertit cette interface vers une technologie donnée, et inversement. Plusieurs adaptateurs peuvent se brancher sur un même port : un écran, un jeu de tests et une interface HTTP d’un côté, une base SQL, un fichier ou un substitut en mémoire de l’autre.
  • Un port est dit primaire lorsque l’acteur extérieur pilote l’application, secondaire lorsque c’est l’application qui le sollicite.

L’hexagone n’a pas six côtés par nécessité : selon l’auteur, la figure donne la place de dessiner les ports et rompt avec l’image des couches empilées. Le nombre de ports est affaire de jugement. Cockburn indique en retenir un petit nombre : deux, trois ou quatre.

Architecture hexagonale, couches et clean architecture : ne pas confondre

L’architecture en couches empile présentation, traitements et données. Cockburn lui reproche deux choses : les limites entre couches ne sont pas prises au sérieux, et une application peut avoir plus de deux ports, ce que l’empilement ne représente pas.

La clean architecture de Robert C. Martin range l’architecture hexagonale parmi les modèles qu’elle cherche à réunir. L’article de Cockburn traite de la frontière entre l’application et l’extérieur ; le texte de Martin ordonne en plus le logiciel en cercles concentriques soumis à une règle de dépendance, présentée dans la fiche qui lui est consacrée.

Le modèle décrit enfin une application et sa frontière. Le découpage d’un système en services déployés séparément est une autre décision.

Exemple : un calcul de tarif d’expédition et ses adaptateurs

Soit une application qui calcule le tarif d’expédition d’un colis. Son cœur contient les règles de calcul. Un port primaire, « demander un tarif », reçoit trois adaptateurs : l’écran des agents, une interface HTTP ouverte aux sites marchands et un jeu de tests automatisés. Un port secondaire, « lire la grille tarifaire », en reçoit deux : la base de données de l’entreprise et une grille en mémoire pour les tests.

Lorsque l’entreprise change de base de données, seul un adaptateur est réécrit, et les tests du calcul restent valables. La contrepartie est un nombre plus élevé d’interfaces et de conversions à écrire, qui peut peser plus qu’il ne rapporte sur une application dont la logique métier est mince.

Le recours à ce modèle se décide parmi les règles de conception que pose l’architecture SI, et s’applique lors d’un développement sur mesure.

FAQ

Questions fréquentes

Une autre question ? Posez-la-nous

Qu'est-ce que l'architecture hexagonale ?

L'architecture hexagonale est un modèle de conception logicielle décrit par Alistair Cockburn sous le nom de ports et adaptateurs. Le cœur de l'application ne communique avec l'extérieur que par des ports, et chaque technologie (écran, base de données, autre programme) s'y raccorde par un adaptateur. L'application peut ainsi être développée et testée sans son interface ni sa base de données.

Pourquoi parle-t-on d'hexagone ?

Le nombre six n'a pas de signification. Alistair Cockburn écrit que l'hexagone laisse à celui qui dessine la place d'ajouter des ports et des adaptateurs, et qu'il rompt avec le schéma en couches empilées. La figure met en avant l'opposition entre l'intérieur et l'extérieur de l'application, à la place de l'opposition entre le haut et le bas.

Quelle est la différence entre un port et un adaptateur ?

Un port désigne une conversation entre l'application et l'extérieur, définie par son objet et exprimée sous la forme d'une interface de programmation. Un adaptateur traduit cette interface pour une technologie donnée. Un même port accepte plusieurs adaptateurs : pour un port de stockage, une base SQL, un fichier ou un substitut en mémoire réservé aux tests.

Qu'est-ce qu'un adaptateur primaire et un adaptateur secondaire ?

Dans l'article d'Alistair Cockburn, un adaptateur primaire sert un acteur qui pilote l'application : un utilisateur, un autre programme, un jeu de tests automatisés. Un adaptateur secondaire relie l'application à un acteur qu'elle sollicite, pour obtenir une réponse ou notifier un fait : une base de données, par exemple. La distinction tient à celui qui déclenche l'échange.

Un projet à faire aboutir ?

Un premier échange suffit pour situer votre enjeu, identifier les bons interlocuteurs et vous dire franchement ce que nous pouvons apporter.