Réponse.

La couche Anti-Corruption (ACL) est un motif architectural qui est appliqué pour protéger le modèle de domaine interne de l'application contre l'influence des systèmes externes lors de l'intégration.

Pourquoi est-elle nécessaire : Lorsque votre système interagit avec d'autres (par exemple, en héritant des données et de la logique métier d'un ancien logiciel ou de services tiers), le contrat externe peut changer ou contenir des distorsions. L'ACL permet d'isoler le modèle interne des changements qui ne sont pas compatibles avec votre logique métier.

Comment l'implémenter : Des composants supplémentaires sont introduits - des adaptateurs et des façades, qui transforment les données/interfaces externes en objets internes. Cela peut inclure des services, des mappers, des classes DTO spéciales.

Exemple en Python :

class ExternalOrder:
    def __init__(self, order_id, amount, created_at):
        self.order_id = order_id
        self.amount = amount
        self.created_at = created_at

class InternalOrder:
    def __init__(self, id, total, timestamp):
        self.id = id
        self.total = total
        self.timestamp = timestamp

class OrderAdapter:
    @staticmethod
    def from_external(external_order):
        return InternalOrder(
            id=external_order.order_id,
            total=external_order.amount,
            timestamp=external_order.created_at
        )

Ici, OrderAdapter isole le système interne des changements de la structure de la commande externe.

Caractéristiques clés :

• Protection contre des changements non contrôlés dans les API externes.
• Transformation et filtrage des données selon vos règles.
• Minimisation de l'influence des domaines externes sur votre code.

Questions pièges.

Peut-on simplement utiliser une couche de mappers POJO/DTO au lieu d'un véritable ACL ?

Non, de simples mappers ne protègent pas la logique métier et ne sont pas des adaptateurs à part entière. ACL est une couche cohérente qui réalise une intégration protégée, y compris la transformation contextuelle des commandes, des événements et des erreurs métiers.

Combien de niveaux de transformation peut-on utiliser dans l'ACL ?

Autant que nécessaire pour assurer une isolation complète. En général, cela représente au moins deux niveaux : la transformation de la structure et le mapping de la logique métier (par exemple, les statuts, les codes d'erreur et les politiques d'accès).

Comment gérer correctement les erreurs des systèmes externes dans l'ACL ?

L'ACL doit intercepter et adapter les erreurs externes aux classes d'exception internes ou aux codes d'état. Ne jamais faire remonter directement les erreurs des systèmes tiers dans votre application.