知识卡片

普通读书笔记卡 · 1940.h.1.e.1

类图的布局约定

理解等级:中级

一张好类图的价值既在于画了什么,也在于没画什么。书中 ATM 类图的做法可以借鉴:

  • 标清接口:费力标出所有接口,让读者马上知道哪些类是接口、哪些是实现,例如 WithdrawalTransaction 使用 CashDispenser 接口,至于由谁实现并不在这张图关心范围内。
  • 只放代表性方法:WithdrawalUI 实际方法不止图中两个,但全放会让图混乱,给出代表性方法就足以传达设计思路。
  • 横向关联、纵向继承:帮助区分两类完全不同的关系。
  • 分区与规则连接:交易及其动作在左,各 UI 接口在右,UI 实现在底部;区域间连接降到最少且方向一致(三条关联同向,三条继承合并到一条线)。

看图时应能想象出代码,例如抽象类 UI 同时实现 WithdrawalUI、DepositUI、TransferUI,持有 Screen 和 MessageLog,DisplayMessage 先记日志再显示。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 第19章 类图 · 查看原书依据

      注意我是如何将图分成三个不同区域的。事务及其动作在图的左侧,各种UI接口都在右侧,UI实现在底部。另外注意,这些区域之间的连接被限制在最低程度并且是规则的。

    参考来源

    - 位置:《敏捷开发(纪念版)》第19章《第19章 类图》类图示例(源文件:extracted/敏捷开发(纪念版)/_epub-src/Min Jie Kai Fa (Ji Nian Ban )_split_029.html,来源项目 book-sources) - 结论依据:原文以 ATM 类图说明标明接口、只放代表性方法、横向关联纵向继承、分区布局与规则连接等约定,并给出对应的 UI 抽象类代码以说明看图应能想象代码。 - 原始内容:注意我是如何将图分成三个不同区域的。事务及其动作在图的左侧,各种UI接口都在右侧,UI实现在底部。另外注意,这些区域之间的连接被限制在最低程度并且是规则的。