六边形架构（端口适配器）指南 - 8thlight

端口和适配器是一种架构模式，旨在将您的应用程序与细节解耦。
我的经验证实了这一说法。在最近的一个项目中，我们的团队决定从端口和适配器架构开始，随着我们团队的成长，它得到了回报。我们的团队正在构建一些需要集成的服务。端口和适配器让我们可以进行一些集成，并将我们的域模型与我们的数据库模式分离，这为我们的团队提供了灵活性，并将我们的应用程序与这些细节隔离开来。
但这是有代价的。我们的架构选择意味着加入我们项目的人们面临着学习曲线。大多数人不熟悉这种模式。或者可能听说过，但还没有实践经验。
我自己理解端口和适配器的道路是曲折的。我在网上看到很多用六边形来可视化模式的图表，但很难找到一个具体的例子来帮助我形成自己的心智模型。
如果您有类似的经历并放弃了，或者目前正在尝试理解端口和适配器，我提供这篇文章：
 
分层架构
要理解端口和适配器，我认为将其与更常见的 Web 应用程序架构模式（如分层架构）一起查看会很有帮助。MVC模式的控制器与您的业务逻辑交互，而业务逻辑与数据库交互。这是一个很好的模式。它很简单，它可以让您快速启动和运行！但分层架构可能并不总是最合适的。例如，在我们的项目中，分层架构对于新手来说可能更容易上手，但我们会失去敏捷性。

 
端口和适配器
端口和适配器就像一个分层的架构，但是它插入了端口来反转依赖的方向。它在您的控制器和您的应用程序之间插入端口，也就是在您的应用和您的数据库的适配器或称ORM 之间。
一个 端口 是操作系统端口的隐喻。在这个例子中， 一个端口就是一个接口。

图中的端口是红色和黄色框。这里的颜色差异是有意的，因为有两种端口： 传入端口和 传出端口。
传入端口将是您的应用程序实现的接口 。出站端口是您的应用程序所依赖的接口 。“传入”和“传出”是我们团队采用的术语。“驱动端口”和“驱动端口”是您可能会在其他文献中找到的术语。
这给我们留下了适配器。就像端口一样，有两种适配器：传入，用蓝色表示；和外向，以紫色表示。这里的区别是传入适配器 取决于传入端口，传出适配器 实现传出端口。
端口和适配器不仅适用于 Web 框架。传入适配器和传出适配器不限于由控制器和数据库适配器来实现。它们可以通过任何类型的适配器来实现。
例如，命令行接口可以满足您的传入适配器，而 HTTP 客户端可以满足您的传出端口。我的示例仅描述了传入和传出端的一个适配器和端口，但您可以根据需要拥有多个！
 
示例应用
让我们看一个受SmallerWebHexagon启发的具体示例，Alistair Cockburn 关于端口和适配器的博客文章中引用 了该示例 。
假设我们有一个 Web 应用程序，它将接受一个数字并对其应用一个比率。我根据每个组件在端口和适配器图中的作用对组件进行了颜色编码。

组件分解如下：

• RatingUseCase 是一个传入端口。它是RatingApplication 将实现 的接口， KtorHttpAdapter 将依赖于它。
•  RatingApplication 图中的对应于“应用程序使用案例”。这是我们关键业务逻辑所在的地方。这可以说是最重要的组件，它不受我们使用的 Web 框架或 ORM 等细节的影响。
•  RatingProvider 黄色是我们的输出端口。这是应用程序获取正确速率所依赖的抽象，也是传出适配器将实现的接口。
•  InCodeRater 是即将离任的适配器。它实现 RatingProvider 接口并获取应用程序的费率。想象一下，我们需要从文件或数据库中获取此速率的未来。我们可以添加此行为而无需修改我们的核心应用程序！
• KtorHttpAdapter 是输入适配器。它取决于传入端口，它将通过其构造函数接受它。这是将驱动我们的应用程序的适配器。
• 最后，还有 main 配置 RatingApplication with InCodeRater 和 KtorHttpAdapter with RatingApplication 并启动服务器的功能。