← 返回刚才阅读的位置

知识卡片

结构图卡 · 2283.w.3

整洁架构Java案例

理解等级:未标注

一个把[[整洁架构四层职责]]和[[跨边界的输出端接口]]落到具体实现的完整例子:Web服务器从用户处收集信息交给Controller(接口适配器层),Controller把这些信息包装成一个简单Java对象,穿过InputBoundary传给UseCaseInteractor(用例层);UseCaseInteractor解析数据、控制与Entities(业务实体层)的交互,同时通过DataAccessInterface把Entities需要的数据从Database(框架驱动层)加载进内存;UseCaseInteractor再从Entities收集数据、把结果组装成另一个简单Java对象OutputData,OutputData穿过OutputBoundary传给Presenter(接口适配器层)。Presenter的任务是把OutputData重新打包成可展示的ViewModel(同样是简单Java对象)——ViewModel基本只包含字符串和View要用的开关型数据:OutputData里的Date对象会被Presenter格式化成对用户展示的字符串填进ViewModel,Currency对象等业务数据也经历类似处理,Button和MenuItem的命名连同它们是否可用的开关数据也定义在ViewModel里。最后View(接口适配器层)除了把ViewModel的数据转换成HTML格式外,不承担任何其他功能。贯穿整条链路最值得注意的是依赖关系方向:所有跨边界的依赖箭头(Controller依赖InputBoundary;UseCaseInteractor实现InputBoundary,Presenter实现OutputBoundary,DataAccessInterface由Database一侧的实现类反向实现)无一例外都指向内层,完整遵守了整洁架构的依赖关系规则——这套划分让系统天生可测试(UseCaseInteractor和Entities的测试完全不需要真正的Web服务器或数据库),也让Web框架、数据库这些外层组件在过时时能被轻松替换,而不牵动内层的业务逻辑。

classDiagram
  class InputBoundary {<<interface>>}
  class OutputBoundary {<<interface>>}
  class DataAccessInterface {<<interface>>}
  Controller --> InputBoundary : 依赖
  UseCaseInteractor ..|> InputBoundary : 实现
  UseCaseInteractor --> OutputBoundary : 依赖
  UseCaseInteractor --> DataAccessInterface : 依赖
  UseCaseInteractor --> Entities : 调用
  Presenter ..|> OutputBoundary : 实现
  DataAccess ..|> DataAccessInterface : 实现
  Presenter --> ViewModel : 构造
  View --> ViewModel : 读取

接口与请求/响应数据属于内层,数据访问和展示实现位于外层;图表达源码依赖,不把运行数据流当作接口继承。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《架构整洁之道》第22章《整洁架构》"一个常见的应用场景""本章小结"(源文件:_epub-src/text/part0014_split_007.html) - 结论依据:原文详述Controller依赖InputBoundary;UseCaseInteractor实现InputBoundary→Entities/Database→OutputData→OutputBoundary→Presenter→ViewModel→View的完整数据流,并强调所有跨边界依赖箭头都指向内层、遵守依赖关系规则,说明这套结构使系统天生可测试且外层组件可被轻松替换,直接支撑本卡片的结构图与解释。 - 原始内容:Controller将这些信息数据包装成一个简单的Java对象……最后,OutputData会穿越OutputBoundary被传递给Presenter……View除了将ViewModel中的数据转换成HTML格式之外,并没有其他功能……所有跨边界的依赖线都是指向内的,这很好地遵守了架构的依赖关系规则。