Aller au contenu principal

Développement · Architecture

Couche anti-corruption

Une couche anti-corruption (anti-corruption layer, ACL) est une frontière de code qui traduit les modèles d'un système externe vers ceux de votre application, pour empêcher les concepts, les noms et les bizarreries de l'autre de « contaminer » votre domaine. Issue du Domain-Driven Design, elle s'incarne souvent dans un bridge ou une façade : tout ce qui vient de l'extérieur y est converti une fois, et le reste du code n'en voit jamais la forme brute.

Traduire, Pas Propager

La couche convertit les réponses externes — souvent verbeuses ou mal nommées — en objets internes propres. Le code métier manipule vos concepts, jamais des tableaux JSON venus d'ailleurs. Le jour où l'API distante renomme un champ ou change sa pagination, un seul fichier est touché : la traduction est centralisée, l'onde de choc s'arrête à la frontière.

Un Seul Point De Contact

Parce que tous les échanges passent par elle, la couche devient l'endroit naturel où poser le cache, les timeouts, la gestion d'erreur et les tests. Derrière une interface, elle se double facilement d'une fausse implémentation : l'application se teste hors-ligne, sans jamais appeler le système externe.

Quand j'en pose une

Je ne la pose pas devant chaque appel HTTP. Elle se justifie quand l'une de ces situations se présente :

Comment je la construis

  1. Une interface qui décrit le besoin du domaine, avec vos mots, et non le catalogue de l'API distante.
  2. Une implémentation réelle qui gère le transport : authentification, pagination, limites de débit, timeouts, erreurs, conversion vers des objets internes.
  3. Une fausse implémentation déterministe pour les tests, qui reproduit les mêmes validations que la vraie et s'arrête juste avant l'appel réseau. Un faux qui accepte tout laisse passer en test ce que la production refusera.
  4. Un câblage par environnement — l'implémentation réelle par défaut, la fausse en test. L'application démarre et se teste sans aucun accès au système externe.

Un exemple concret

Sur les applications Symfony que je maintiens pour Orange, les échanges avec les services internes du groupe — envoi de SMS, stockage objet, jetons OAuth, référentiels — passent tous par des bridges construits sur ce modèle, mutualisés dans une librairie partagée entre cinq applications. C'est grâce à eux que l'image Docker de production peut démarrer en CI, sans réseau vers les API internes, et y dérouler une vraie suite de tests end-to-end.

Sur l'une d'elles, l'application dépend d'une API d'annuaire et de tickets qu'elle ne maîtrise pas, lente et parfois indisponible. La façade qui centralise les appels a été l'endroit naturel pour poser un cache — en distinguant ce qui peut vieillir, comme l'annuaire, de ce qui doit rester vivant, comme le statut d'un ticket —, et une dégradation gracieuse qui renvoie une valeur neutre quand l'API tombe.

Les pièges

Une couche anti-corruption a un coût — du code de traduction à maintenir — qui se justifie quand le système externe est instable, mal conçu ou hors de votre contrôle. Face à une API maison rigide ou un legacy, c'est presque toujours rentable.

Le cas du cache derrière une façade est détaillé dans mettre une API externe en cache sans servir de données périmées. Isoler un legacy derrière une frontière propre est une étape clé de ma prestation de refonte d'application web.

Contact

Un projet en lien avec couche anti-corruption ?

Échangeons sur vos enjeux techniques. Pas de discours commercial, pas de jargon inutile : un diagnostic clair et des solutions concrètes.

Démarrer votre projet arrow_forward