知识卡片

结构图卡 · 2283.ai.1

端口和适配器

理解等级:未标注

相比[[按层与按功能封装]],端口和适配器(六边形架构等)把代码分成内部领域与外部基础设施:内部包含所有领域概念,外部负责与 UI、数据库、第三方系统交互,只允许外部依赖内部。一个细节是订单仓储接口改名为“订单”:按领域驱动设计,内部代码应使用领域语言,业务上讨论的是“订单”,而不是暴露技术实现的“订单仓储”。命名本身也是划清内外边界的手段。

结构图: 类图(使用依赖指向被使用者,空心三角指向抽象父类型;原图未给出方法签名,不补造):

classDiagram
  class OrdersController
  class OrdersService {
    <<interface>>
  }
  class OrdersServiceImpl
  class Orders {
    <<interface>>
  }
  class JdbcOrdersRepository
  OrdersController --> OrdersService : 外部依赖内部
  OrdersServiceImpl ..|> OrdersService
  OrdersServiceImpl --> Orders
  JdbcOrdersRepository ..|> Orders : 外部实现领域端口
这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 2 处

    • · 查看原书依据

      内部区域包含了所有的领域概念,而外部区域则包含了与外界交互的部分(例如UI、数据库、第三方集成等)。

    • · 查看原书依据

      这里主要的规则是,只有外部代码能依赖内部代码,反之则不能。

    参考来源

    - 位置:《架构整洁之道》第34章《拾遗》"端口和适配器"(源文件:_epub-src/text/part0015_split_004.html) - 结论依据:原文说明端口和适配器将代码分为领域(内部)与基础设施(外部)两个区域、只允许外部依赖内部,并指出OrderRepository被改名为Orders是领域驱动设计要求内部代码使用独特领域语言的体现,直接支撑本卡片结论。 - 原始内容:内部区域包含了所有的领域概念,而外部区域则包含了与外界交互的部分……这里主要的规则是,只有外部代码能依赖内部代码,反之则不能……这个概念基于领域驱动设计理念,其中要求内部代码都应该用独特的领域语言来描述。