Définition de la clean architecture
La clean architecture, littéralement « architecture propre », est un modèle d’organisation du code d’une application. Robert C. Martin l’a présentée dans un billet de son blog (blog.cleancoder.com), « The Clean Architecture », daté du 13 août 2012. L’auteur a ensuite publié un livre qui porte ce titre ; cette fiche s’appuie sur le billet.
Le billet se présente comme une synthèse. Il part de plusieurs modèles proches, dont l’architecture hexagonale d’Alistair Cockburn et l’« Onion Architecture » de Jeffrey Palermo, et constate qu’ils poursuivent le même but, la séparation des préoccupations, par le même moyen : un découpage en couches, avec au moins une couche pour les règles métier et une autre pour les interfaces. Le schéma en cercles concentriques qui ouvre le billet tente de les réunir en une seule idée.
Les propriétés recherchées par le modèle
Le billet énumère ce que ces architectures ont en commun. Un système ainsi construit ne dépend pas d’un framework, qu’il emploie comme un outil. Ses règles métier se testent sans interface, sans base de données et sans serveur web. L’interface peut changer sans toucher au reste, la base de données peut être remplacée, et les règles métier ignorent tout du monde extérieur.
Sa conclusion en tire une conséquence : un élément externe devenu obsolète, base de données ou framework web, se remplace à moindres frais. C’est une manière de contenir l’obsolescence, l’une des formes de la dette technique.
La règle de dépendance et les cercles du schéma
La règle de dépendance est énoncée ainsi : les dépendances du code source ne peuvent pointer que vers l’intérieur. Le code d’un cercle intérieur ne mentionne aucun nom déclaré dans un cercle extérieur, et n’emploie pas ses formats de données.
| Cercle, du centre vers l’extérieur | Contenu selon le billet |
|---|---|
| Entités | Règles métier valables pour toute l’entreprise ou, pour une application isolée, ses objets métier |
| Cas d’utilisation | Règles propres à l’application, qui orchestrent les échanges avec les entités |
| Adaptateurs d’interface | Conversion des données entre la forme utile aux cas d’utilisation et celle d’un agent externe ; le code SQL s’y cantonne |
| Frameworks et pilotes | Base de données, framework web : des détails, tenus à l’extérieur |
Il arrive qu’un cas d’utilisation doive appeler un élément extérieur, par exemple pour présenter un résultat. Le billet y répond par le principe d’inversion de dépendance : le cas d’utilisation appelle une interface déclarée dans son propre cercle, que l’élément extérieur implémente. Les données qui franchissent une frontière sont des structures simples, jamais une entité ni une ligne de base de données.
Clean architecture, couches classiques et outillage : ne pas confondre
La clean architecture n’est ni un framework ni un outil. Elle ne prescrit aucune technologie, puisqu’elle range les technologies dans le cercle extérieur.
Elle se distingue d’un empilement où la couche métier s’appuie sur la couche d’accès aux données. Ici, le sens s’inverse : le code lié à la base dépend des règles métier.
Elle n’est pas synonyme de l’architecture hexagonale, dont la fiche décrit les ports et les adaptateurs. Les deux séparent le métier de la technique. Le texte de Martin précise en outre l’ordre interne, entités puis cas d’utilisation, et formule une règle unique pour tous les cercles.
Le nombre de cercles n’est pas fixé : l’auteur qualifie son schéma d’indicatif.
Un cas d’école : la validation d’une note de frais
Prenons une application de notes de frais. Une entité « note de frais » porte les règles valables partout dans l’entreprise, comme le plafond par nature de dépense. Un cas d’utilisation « valider une note » enchaîne les étapes : charger la note, appliquer les règles, enregistrer la décision.
Pour charger et enregistrer, le cas d’utilisation déclare une interface de dépôt dans son propre cercle. Un adaptateur l’implémente avec la base de données de l’entreprise, un autre avec une liste en mémoire pour les tests. Le jour où la base change, le cas d’utilisation et l’entité ne sont pas modifiés.
Ce découpage a un coût : des interfaces et des conversions supplémentaires, qui peuvent paraître disproportionnées lorsque les règles métier sont peu nombreuses.
L’opportunité de l’adopter s’apprécie application par application, dans le cadre que fixe l’architecture SI, et se traduit dans le code au cours d’un développement sur mesure.