知识卡片

结构图卡 · 2283.ai.4

用访问修饰符强制架构

理解等级:未标注

[[宽松分层的陷阱]]背后的病灶是滥用 public。所有类型都是 public,就放弃了语言的封装手段,包退化成文件夹,四种架构风格在语法上完全等同,都只是传统分层。认真设置访问修饰符,差异才会显现:按层封装只公开服务与仓储接口,实现类包内可见;按功能封装只公开控制器;端口和适配器只公开接口;按组件封装只公开组件接口。public 类型越少,潜在依赖越少,由编译器维护架构。

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

classDiagram
  class OrdersController
  class OrdersComponent {
    <<interface>>
  }
  class OrdersComponentImpl
  class OrdersRepository {
    <<interface>>
  }
  class JdbcOrdersRepository
  OrdersController --> OrdersComponent : 包外可见入口
  OrdersComponentImpl ..|> OrdersComponent
  OrdersComponentImpl --> OrdersRepository
  JdbcOrdersRepository ..|> OrdersRepository
  note for OrdersComponentImpl "package-private,非Java的protected顶层类"
  note for OrdersRepository "package-private,不允许包外Controller直接引用"
  note for JdbcOrdersRepository "package-private,只向包内开放"
这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 2 处

    • · 查看原书依据

      从另外一个角度来看,如果我们将Java程序中的所有类型都设置为public,那么包就仅仅是一种组织形式了(类似文件夹一样的分组方式),而不是一种封装方式。

    • · 查看原书依据

      Public类型越少,潜在的依赖关系就越少。

    参考来源

    - 位置:《架构整洁之道》第34章《拾遗》"具体实现细节中的陷阱""组织形式与封装的区别"(源文件:_epub-src/text/part0015_split_004.html) - 结论依据:原文指出public关键字被普遍滥用会让包退化成组织形式而非封装手段,导致四种架构风格在语法层面等同,并逐一说明四种组织方式该如何正确设置public/包内保护级别以恢复真正的封装边界、让编译器维护架构原则,直接支撑本卡片结论。 - 原始内容:将所有的类都设置为public意味着就无法利用编程语言提供的封装手段……四种架构方式事实上并没有任何区别……Public类型越少,潜在的依赖关系就越少……我们就可以利用编译器来维护架构设计原则了。