通过示例了解六角形端口和适配器的概念

时间:2018-10-11 19:34:31

标签: c# domain-driven-design

在谈论六边形体系结构时,我试图理解端口和适配器的含义。今晚我已经阅读了很多说明,但是我没有找到代码示例。因此,我将设计一个。我知道端口是接口。例如:

public interface IPerson
{
   string GetName();
}

和一个适配器作为实现接口的类:

public class Person : IPerson
{
  //Implementation of GetName here
}

我了解四个适配器模式的概念。但是,我不知道这如何适合DDD。

在DDD的上下文中看一个简单的代码示例确实有帮助。

2 个答案:

答案 0 :(得分:0)

  

适配器是实现接口的类

并非总是如此。对于驱动器端而言确实如此,但对于驱动器端而言,适配器是使用该接口(称为其方法)的软件组件。

我写了一篇有关端口和适配器模式(六角形体系结构)的概念文章:

https://softwarecampament.wordpress.com/portsadapters

在那里您可以了解到它。

  

今晚我已经阅读了很多说明,但是我没有找到   代码示例。

我刚刚发明的一些代码,向您解释实际使用的端口和适配器:

在网上商店中,驱动程序端口可能是:

    public interface ForManagingShoppingCart {
        public void addProductToShoppingCart ( String productId );
        // ... more methods ...
    }

驱动程序适配器可以是控制器,它从UI接收用户请求并调用驱动程序端口的方法:

    public class ShoppingCartController {

        private final ForManagingShoppingCart forManagingShoppingCart;

        // Injects port in the constructor
        public ShoppingCartController ( ForManagingShoppingCart forManagingShoppingCart ) {
            this.forManagingShoppingCart = forManagingShoppingCart;
        }

        // Method that executes when user selects a product in the view and clicks the "add product" button
        public void addProductOnClick ( String productId ) {
            this.forManagingShoppingCart.addProductToShoppingCart ( productId );
        }

    }

如果应用程序在您下订单时向您发送电子邮件,则驱动端口可能是:

    public interface ForNotifyingClients {

        public void sendPurchaseOrderConfirmation ( String recipient );

    }

该端口与技术无关,它不知道消息是否通过电子邮件发送。从动适配器使用电子邮件系统实现端口。

  

我了解四个适配器模式的概念。

之所以适合适配器模式,是因为您正在将端口接口方法转换为电子邮件系统接口方法。

    public class EmailNotificationAdapter implements ForNotifyingClients {

        private final EmailSystem emailSystem;

        // Inject the email system interface you want to use in the adapter constructor
        public EmailNotificationAdapter ( EmailSystem emailSystem ) {
            this.emailSystem = emailSystem;
        }

        // Implements the method using the email system to send an email
        @Override
        public void sendPurchaseOrderConfirmation ( String recipient ) {
            // ...code that sends an email to the recipient using this.emailSystem
        }

    }
  

我不知道这如何适合DDD ...这真的对我有帮助   在DDD的上下文中查看一个简单的代码示例。

DDD非常适合六角结构:

  • 应用层和域模型将位于六边形之内。
  • Application Services API将是六边形的驱动程序端口。
  • 表示层(UI)将是驱动程序适配器。
  • 基础结构层将包含从动适配器。
  • 当应用程序层或域模型需要处理技术时,它们定义了一个驱动端口,该驱动端口将在基础结构中实现。

答案 1 :(得分:0)

TLDR:端口和适配器与USB插头和USB插座不同。适配器是USB到Lightning电缆。

  

在谈论六角形体系结构时,我试图理解端口和适配器的含义。

有点纠结,尤其是因为

  1. 仅照片并不能讲故事
  2. 图片看起来很像洋葱,并以不同的方式讲故事。

两个嵌套的多边形(传统上是两个六边形)代表逻辑边界。 “核心域逻辑完全位于内部多边形内。在外部多边形之外是真实世界:消息总线,数据库,UI,文件系统等。所有这些都有端口。

例如,在交互式外壳中,您的端口是stdin,stdout和stderr。

适配器是我们放置的东西,因为外边界的端口和内边界的端口不匹配。我的域模型不讲SQL,所以我在我的域模型和数据库客户端之间有一个适配器。我的域模型不了解终端格式,因此我有一个适配器位于域模型和交互式外壳之间。

其中的一个神奇之处在于,我们可以通过更改适配器将新组件组装在一起。我的域逻辑也不知道HTML表示,但是我应该能够用Web浏览器适配器替换交互式外壳适配器,并为用户提供一种与域模型进行交互的新方法。通过使用新的适配器与新的稳定存储设备进行通信,我应该能够切换出持久性策略。

端口通常将成为接口,因为我们在边界处关心的是明确定义需要满足的合同,而无需与特定的实现耦合。

  

我不知道这如何适合DDD。

很难理解其适合性的一个原因;端口和适配器是管道,不是域模型。证明进行域分析的工作合理的所有位都位于内部多边形内部。

存储库和域服务是适配器的常见形式。域服务通常是端口,其实现由应用程序或基础结构组件提供。同样,存储库通常是应用程序和存储的聚合集合之间的适配器形式。

推荐读物: * Ports and Adapters Architecture @ c2 Wiki