来源书籍

敏捷开发(纪念版)

Skill 版本:v23 软件设计与开发方法类 经典原理(高信息浓度 + 高稳定性) 180 张卡片

罗伯特·C.马丁(Robert C. Martin) · 清华大学出版社 · 纪念版 · ISBN 9787302581901

类别清单覆盖

尚未完成类别清单核对。

全书导读

这本书是 Robert C. Martin(“鲍勃大叔”)关于敏捷软件开发的 C# 版经典,书名虽是“敏捷开发”,篇幅最大的却是面向对象设计。作者的核心主张是:团队要在需求不断变化时仍能快速交付,单靠一套过程是不够的,还需要能让代码容易修改的设计原则和模式。因此全书把三类知识放在一起讲:极限编程(XP)一类的实践、SOLID 与组件设计的原则、以及 GoF 一系的模式,并用 Payroll(薪水支付系统)这个贯穿后半本的案例把三者串起来。

阅读时需要注意几点。第一,书中示例使用 C# 和 .NET,NUnit、Windows Forms、SQL Server 等都是写作年代的工具,它们只是承载原则的例子。第二,书中的 UML 图多为白板草图,作者反复强调“图要用代码验证”,不要把图当成设计本身。第三,Payroll 案例是边写测试边演进的,前面章节画的图在后面会被代码推翻,这正是作者想展示的过程,而不是笔误。

全书主线

全书主线可以概括为“价值观 → 实践 → 设计原则 → 建模工具 → 模式 → 案例中的组件与架构”。

开篇的敏捷宣言与十二条原则给出价值排序:人和互动、可工作的软件、客户合作、响应变化。第Ⅰ部分把这些价值落实为 XP 实践:用户故事、短迭代、速率驱动的计划、测试驱动开发、重构、结对与持续集成,并用保龄球记分程序展示一次真实的结对编程。

第Ⅱ部分转向设计:腐化的软件会表现出僵化、脆弱、牢固、粘滞、不必要的复杂和重复、晦涩七种臭味,敏捷设计就是在臭味出现时用原则去除它们。随后逐章讲 SRP、OCP、LSP、DIP、ISP 五条类设计原则,再讲 UML 应该怎样少而精地使用,最后用咖啡机练习示范如何从问题本质中找抽象。

第Ⅲ、Ⅳ部分是 Payroll 案例:先讲命令、主动对象、模板方法、策略、外观、中介者、单例、单状态、空对象等模式,再用它们完成第一轮迭代的设计与实现;第Ⅳ部分引入组件设计的六条原则(REP、CRP、CCP、ADP、SDP、SAP)与度量,重新划分 Payroll 的组件,并讲工厂、组合、观察者、适配器、桥接、代理、访问者、状态等模式,最后为 Payroll 加上数据库和用户界面。

两篇附录从反面和理论上收束全书:一个讽刺故事对比阶段门控的死亡行军与按速率取舍的迭代团队;Jack Reeves 的文章论证“源码才是软件设计”,为全书“用代码验证设计”的立场提供理论依据。

敏捷宣言

书前先列出 2001 年敏捷联盟的宣言原文:个人和互动优先于过程和工具,可以工作的软件优先于详尽的文档,客户合作优先于合同谈判,应对变化优先于遵循计划,并说明右项仍有价值,只是左项更重要。宣言的逐条解释在第1章展开。

敏捷宣言的原则

这一页列出宣言背后的十二条原则,如尽早持续交付、欢迎需求变化、以可工作的软件衡量进度、可持续的开发节奏、关注技术卓越、尽量简化、自组织团队与定期反思。逐条讲解同样在第1章。

面向对象设计的原则

书前的速查页列出类设计的五条原则(SRP、OCP、LSP、DIP、ISP)以及组件设计的内聚原则(REP、CCP、CRP)和耦合原则(ADP、SDP、SAP),对应第8–12章与第28章。

极限编程实践

速查页列出 XP 的实践:完整团队、计划游戏、客户测试、简单设计、结对编程、测试驱动开发、设计改进、持续集成、集体代码所有权、编码标准、隐喻与可持续的速度。这些实践在第2章逐一介绍。

推荐序

推荐序介绍本书在敏捷和面向对象设计领域的地位,以及纪念版出版的背景,不包含独立的技术论证。

前言

前言首先给敏捷开发下定义:在需求快速变化时仍能快速开发软件的能力。敏捷由实践原则模式构成说明这种能力来自实践、原则、模式三类知识的组合:实践提供纪律和反馈,原则让代码保持灵活,模式是原则在常见问题上的成熟解法,三者缺一都会让团队在变化面前失速。

前言还记录了作者与 Kent Beck 及 XP 的关系。作者最初最大的顾虑是 XP 没有明显的前期设计阶段,但用代码验证设计图回顾自己的咨询经历后发现,自己也从不依赖独立的设计阶段:总是先画一两个小时的图,再用代码检验这些图是否有意义。设计与编码不是先后分离的两步,这一点贯穿全书,并在附录B得到理论化。

原书依据 · 2 处

第Ⅰ部分 敏捷开发

第Ⅰ部分回答“敏捷团队怎样工作”:先讲宣言和原则,再讲 XP 的具体实践、计划方法、测试与重构,最后用一次结对编程的完整记录展示这些实践如何在代码中发生。

第1章 敏捷实践

第1章从“过程膨胀”讲起。过程膨胀的恶性循环描述了一个自我强化的循环:项目出错后团队补充约束,约束越多过程越臃肿,项目更慢更差,团队又把失败归因于过程不够。敏捷联盟正是为打破这个循环而成立的,敏捷宣言四组价值排序用一张表整理了宣言的四组价值排序。

接下来逐条解释宣言。先组建团队再配环境讲“个人和互动”:沟通协作比编程能力更重要,应先组建团队,再让团队按需配置环境。简短文档与文档第一定律讲“可以工作的软件”:只维护短小的原理与结构文档,作者称之为文档第一定律——除非迫切需要且意义重大,否则不写文档。合同应约定合作方式讲“客户合作”:最好的合同约定双方如何合作,而不是事先固定需求、工期和价格。计划详细度随远近递减讲“应对变化”:计划详细度应随时间远近递减,下周细到具体任务,接下来三个月只大致了解需求,一年以后只有模糊印象。

随后挑选若干原则展开。尽早频繁交付提升质量引用研究说明初始交付越少、交付越频繁,最终质量越高;以可工作软件衡量进度主张只用可工作的软件衡量进度;可持续的开发节奏把项目比作马拉松,要求可持续的节奏;高质量才能保持速度指出高质量才能保持高速度,并要求今天只做今天需要的事;自组织团队共担责任说明最好的架构、需求和设计出自自组织团队,责任由整个团队共担,团队还要定期反思和调整。

原书依据 · 11 处

第2章 极限编程概述

第2章介绍 XP 的各项实践。客户是团队的一员说明客户(定义特性和优先级的人)是团队成员,最好与开发者坐在一起;用户故事是对话提醒把用户故事定义为对话的提醒,而不是详细需求;迭代与发布的预算规则给出两周迭代、按上次完成量做预算的规则,发布则覆盖约三个月的工作。验收测试即需求文档说明验收测试由客户编写并尽量自动化,最终成为真正的需求文档。

开发方面,结对编程与轮换讲结对编程以及每天至少轮换一次搭档,让知识在团队中扩散;测试先行促成解耦说明测试先行迫使代码可单独测试,从而促成解耦;集体代码所有权讲集体代码所有权,任何结对都可以修改任何模块;每天多次持续集成要求每天多次集成并保持构建通过;开放工作空间描述开放工作空间。

计划与设计方面,规划游戏的职责划分把规划游戏的职责划分为业务人员决定特性重要性、开发者决定实现成本;简单设计三条咒语给出简单设计的三条咒语:考虑能工作的最简单方案、你不会需要它、一次且只有一次;持续小步重构主张持续小步重构,每一步都运行测试;系统隐喻是全景图说明系统隐喻是把整个系统联系在一起的全景图,它决定了命名和结构。

原书依据 · 13 处

第3章 计划

第3章把 XP 的计划方法讲得更具体。用相对点数估算故事说明开发者用相对点数估算用户故事,点数不是绝对时间;拆分合并后重新估算强调故事被拆分或合并后要重新估算,而不是对点数做加减法。速率驱动下轮计划给出最核心的规则:下轮迭代的计划速率由上轮实测速率决定。

发布内容由业务决策说明发布和迭代包含哪些故事是业务决策,由业务人员在开发者给出的预算内选择。以验收测试定义完成要求以验收测试定义故事是否完成;任务认领与个人预算讲任务拆分与认领:每个开发者有按上轮完成量设定的个人预算,认领到预算为止。迭代中点检查完成故事建议在迭代中点检查已完成的故事数量,如果只完成一半以下,就要和客户重新安排;速率图与燃尽图介绍速率图和燃尽图,让管理者一眼看出团队进展和发布还需多少时间。

原书依据 · 8 处

第4章 测试

第4章讲测试如何影响设计。TDD的三条规则给出测试驱动开发的三条规则:先写失败的测试,只写足以失败的测试,只写足以通过测试的产品代码。意图编程让测试驱动设计说明先写测试就是“意图编程”:在测试里先写出期望的调用方式,接口由使用者视角决定。

用Mock对象隔离协作者用工资程序的例子说明如何用 Mock 对象隔离协作者,让被测对象的依赖变成接口,这同时也是解耦。验收测试推动架构解耦说明验收测试会推动系统架构解耦:为了让客户的测试能绕过界面直接驱动业务规则,系统自然形成可测试的分层结构。

原书依据 · 4 处

第5章 重构

第5章借 Fowler 的定义解释重构:不改外在行为而改进内部结构。软件模块的三项职责指出每个模块有三项职责:完成功能、应对变化、与阅读者沟通,后两项不满足的模块即使能运行也需要重构。

素数程序的重构步骤用素数生成程序演示小步重构:拆分大函数、改名、删除冗余逻辑、简化循环边界,每一步都运行测试。抽取小函数的性能顾虑回应“小函数影响性能”的顾虑:先假设调用开销可以忽略,只有在深层循环里被证明有影响时再处理。重构如饭后清理厨房用“饭后清理厨房”比喻重构:不清理当餐省时,却让以后的每一餐越来越难做。

原书依据 · 4 处

第6章 一次编程实践

第6章完整记录了作者与 Robert Koss 结对编写保龄球记分程序的过程。只存数据的类未必该存在记录了开头的转折:餐巾纸上画出的 Throw 类只保存数据、没有行为,于是两人决定不从它开始,而从 Game 的行为写测试。防御检查取决于调用范围讨论是否要防御非法输入,答案取决于函数会被谁调用。

重构让代码表达规则展示重构如何让记分函数的结构与保龄球规则同构,代码本身就能读出规则。Game与Scorer职责分离说明最终只剩 Game 和 Scorer 两个类,Game 追踪轮次,Scorer 负责计分,这是单一职责原则的自然结果。未经代码验证的图无益总结这一章的教训:最初的 Game–Frame–Throw 设计图完全错误,未经代码验证的图没有益处,图只有在帮助交流并被代码检验时才有价值。

原书依据 · 5 处

第Ⅱ部分 敏捷设计

第Ⅱ部分讨论“敏捷团队怎样做设计”:先识别设计腐化的症状,再用五条类设计原则去除它们,然后讨论 UML 在敏捷团队中应扮演的角色,最后用咖啡机练习综合运用这些原则。

第7章 什么是敏捷设计

源代码就是设计首先提出全书的设计立场:源代码就是设计,图只是辅助,敏捷团队把设计视为持续进行的活动。七种设计臭味列出设计腐化的七种臭味:僵化、脆弱、牢固、粘滞、不必要的复杂、不必要的重复、晦涩,并解释每一种如何出现。

需求变化不是腐化借口指出需求变化是常态,不能成为设计腐化的借口,设计应能经受变化。Copy程序的退化与修复用 Copy 程序展示腐化过程:为了支持纸带读入、穿孔输出,函数里不断加标志判断;敏捷做法是第一次变化出现时就用抽象把程序改成对这类变化封闭。检测诊断解决三步设计总结出“检测问题、用原则诊断、用合适方案解决”的三步法;对设计异味零容忍要求团队对设计异味零容忍,保持设计时刻干净。原则只为去除臭味而用则提醒,原则和模式只为去除已出现的臭味而用,没有臭味时套用原则本身就是一种不必要的复杂。

原书依据 · 7 处

第8章 单一职责原则(SRP)

SRP:职责即变化原因给出 SRP:一个类只应有一个引起它变化的原因,职责即变化的原因;Modem 接口把连接管理和数据通信放在一起就是例子。变化发生时才分离职责补充关键限制:只有当两种职责确实会因不同原因变化时才需要分离,变化尚未发生时就分离是不必要的复杂性。业务规则与持久化分离说明业务规则与持久化是最常见、必须分离的两种职责,可用外观、代理等模式隔开。

原书依据 · 3 处

第9章 开/关原则(OCP)

OCP靠抽象实现封闭说明 OCP 的关键是抽象:模块依赖于固定的抽象,就可以通过新增派生类扩展行为而不修改原代码。类型码switch违反OCP用 Shape 例子说明基于类型码的 switch 违反 OCP,每增加一种形状都要修改所有 switch。

但封闭不可能是全面的。没有处处贴切的模型指出没有对所有变化都贴切的模型,设计者必须选择对哪种变化封闭;只上一次当给出选择策略:“只上一次当”,在第一次遇到某种变化时建立抽象,防止同类变化再次造成伤害,并用测试先行和短周期交付尽早引出变化。用排序表封闭绘制顺序演示如何用数据驱动的排序表让绘制顺序对新增形状封闭。

原书依据 · 5 处

第10章 里氏替换原则(LSP)

LSP:子类型须可替换给出 LSP:子类型必须能够替换其基类型,否则依赖基类的代码就要做类型判断,进而违反 OCP。正方形不应继承长方形用正方形继承长方形的经典例子说明,即使数学上“正方形是长方形”,行为上它破坏了调用方对设置宽高的假设;IS-A指的是行为可替换由此得出 IS-A 关系指的是行为可替换,而且要从调用方的合理假设来判断。

契约规则约束派生类介绍 Meyer 的契约式设计:派生类只能削弱前置条件、加强后置条件。持久化集合违反替换用持久化集合的真实案例说明违反 LSP 的代价,提取公共部分代替继承给出常用解法:提取公共部分作为抽象基类,而不是强行继承。退化方法提示违反LSP列出违反 LSP 的启发信号:派生类中出现退化方法或抛出基类不会抛出的异常。

原书依据 · 7 处

第11章 依赖倒置原则(DIP)

DIP:策略不应依赖细节给出 DIP:高层模块不应依赖低层模块,二者都依赖抽象;抽象不应依赖细节。倒置层次与接口归属说明倒置不只是依赖方向的倒置,还有接口所有权的倒置:接口由使用它的高层声明和拥有。依赖于抽象的启发规则给出“依赖于抽象”的启发规则:变量不持有具体类引用、类不派生自具体类、不覆写已实现的方法,并指出稳定的具体类(如 string)可以例外。

Button控制Lamp的倒置用 Button 控制 Lamp 的例子演示倒置:抽象出 ButtonServer 接口,Button 就能控制任何设备。调节算法依赖接口参数用熔炉调节器例子说明,高层算法应依赖接口参数而不是具体硬件寄存器,这样它可以复用于任何温度计和加热器。

原书依据 · 5 处

第12章 接口隔离原则(ISP)

接口污染与胖接口用 TimedDoor 的例子说明接口污染:为了让一个子类使用定时功能,Door 接口被迫加入不需要的方法,形成胖接口。客户端反向施压接口解释客户端会对接口施加反向的力:接口为满足某个客户而改变时,所有其他客户都要重新编译和部署。

委托或多重继承隔离接口给出两种隔离方法:用委托(适配器)或多重继承让一个对象对不同客户呈现不同接口。ATM界面按交易拆分用 ATM 界面按交易拆分接口的例子说明怎样按客户隔离;按客户组分接口与适度则提醒按客户组而非单个客户分组接口,并保持适度,不要为每个调用者都造一个接口。

原书依据 · 5 处

第13章 C#程序员UML概述(C#语言)

UML图的三个级别区分 UML 图的三个级别:概念级接近人类语言,规格说明级和实现级则接近代码;本书只用后两种。UML主要图示速览快速浏览本书会用到的主要图示:类图、对象图、顺序图、协作图与状态图。

原书依据 · 2 处

第14章 使用UML

第14章讨论 UML 什么时候值得用。软件建模的成本前提指出建模的前提是模型比实物更便宜,而软件构建本身很便宜,所以只有当图能比代码更快验证想法时才值得画。UML适合交流不适合算法说明 UML 适合与他人交流设计思想,不适合表达算法细节,那时代码更清晰。

丢弃大多数UML图主张丢弃大多数图,只保留那些长期有用的高层结构图;动静态图短周期共演建议动态图和静态图在短周期内共同演化,并很快用代码验证。何时画图与何时不画反对“必须图示一切”的硬规则:是否画图取决于目的,每种情况都要有明确的停止点。购买CASE工具前先度量提醒在购买 CASE 工具前先度量它是否真的提高效率;文档的价值与篇幅成反比总结文档的价值与篇幅成反比,越短小越可能被阅读和维护。

原书依据 · 7 处

第15章 状态图

状态图的基本符号介绍状态图的基本符号:状态、迁移、事件、动作、伪状态、超状态。演化系统用状态迁移表建议在系统仍在演化时用状态迁移表代替状态图,因为表格更容易修改,后续也可以交给状态机编译器生成代码。

原书依据 · 2 处

第16章 对象图

对象图用于运行时结构说明对象图展示系统某一时刻的对象及其关系,适合描述运行时结构,例如楼层规划程序中的房间及连接、多线程服务器在运行时创建的对象;它只在运行时结构无法由类图看出时才有用,作者十年间画过的对象图不超过12张。

原书依据 · 1 处

第17章 用例

用例是即时需求把用例看作即时需求:在需要实现之前才写,写得简短,并随讨论修订,而不是一次写出包含所有备选路径的厚重文档。用例图只留系统边界图认为用例图中除了系统边界图外大多没有价值,«extends» 和 «includes» 的争论只会浪费时间。

原书依据 · 2 处

第18章 顺序图

顺序图的基本符号介绍顺序图的对象、生命线、消息、激活与循环等符号。能用代码表达就不画图强调能用代码表达清楚的就不画顺序图,复杂的顺序图通常说明代码本身需要重构。斜消息线揭示竞争条件说明斜画的消息线可以揭示消息在途中的时间差,从而发现竞争条件;异步消息与线程标注介绍异步消息、多线程和主动对象在顺序图中的标注方法。

原书依据 · 4 处

第19章 类图

类图揭示依赖结构说明类图最重要的作用是揭示源码依赖结构,比如关联、继承、依赖的方向;类图的布局约定介绍好类图的画法:标清接口、只放代表性方法、关联横向而继承纵向、分区并减少区域间连线。类图修饰的取舍讨论类图修饰的取舍:«interface» 衍型、抽象类标记等少数修饰有用,聚合等多数修饰定义不严、容易引起混乱,多数时候不该加。

原书依据 · 3 处

第20章 咖啡的启示

第20章用 Mark IV 咖啡机练习综合运用前面的原则。按名词建模的三种错误批评学生常见的方案:围绕硬件名词建模,造出一堆只转发调用、没有行为的类,结果是浮夸的类、虚构的抽象和上帝类。关联是消息路径示范如何后退一步问“咖啡如何煮出来”,得到热水源、容器、用户界面三个抽象,关联则代表消息路径。

用例逐步分配消息说明三个抽象之间的消息是逐个走查用例分配出来的;抽象策略与M4细节隔离把高层的煮咖啡策略与 Mark IV 的硬件 API 隔离,这是 DIP 的应用。线程还是轮询可推迟决定指出线程还是轮询是可以推迟到最后的决定,设计应对二者都适用。小问题慎防面向对象过度设计最后提醒:咖啡机问题很小,用状态机几十行就能实现,面向对象的分离收益未必大,要警惕在小问题上过度设计。

原书依据 · 6 处

第Ⅲ部分 案例学习:薪水支付系统Payroll

第Ⅲ部分先介绍案例需要的几个设计模式,再给出 Payroll 的需求与用例,完成第一轮迭代的分析、设计和实现。

第21章 命令模式和主动对象模式

命令模式解耦设备连接介绍命令模式:一个只有 Execute 方法的接口,把函数提升为对象,例如复印机控制软件用命令把设备与连接逻辑解耦。接口名不加I前缀解释作者为什么不在接口名前加 I 前缀:不要用一个可能变化的正交概念污染名字。

事务命令解耦实体与时间说明命令可以表示事务:事务对象先收集并验证数据,再在合适的时候执行,从而把实体与时间解耦,这正是 Payroll 的核心结构。命令栈实现撤销演示加入 Undo 后用命令栈实现撤销。主动对象与RTC任务介绍主动对象模式:一个引擎循环执行命令链表,命令执行完再把自己或后续命令加回链表,实现单线程的运行至完成(RTC)多任务。

原书依据 · 5 处

第22章 模板方法模式和策略模式:继承和委托

模板方法与模式滥用回顾继承热潮与“优先使用组合”的转变,并用应用程序框架例子介绍模板方法,同时提醒不要为了用模式而引入不必要的复杂。策略模式解除算法绑定用冒泡排序例子说明策略模式如何用委托解除通用算法与细节的绑定,让细节可被多种算法复用。模板方法与策略的选择比较两者:模板方法简单但不灵活,策略灵活但多一个类,选择取决于细节是否需要被多种算法重用。

原书依据 · 3 处

第23章 外观模式和中介者模式

外观从上方强制规约说明外观从上方给一组对象施加规约:它为复杂接口提供简单的特定用途接口,并且是显式、强制的,例如用一个 DB 类封装所有数据库访问。中介者从下方隐蔽规约说明中介者从下方施加规约:被管理的对象并不知道中介者的存在,例如让文本框输入自动选中列表项的 QuickEntryMediator。

原书依据 · 2 处

第24章 单例模式和单状态模式

单例强制结构上的唯一介绍单例模式:用私有构造函数和静态实例强制结构上的唯一,适合程序的根对象,但它不可继承、难以测试。单状态强制行为上的唯一介绍单状态模式:所有字段静态而方法非静态,强制行为上的唯一,对使用者透明且可派生多态,代价是创建和销毁实例仍有开销。

原书依据 · 2 处

第25章 空对象模式

空对象替代null检查用员工查询例子说明空对象模式:数据库在找不到员工时返回一个什么都不做的 Employee.NULL,调用方就不必到处判空,也不会因忘记判空出错。

原书依据 · 1 处

第26章 案例学习:Payroll系统的第一轮迭代

数据库是实现细节说明为什么不从数据库模式开始设计:数据库是实现细节,过早设计会让应用以数据库为中心。用例暴露策略式核心模型逐个分析用例,得到添加员工、删除员工、考勤卡、销售凭条、服务费、更改员工和发薪等事务,以及员工的支付类别、支付时间表、支付方式三组策略对象。

从需求中搜寻底层抽象示范如何从需求中搜寻底层抽象:把“有的按小时、有的按月薪、有的拿佣金”概括为“所有员工都有薪水,只是计算方式不同”,抽象自然出现。设计刚好够用即可提醒这些设计只来自最初几个故事和白板草图,刚好够用即可,后续会在实现中修正。

原书依据 · 4 处

第27章 案例学习:Payroll系统实现

由事务决定易变关联说明添加员工事务负责决定支付类别与时间表的对应关系,这种易变的关联放在事务中而不是核心模型中。全局数据库外观与延迟选型介绍 PayrollDatabase 外观:最初只用内存中的散列表实现,让测试先通过,数据库的选型被推迟。代码反馈暴露图示缺陷记录写测试时暴露出的两处图示缺陷:员工的多个所属关系和更改员工事务的层次,都在代码反馈中被修正。

开发者勿替客户做商业决策记录作者自创“登记”概念保证只付一次薪的经历,并反思这是替客户做了商业决策,应该交给客户。支付周期应归时间表说明支付周期的计算应归属于支付时间表,而不是支付类别。主程序抽象事务来源介绍主程序:PayrollApplication 循环地从 TransactionSource 接口取事务并执行,事务的来源(文本、界面、网络)因此可以替换。

原书依据 · 6 处

第Ⅳ部分 案例学习:打包Payroll系统

第Ⅳ部分把视角从类提升到组件:讲组件设计原则和度量,用它们重新划分 Payroll,并在此过程中介绍更多模式,最后为 Payroll 加上数据库和用户界面。

第28章 包和组件的设计原则

组件是独立部署单元定义组件为可独立部署的二进制单元,例如 .NET 程序集。三条内聚原则决定类怎样分到组件中:REP:重用粒度即发布粒度讲 REP,重用的粒度就是发布的粒度;CRP:不在一起用就分开讲 CRP,不会一起被重用的类不应放在一起;CCP:同因修改的类同包讲 CCP,会因同样原因修改的类放在同一组件,这是 SRP 在组件层面的版本。

三条耦合原则决定组件之间怎样依赖。ADP:组件依赖不许成环讲 ADP:组件依赖图不能有环,出现环时用 DIP 或新建组件打破。组件结构不能自顶向下说明组件结构不能自顶向下设计,它随系统增长和变化逐步形成,是可构建性和可维护性的映射图。SDP:依赖指向更稳定处讲 SDP,用不稳定度 I 衡量组件,依赖应指向更稳定的方向;SAP与主序列距离讲 SAP,稳定的组件应当抽象,并用抽象度 A 和到主序列的距离 D 发现位于“痛苦区”和“无用区”的组件。

原书依据 · 8 处

第29章 工厂模式

工厂让创建只依赖抽象说明工厂模式让创建对象的代码也只依赖抽象,从而满足 DIP。TDD改变类型安全权衡讨论用字符串参数的单一工厂方法会牺牲类型安全,但在 TDD 下测试能弥补这一点,权衡因此改变。可替换工厂与测试欺骗说明可替换的全局工厂可以在测试中注入假对象。不要默认使用工厂提醒不要默认使用工厂,只有当变化真的需要时才引入。

原书依据 · 4 处

第30章 案例学习:Payroll系统的包分析

按封闭性倒置包结构记录 Payroll 第一版组件划分的问题:依赖方向错误,于是按封闭性(CCP)重新划分,并倒置依赖,让细节组件依赖抽象的领域组件。为重用拆分要基于事实提醒为重用而拆分组件要基于真实的重用需求,而不是假想。

用internal隐藏组件细节说明用 internal 可见性隐藏组件内部类,限制组件的输入耦合。用度量值发现坏划分用关系内聚性、不稳定度、抽象度、主序列距离等指标量化组件结构,找出划分不当的组件。对象工厂消除创建耦合发现剩余的输入耦合几乎都来自对象创建,用对象工厂消除它。

原书依据 · 5 处

第31章 组合模式

组合把一对多变一对一介绍组合模式:CompositeShape 持有一个 Shape 列表并把调用委托给每个成员,于是调用方把一对多关系当成一对一处理,例如组合命令可以让一次触发执行多个命令。

原书依据 · 1 处

第32章 观察者模式

代码逐步演进成观察者展示代码如何一步步演进成观察者模式:从数字时钟轮询时间源开始,为了测试和解耦逐步抽出接口,最后才发现结果就是观察者。观察者的推拉两种模型比较观察者的拉模型和推模型:拉模型由观察者主动查询,推模型在通知时附带数据。

原书依据 · 2 处

第33章 抽象服务器、适配器和桥接模式

抽象服务器与接口归属用台灯问题介绍抽象服务器:Switch 依赖 Switchable 接口,接口归属于使用它的客户。适配器隔离凑合实现说明当被控制类无法实现该接口时,用适配器隔离,并承认适配器是一种不完美的凑合。桥接拆分两个变化维度用 Modem 层次加上专线需求的例子说明桥接模式:把硬件品牌和连接方式两个变化维度拆成两个层次。

原书依据 · 3 处

第34章 代理模式和TDG模式:管理第三方API

代理让两端不知数据库用购物车例子说明代理模式:在对象模型和数据库之间放代理,让业务规则和数据库两端都不知道对方。代理的真实代价如实记录代理的代价:实现时多次偏离规范模式,代码量大且复杂。隔离第三方API的层次总结使用第三方 API 的三个阶段:直接调用、用外观集中调用、再用代理等完全隔离。

TDG与内存网关测试介绍更轻量的表数据入口(TDG),并用内存实现的网关做测试。先用外观再按需重构列出处理数据库的另外四种模式,建议先用外观,等需要时再重构为更复杂的模式。

原书依据 · 5 处

第35章 访问者模式

访问者用双重分发加方法介绍访问者模式:用双重分发在不修改 Modem 层次的情况下为它添加新方法(如为各操作系统配置)。非循环访问者解依赖环介绍非循环访问者:用动态类型转换打破访问者与被访问类之间的依赖环。访问者分离报表与结构用物料清单例子说明访问者把报表逻辑与数据结构分离。

装饰者包装附加行为介绍装饰者:用包装对象附加行为(如拨号时开大音量),而不修改每个实现。扩展对象按名取能力介绍扩展对象:每个对象持有按名字查找的扩展对象列表,从而在不改层次的前提下获得新能力(如生成 XML 或 CSV)。

原书依据 · 5 处

第36章 状态模式

FSM三种实现的权衡以地铁旋转门为例比较有限状态机的三种实现:嵌套 switch、状态迁移表、状态模式,各有可读性、灵活性和性能上的取舍。测试促成动作接口解耦说明为状态机写测试如何促使动作接口解耦。SMC生成三层状态机介绍作者的状态机编译器 SMC,它从迁移表描述生成状态模式代码。状态机管理GUI策略列举状态机的常见用途,如 GUI 的高层应用策略、分布式处理与协议。

原书依据 · 4 处

第37章 案例学习:Payroll系统的数据库

静态数据库重构为接口说明 Payroll 从内存存储改为 SQL Server 时,如何先把静态的 PayrollDatabase 重构为接口,再提供 SQL 实现。类型码映射放在何处讨论支付时间表等类型到数据库代码的映射应放在哪里。用强制失败测试事务用强制失败的测试验证保存员工的多条插入在事务中执行。

提取一次性操作对象记录把保存逻辑中的临时状态提取为一次性操作对象的重构。不连数据库测试加载说明加载员工在端到端测试之外,如何通过检查生成的 SQL 命令和手工构造的数据行,不连接数据库就测试加载细节。

原书依据 · 5 处

第38章 案例学习:Payroll系统的用户界面

界面选型与小步发布说明界面选型和第一次只发布“添加员工”的理由,并强调 UI 比业务规则更易变,必须与业务逻辑分离。MVP让业务逻辑可测介绍模型-视图-表示器(MVP):业务逻辑放在表示器里,窗体只负责界面行为,测试通过 Mock 视图验证表示器的行为。视图加载器解耦窗口创建说明主窗口如何用视图加载器(ViewLoader)创建窗口,让表示器不依赖任何窗体类,从而可以整体替换界面。

原书依据 · 3 处

附录A 两家公司的讽刺故事

附录 A 用一个故事对比两种开发方式。阶段截止制造假进度讲 Rufus 公司:交付日先定死,分析和设计阶段按日期宣布完成,团队陷入用例模板之争、CASE 工具故障、代码行数考核和强制加班,最终发布延期且质量很差。按速率取舍迭代范围讲 Rupert 公司:用户故事卡、按历史速率规划、超载时由业务方删减范围、早期验收测试、可持续的节奏,最终按时在展会上演示了最重要的功能。

原书依据 · 2 处

附录B 源码即设计

附录 B 收录 Jack Reeves 的文章《什么是软件设计?》及其后记。源码才是软件设计是文章的核心论点:唯一符合工程设计标准的软件文档是源码,编译器和链接器负责构建,所以构建廉价、设计昂贵。测试调试即设计验证把测试和调试看作设计的验证与改进,解释了为什么软件的返工是正常的设计活动。

辅助设计文档的两种用途说明辅助设计文档的两种用途:记录问题域信息和难以从代码中提取的设计内容,它们应保持精简。架构需先接近正确是作者十年后的修正:大型项目的架构一旦写满代码就很难改,所以第一次要尽量接近正确。

原书依据 · 4 处

跨章综合

用代码验证设计,是全书的方法论主线。 前言里作者对“没有设计阶段”的反思(用代码验证设计图)、保龄球程序中被推翻的设计图(未经代码验证的图无益)、第7章“源代码就是设计”(源代码就是设计)、Payroll 实现中被测试纠正的图(代码反馈暴露图示缺陷),一直到附录 B 的理论论证(源码才是软件设计),是同一个判断在不同层次的反复出现。

原则是对已发生变化的回应,而不是预先设计。 SRP 强调变化发生时才分离(变化发生时才分离职责),OCP 主张“只上一次当”(只上一次当),工厂模式不要默认使用(不要默认使用工厂),组件为重用而拆分要基于事实(为重用拆分要基于事实),都与第2章“你不会需要它”(简单设计三条咒语)以及第7章“原则只为去除臭味而用”(原则只为去除臭味而用)一致。附录 B 的后记(架构需先接近正确)则提醒了这一立场的边界:大型系统的架构仍需要尽早接近正确。

依赖倒置是从类到组件再到界面的统一手段。 第11章的接口归属(倒置层次与接口归属)在第20章的咖啡机抽象(抽象策略与M4细节隔离)、第30章倒置的组件结构(按封闭性倒置包结构)、第33章的抽象服务器(抽象服务器与接口归属)和第38章的视图加载器(视图加载器解耦窗口创建)中反复出现;隔离数据库的外观和代理(业务规则与持久化分离、隔离第三方API的层次)也是同一思想。

计划和设计都依赖实测反馈。 迭代计划只信上轮速率(速率驱动下轮计划),设计只信代码和测试的反馈;附录 A 的两家公司(阶段截止制造假进度、按速率取舍迭代范围)正是这两种反馈有无的对照。

原书依据 · 22 处

发散与实践

本书生成了两张实践卡:一张用 SRP 的“变化原因”和 DIP 审视本仓库 cardbox 的导入编排代码,判断哪些职责值得拆分;一张用“相对点数 + 实测速率”规划读书工作流的批次。与之关联的知识分别是SRP:职责即变化原因、变化发生时才分离职责、倒置层次与接口归属和速率驱动下轮计划、按速率取舍迭代范围。

原书依据 · 5 处
生成进度与管理记录

敏捷开发(纪念版)

Skill 版本:v23

  • 本次实际使用规则:book-notes v23 / book-workflow v4(2026-10-24 轻量模式首次完整生成);2026-09-26⁄27 的旧版 v8 输入预检与待确认项记录保留在 _workflow.md。

作者:罗伯特·C.马丁(Robert C. Martin);清华大学出版社,纪念版,ISBN 9787302581901(英文原书 Agile Principles, Patterns, and Practices in C#)

执行模式:light

建档进度:done

整书笔记:_book_note.md(schema 1;SHA-256 19b800d9f67810affde7e3677dd0250528c04f78680e9cad4bb44c787a5c22fb)

整体评级

四象限结论:经典原理(高信息浓度 + 高稳定性)

评级理由:

全书以“实践—原则—模式”三层组织:第Ⅰ部分把敏捷宣言落实为用户故事、速率驱动的计划、TDD、重构、结对与持续集成;第Ⅱ部分给出设计腐化的七种臭味和 SRP、OCP、LSP、DIP、ISP 五条类设计原则;第Ⅲ、Ⅳ部分用 Payroll 案例把命令、策略、外观、代理、访问者、状态等十余种模式与 REP、CRP、CCP、ADP、SDP、SAP 组件原则串起来,并给出不稳定度、抽象度、主序列距离等可计算度量。每条原则都配有反例、修正过程和适用边界(如“变化发生时才分离职责”“只上一次当”“不要默认使用工厂”),信息浓度很高。

稳定性也很高:示例使用 C#、.NET、Windows Forms、SQL Server 等写作年代的技术,但论证对象是依赖管理、职责划分、测试驱动的设计反馈和基于实测的计划,这些原理至今仍是面向对象设计和敏捷实践的基础;技术细节可以替换,原则本身不随框架更迭失效。

类别:软件设计与开发方法类

内容形态:概念解析型 + 案例演示型(Payroll 与保龄球、咖啡机等完整代码演进)。

版本说明:内容简介称“24个附录”,前言与 spine 实际只有附录A、附录B,按原书正文记录,不推断缺失内容。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
00-宣言 敏捷宣言 done 0
00-原则 敏捷宣言的原则 done 0
00-OOD 面向对象设计的原则 done 0
00-XP 极限编程实践 done 0
00-推荐序 推荐序 done 0
00-前言 前言 done 2
01-部分 第Ⅰ部分 敏捷开发 done 0
01 第1章 敏捷实践 done 11
02 第2章 极限编程概述 done 13
03 第3章 计划 done 8
04 第4章 测试 done 4
05 第5章 重构 done 4
06 第6章 一次编程实践 done 5
07-部分 第Ⅱ部分 敏捷设计 done 1
07 第7章 什么是敏捷设计 done 6
08 第8章 单一职责原则(SRP) done 3
09 第9章 开/关原则(OCP) done 5
10 第10章 里氏替换原则(LSP) done 7
11 第11章 依赖倒置原则(DIP) done 5
12 第12章 接口隔离原则(ISP) done 5
13 第13章 C#程序员UML概述(C#语言) done 2
14 第14章 使用UML done 7
15 第15章 状态图 done 2
16 第16章 对象图 done 1
17 第17章 用例 done 2
18 第18章 顺序图 done 4
19 第19章 类图 done 3
20 第20章 咖啡的启示 done 6
21-部分 第Ⅲ部分 案例学习:薪水支付系统Payroll done 0
21 第21章 命令模式和主动对象模式 done 5
22 第22章 模板方法模式和策略模式:继承和委托 done 3
23 第23章 外观模式和中介者模式 done 2
24 第24章 单例模式和单状态模式 done 2
25 第25章 空对象模式 done 1
26 第26章 案例学习:Payroll系统的第一轮迭代 done 4
27 第27章 案例学习:Payroll系统实现 done 6
28-部分 第Ⅳ部分 案例学习:打包Payroll系统 done 0
28 第28章 包和组件的设计原则 done 8
29 第29章 工厂模式 done 4
30 第30章 案例学习:Payroll系统的包分析 done 5
31 第31章 组合模式 done 1
32 第32章 观察者模式 done 2
33 第33章 抽象服务器、适配器和桥接模式 done 3
34 第34章 代理模式和TDG模式:管理第三方API done 5
35 第35章 访问者模式 done 5
36 第36章 状态模式 done 4
37 第37章 案例学习:Payroll系统的数据库 done 5
38 第38章 案例学习:Payroll系统的用户界面 done 3
39 附录A 两家公司的讽刺故事 done 2
40 附录B 源码即设计 done 4

非正文排除

spine项 类型 排除理由
0 / titlepage.xhtml 封面页 仅封面图
1 / Min Jie Kai Fa (Ji Nian Ban )_split_000.html 内容简介 出版方摘要,内容与前言重复
2 / 【0】1.html 推广页 电子书平台推广图片,非原书内容
9 / Min Jie Kai Fa (Ji Nian Ban )_split_007.html 致谢 致谢名单
10 / Min Jie Kai Fa (Ji Nian Ban )_split_008.html 作者简介 作者履历,无知识正文
54 / 附录B 末尾图片 data-url-image401–415 推广图片 英文敏捷名言海报等推广页,非正文
55 / 【0】2.html 推广页 电子书平台推广图片,非原书内容

待关联术语

术语名 出现章节 一句话语境
ADO.NET 34 .NET 的数据访问 API,作为需要隔离的第三方接口例子,未讲用法
CASE工具 01 作为“过程和工具”中工具的例子,建议先尝试简单工具,未展开
CMM 39 Rufus 公司追求 CMM3 级认证的讽刺情节,未讲模型本身
Crystal 01 与 XP 并列的敏捷方法之一,仅列名
EJB/ORB/RMI 02 作为不必要基础设施的例子,说明简单设计不预先引入,未展开
ER图 14 作者列举值得持久保存的文档时提到关系模型的 ER(实体联系)图,未展开
Eclipse 00-推荐序 推荐序作者提到刚交付完 Eclipse 开源项目的一个大版本后写序,未展开
Eiffel 10 Meyer 契约式设计的原生支持语言,仅提及
FitNesse 04 作者团队开发的验收测试框架,用于编写可执行的验收测试,未讲用法
JDBC 34 Java 数据访问 API,与 ADO.NET 并提,未讲用法
NUnitForms 38 Windows Forms 测试工具,作者认为可用于窗体测试,未展开
PERT图/甘特图 01 作为长期详细计划的载体被批评,未讲画法
ReSharper 05 重构工具的例子,提示可用工具完成机械性重构,未展开
SELF-SHUNT 测试模式 29 测试类自己实现被依赖接口以模拟协作者,仅一句说明
SMC 状态机编译器 15 作者编写的状态机代码生成工具,第36章另有介绍,此处仅提及
SWAG 03 Scientific Wild-Assed Guess 的缩写,原文释为“凭经验和直觉大胆猜测”,说明预研后的估算不必追求精确
Scrum 01 与 XP 并列的敏捷方法之一,仅列名
Windows Forms 38 第38章界面实现采用的 .NET 桌面 GUI 框架,未讲框架本身
comp.object 新闻组 33 作者回忆在新闻组讨论台灯问题的来源,未展开
主动对象(Active Object) 16 对象图中以粗边框表示管理控制线程的对象,模式本身见第21章
事后综合征(morning-after syndrome) 28 指他人修改依赖代码导致自己的代码第二天无法工作,用作 ADP 的动机
好莱坞原则 11 “别调用我们,我们会调用你”,作为接口所有权倒置的别称,未展开
数据访问对象(DAO) 08 作为分离持久化职责的模式名称被提及,第34章以 TDG 展开
物料清单(BOM) 35 访问者与扩展对象模式的示例领域,未讲 BOM 业务
特性驱动开发(FDD) 01 与 XP 并列的敏捷方法之一,仅列名
自适应软件开发(ASD) 01 与 XP 并列的敏捷方法之一,仅列名
表数据入口(Table Data Gateway) 23 外观章中提及的数据库模式名称,第34章展开为 TDG
运行时类型检查(RTTI) 10 违反 LSP 时调用方被迫使用类型判断的机制,未展开

引用文献

标题 类型 出现章节 一句话语境
Active Object: An Object Behavioral Pattern For Concurrent Programming 论文 21 主动对象模式的参考出处
Adaptive Software Development 书 01 自适应软件开发方法的出处,仅列入参考文献
Agile Software Development: Principles, Patterns, and Practices(2002) 书 00-前言、27 本书的 Java/C++ 前作(2003 年 Jolt 奖),前言说明它对 .NET 社区影响甚微、促成本版;第27章列入参考文献
Controlling Software Projects 书 30 DeMarco 的著作,引用“无法衡量就无法控制”支撑组件度量
Crystal Clear: A Human-Powered Methodology for Small Teams 书 03 Cockburn 的著作,列入计划章参考文献
Data Abstraction and Hierarchy(Liskov) 论文 10 里氏替换原则的出处
Design Patterns for Dealing with Dual Inheritance Hierarchies 论文 34 作者本人发表在 C++ Report 上的文章,列入参考文献
Design Patterns(GoF) 书 11 设计模式经典,作为模式出处多次引用
Designing Object-Oriented C++ Applications Using the Booch Method 书 00-前言 作者早期著作,前言回顾写作历程
Designing Object-Oriented Software(Wirfs-Brock) 书 10 职责驱动设计著作,列入 LSP 章参考文献
Endo-Testing: Unit Testing With Mock Objects 论文 04 Mock 对象模式的出处
Extreme Programming Explained: Embrace Change 书 01 Kent Beck 的 XP 著作,列入参考文献
Extreme Programming Installed 书 04 XP 实践著作,列入测试章参考文献
Extreme Programming in Practice 书 01 XP 实践案例著作,列入参考文献
Fit for Developing Software 书 04 FIT 验收测试框架著作,列入参考文献
Leading at the Edge of Chaos 书 02 软件管理著作,列入 XP 概述参考文献(作者 Daryl R. Conner,主题为组织变革)
Model View Presenter(Fowler) 文章 38 第38章末“参考”所列 Fowler 网站的 MVP 模式页面
Monostate Classes: The Power of One 文章 24 单状态模式的出处
Object Solutions(Booch) 书 11 Booch 著作,列入 DIP 章参考文献
Object-Oriented Analysis and Design with Applications 书 00-前言 Booch 的面向对象分析设计著作,前言提及
Object-Oriented Software Construction(Meyer) 书 09 Meyer 提出开闭原则与契约式设计的著作
Object-Oriented Software Engineering, A Use-Case-Driven Approach 书 09、26 Jacobson 的用例驱动方法著作,作为用例来源引用
Pattern Languages of Program Design 3 书 22 模式语言论文集,列入参考文献
Patterns of Enterprise Application Architecture 书 23 Fowler 的企业应用架构模式,表数据入口等模式的出处
Refactoring: Improving the Design of Existing Code 书 02 Fowler 的重构著作,重构定义的出处
Strengthening the Case for Pair Programming 论文 02 结对编程实证研究,列入参考文献
Structured Analysis and System Specification 书 08 DeMarco 著作,本章开篇所述内聚性概念的参考来源
Structured Programming 书 02 Dijkstra 等的结构化编程经典,列入参考文献
Test-Driven Development by Example 书 02 Kent Beck 的 TDD 著作,列入参考文献
The Case for Collaborative Programming 论文 02 协作编程研究,列入参考文献
The Humble Dialog Box 文章 38 第38章末“参考”所列 Object Mentor 网站文章,与界面可测性相关
The Mesa Programming Environment 论文 11 列入 DIP 章参考文献
The Practical Guide to Structured Systems Design 书 08 Page-Jones 著作,本章开篇所述内聚性概念的参考来源
UML Distilled 书 13 Fowler 的 UML 简明指南,UML 图三个级别的出处
What Is Software Design?(Jack Reeves, 1992) 文章 07 “源代码就是设计”观点的来源,全文收录于附录B
Writing Effective Use Cases 书 17 Cockburn 的用例写作著作,被推荐
《MIT斯隆管理评论》软件开发实践分析文章 论文 01 早期交付与频繁交付和最终质量相关的研究
《人件》 书 01-部分 第Ⅰ部分开篇引用其关于人与团队的观点

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 cardbox导入编排的职责划分 决策实践 done 第8章、第11章 ideas/idea-001-cardbox导入编排的职责划分.md(已核对函数范围、预编译 SQL 与 3 个提交;决策日志待回填)
002 用实测速率规划读书批次 行为实验 done 第3章、附录A ideas/idea-002-用实测速率规划读书批次.md(基线—干预—指标计划;数据待后续批次回填)

实践候选筛选:done

未采用候选:MVP 改造 cardbox web 界面(仓库 web 层较薄,缺少可比的表示器逻辑,收益低);用组件度量(I/A/D)评估 cardbox 包结构(与实践卡 001 的职责划分问题重叠,且需要先有拆分决定);SMC/状态模式实现深读(无当前现实对象与问题)。

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

暂无公开主题。