来源书籍

代码精进之路:从码农到工匠(异步图书)

Skill 版本:v24 工程实践(高信息浓度 + 中等偏低稳定性) 226 张卡片

张建飞 · 人民邮电出版社 · 2019-12-31T16:00:00+00:00 · ISBN 978-7-115-52102-6

全书导读

本书以Java业务开发为主要语境,讨论怎样把不断变化的需求写成能够理解和维护的代码。它把命名、规范、函数和设计方法放在同一条主线上:读者理解代码的成本不仅来自规则本身,还来自随意的组织方式。前七章提供具体技艺,八到十一章补抽象、分治、学习及团队方法,最后两章以出版时期COLA与工匠平台展示落地。

适合已有业务开发经验、希望改善表达与结构的读者。可按现有问题查命名、函数或模型,也可顺着“局部表达—业务结构—团队约定—工程实例”系统阅读。语言无关的职责、契约与抽象思想可以迁移,具体Spring、Maven与COLA用法则需绑定版本。

本笔记保留原书实际出处,并对已读到的不等价重构、遗漏终止条件、示例签名错误及绝对化效果承诺明确限定。书中个人经验、修辞与历史工具背景不能当成通用实证结论;所有代码均为阅读与静态解释,未编译、启动服务或执行转账。

全书主线

全书可归纳为一条互相反馈的链:先把业务意图表达清楚,再为变化划定职责边界,用模型组织共同认识,以抽象与分治控制一次需要处理的信息量,最后由测试、约定和团队习惯维持这种结构。

命名不是最后润色,因为说不清名称常会暴露理解或职责问题。函数把行为组织成步骤,设计原则和模式再把局部步骤扩成可协作结构。模型与DDD使关键业务概念不再只隐含在字段和分支里,但也带来错误抽象和额外层次的成本,因此后面的“不教条”贯穿全书。

COLA是这些思想的一种历史实现:领域核心与技术适配分开,命令查询按职责组织,多场景能力通过扩展坐标定位,再以规范和脚手架给代码安排位置。工匠平台把需求、模型、规则、存储和测试连起来,展示每个概念怎样进入实现,而不是证明采用某框架便自然获得好代码。

flowchart TD
 A[命名与规范表达意图] --> B[函数组织业务步骤]
 B --> C[原则与模式划定责任]
 C --> D[模型形成共同业务认识]
 D --> E[抽象与分治组织复杂度]
 E --> F[团队习惯与目标持续维护]
 F --> G[架构和项目实例落地]
 G --> H[测试与反馈推动修正]
 H --> A

图表达相互支撑的理解路径,不把软件开发规定成只能单向进行的阶段流程。

序一

软件研发同时需要表达、想象和架构。序文以软件进入新领域说明经验不能机械照搬,再介绍本书及COLA;这是一篇推荐序,没有展开可独立执行的方法。

序二

敏捷迭代和微服务只提供部分组织或结构手段,不能自行补齐业务建模和技术管理。当交付压力持续挤压设计,复制代码和临时分支会让后续修改更困难。技术带头人的价值还在于提供可演进的架构和质量环境;这些建议是经验判断,不把“好代码是银弹”的修辞当成充分性证明。

方法落地需要基础

敏捷、微服务等方法要依赖建模、架构和团队管理才能落地。若把迭代仅落实为更短的交付期限,用补丁和复制替代持续设计,变化会不断压向脆弱结构。选择方法前应确认团队具备哪些支撑条件;采用一个名称并不等于取得其效果。

方法落地需要基础保存独立卡片。

原书依据 · 1 处

前言

本书面对的核心矛盾是持续业务变化与代码混乱。业务自身的难度不能全被消除,但命名含混、职责失衡、随意耦合与缺乏质量文化会额外制造复杂度,因此改进要同时面对代码、思维和团队环境。第一部分从命名到DDD建立技艺,第二部分把抽象、分治与工作方式串起,第三部分用历史版本COLA和Java应用演示落地。框架是这些经验的一种实现,不能替代对上下文的判断,也不表示只有Java能应用这些原则。

区分复杂度来源

软件复杂度既来自业务问题本身,也来自表达问题的代码和协作方式。前者通常只能理解和组织,后者中的重复、混乱与不恰当设计则能通过技艺和持续改进减少。治理时先辨别难度来自业务规则还是人为结构,才能避免用更多框架继续叠加偶然复杂度。

区分复杂度来源保存独立卡片。

原书依据 · 1 处

彩图

彩图集中预览第7章的四色模型和电子书店建模过程:从业务流程识别关键时刻,再补人事物、角色与描述对象。这些图已与全书图像清单一起实读;模型的定义与建模步骤在第7章对应正文中解释。

第一部分 技艺

第一部分为技艺,依次处理命名、规范、函数、原则、模式、模型和DDD;本单元只有分部标题,具体方法在后续章节展开。

第1章 命名

命名把业务意图压缩为读者可识别的词。变量要说明意义和单位,函数要表达当前抽象层的责任,类、包与模块要说明共同概念和边界;一致词汇则减少反复猜测。自明代码与注释互补:中间变量暴露计算含义,注释解释无法从代码看出的原因。命名困难应回到问题理解与职责,而不是只查同义词。

1.1 命名的力量

名称可以把分散经验变成容易谈论的共同概念。POJO即普通Java对象,给已有对象使用方式起一个名称,便于团队讨论轻量设计。本单元同时讲企业命名轶事;轶事不能证明名称独自决定框架兴衰。

名称承载共同概念

POJO是普通Java对象的名称。已有做法被命名之后,更容易在团队间讨论、比较和传播;名字因此不仅是标签,也能成为沟通入口。但一个流行名称不自动保证设计更好,轻量框架的兴起也不能只归因于命名。

名称承载共同概念保存独立卡片。

原书依据 · 1 处

1.2 命名其实很难

起名要把问题的核心压缩为少量词。如果无法说清对象或函数到底负责什么,应回到业务分析和职责划分,而不是只换一个英文单词。命名困难因此是一种设计信号。

命名暴露理解

难以给模块、类或函数命名,可能说明职责过多、封装松散,或业务理解不充分。先用一句话说明它负责的业务结果,再检查职责边界,必要时重新分析或重构;不要只用更宽泛的词掩盖问题。名称是发现设计问题的线索,并非名称难找就必然设计错误。

命名暴露理解保存独立卡片。

原书依据 · 2 处

1.3 有意义的命名

自明代码让意图直接显现在名称和结构中。无法起名时可检查是否混合多个功能、类是否缺乏内聚,以及是否还欠缺问题信息;这把命名反馈到设计诊断。

命名暴露理解关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

1.3.1 变量名

变量名称要说明值的业务含义和必要单位。elapsedTimeInDays把过去天数写进名称,SECONDS_PER_DAY和PAGE_SIZE把相同数字可能具有的不同含义分开,也改善搜索定位。

名称标明意义与单位

变量名应表达存的是什么,必要时写出单位,如elapsedTimeInDays。把86400或10改成SECONDS_PER_DAY、PAGE_SIZE等有意义常量,可区分数字的不同用途并便于搜索。命名不能替代校验:常量表示固定约定时仍需确认业务和单位适用。

名称标明意义与单位保存独立卡片。

原书依据 · 1 处

1.3.2 函数名

函数名要把责任限定到具体行为,如校验凭据,而不是泛称处理数据。面向业务调用者时,getLatestEmployee表达取最近雇员,popRecord暴露栈的操作;名称应跟随接口的抽象层次。

业务命名优先

函数名要表达具体业务责任,而非含糊的“处理数据”或偶然实现。例如面向业务的getLatestEmployee()比popRecord()更能说明取最近雇员;但在栈接口本身,pop仍是合适的抽象。先确定接口服务哪一层,再选择这一层读者能理解的词。

业务命名优先保存独立卡片。

原书依据 · 1 处

1.3.3 类名

实体类用客户、雇员等业务名承载领域概念,辅助类用Controller、Repository等明确职责。Helper和Util常把无关能力藏在一个筐里;CSV解析与构建可按各自责任命名。

类名显露业务职责

实体类以团队认可的业务概念命名;辅助类以明确的职责限定名称,如CustomerRepository。CSVHelper同时解析和生成文件时,拆成CSVParser与CSVBuilder可使责任更清楚。拆分类别应以实际变化和内聚性为据,不能只靠后缀判断设计好坏。

类名显露业务职责保存独立卡片。

原书依据 · 1 处

1.3.4 包名

包把相关类组织到同一命名空间。fruit能容纳Apple、Pear、Orange;Apple过窄,Object又失去范围约束。包名应能解释这一组类的共同联系。

包名限定共同范围

包是一组相关类的组织和命名空间。名称需要概括成员共同点,同时限定范围:装苹果、梨、橙子的包可叫fruit,叫Apple太窄,叫Object则近乎没有分类信息。发现名称无法覆盖成员时,应检查分组是否合理,而非持续扩大名称。

包名限定共同范围保存独立卡片。

原书依据 · 1 处

1.3.5 模块名

本书的模块指Maven工程模块,比包的粒度大,模块名应反映职责。COLA示例以controller、app、domain、infrastructure区分层次;这是该书架构的约定。Maven的groupId与artifactId用于描述项目身份,具体依赖解析还涉及版本等信息,不把书中的二元简写视为完整唯一坐标。

模块名体现边界

模块是比包更大的组织单元,名称应说明它在系统中的职责。本书历史COLA示例用controller、app、domain和infrastructure区分层次,使依赖与代码去向可被讨论。名称体现的是已经划定的边界,仅拆成多个工程并不会自然得到清晰架构。

模块名体现边界保存独立卡片。

原书依据 · 1 处

1.4 保持一致性

一致性减少读者在同义词间切换的负担。下列小节从概念词、对仗词、限定词和业务技术词汇分别落实这条要求。

1.4.1 每个概念一个词

同一种操作在项目里选择同一称谓,避免查询方法在fetch、retrieve、get之间随意漂移。原书给出的create/add/remove/update/get/list/page/count是一组团队约定;它按操作和结果形态区分,不要求所有项目照搬。

一概念约定一称谓

团队应为同一种概念约定稳定称谓,减少读者猜测fetch、retrieve和get有何区别。可进一步约定get查单个、list查多个、page分页、count计数。真正不同的契约仍应在命名或接口说明中区分,不能为统一词形抹掉行为差异。

一概念约定一称谓保存独立卡片。

原书依据 · 1 处

1.4.2 使用对仗词

成对操作使用对称词形,可让读者从一个名称预测另一个。例如fileOpen与fClose不对称,open/close、lock/unlock等更容易对应;名称配对并不证明资源生命周期已正确实现。

成对操作名称对称

相反或配套操作应采用对称名称,如open/close、lock/unlock、begin/end。词根和修饰方式一致,读者才容易找到对应操作并理解生命周期。名称对称只改善表达,资源是否真正关闭、锁是否释放仍要检查控制流。

成对操作名称对称保存独立卡片。

原书依据 · 1 处

1.4.3 后置限定词

Total、Average等限定词后置,可以让对象词靠前并保持成组变量的对称性。Count明确表示数量,Id明确表示标识;Num在不同代码中含义不稳定,因此应以项目约定消除歧义,不能假定它天然代表某种下标。

限定词消除计数歧义

同一项目统一限定词的位置,可让revenueTotal和expenseTotal更易成组阅读。计数与标识应区分,如customerCount表示总数,customerId表示编号。避免含糊的Num;限定词顺序是一种团队风格,并非语言必需规则,既有一致约定也可以采用。

限定词消除计数歧义保存独立卡片。

原书依据 · 1 处

1.4.4 统一业务语言

业务讨论、模型、文档和代码应使用能互相对照的业务词汇。这里的统一语言是领域术语的一致含义,不是让业务人员都用同一种编程语言;后文DDD会进一步解释其边界。

业务术语贯穿工件

同一业务概念在会议、模型、文档和代码里应保持可对照的名称和含义,避免讨论的是客户,代码却散布多种无约定译法。统一语言指团队共享的领域词汇,不等于统一使用某种编程语言;含义变化时应同步相关工件。

业务术语贯穿工件保存独立卡片。

原书依据 · 1 处

1.4.5 统一技术语言

DO、DAO、DTO、Repository等技术词能提示对象角色,但前提是团队对含义有一致约定。例如表映射对象和数据访问对象的区别可减少查找职责的成本;这些缩写不是Java语法,也不保证每个项目含义完全一致。

技术词汇提示角色

采用团队熟悉的技术术语可提示类型的角色,例如DO承载表映射数据、DAO负责数据访问。应先约定词义再一致使用;后缀只提供阅读线索,不能证明实现确实符合职责,也不能把某项目约定当成语言标准。

技术词汇提示角色保存独立卡片。

原书依据 · 1 处

1.5 自明的代码

自明性指不依靠额外说明就能从代码结构和名称理解含义。代码只有本身可读时才能承担部分文档作用,后续通过中间变量、模式词汇和有意图的注释实现它。

1.5.1 中间变量

将一段隐藏语义的计算拆为命名中间值,可以使步骤含义显露。正则匹配的group(1)、group(2)先命名为key、value,再放入map,读者就能知道两个捕获组分别代表什么。

中间变量揭示含义

当表达式隐藏业务含义时,可先给中间结果起名,再组合使用。例如把正则捕获组1和2分别命名为key、value后再放入映射,可明确分组角色。拆分的价值来自名称传达了新信息;无意义的临时变量只会增加噪声。

中间变量揭示含义保存独立卡片。

原书依据 · 1 处

1.5.2 设计模式语言

模式名称能在熟悉该模式的团队里压缩解释成本。FilterChain表明多个过滤器沿链处理上下文,示例中无邮箱地址便提前返回,否则调用下一个过滤器;名称只有在行为相符且读者理解模式时才有帮助。

模式名称压缩沟通

在团队共享模式知识的前提下,名称可直接提示协作方式,如FilterChain表示过滤器按链组织。邮件过滤示例在无地址时终止,否则把上下文交给下一个过滤器。模式词应与实现行为一致;仅在名字里加入模式名,不能建立相应结构。

模式名称压缩沟通保存独立卡片。

原书依据 · 1 处

1.5.3 小心注释

注释最有价值的部分是代码背后的原因、约束和取舍。重复“等待2秒”不能解释为什么等待;说明等待关联系统结果才增加信息。对可用准确命名表达的功能,应先改善代码;但名称和注释不能修复固定休眠或中断处理本身的可靠性问题。

注释解释意图

注释应补充代码背后的原因和约束,而非复述语句。把“等待2秒”改为“等待关联系统处理结果”,才解释了目的;若函数名已清楚表达目的,可减少重复注释。改名不代表固定等待可靠,也不代表吞掉中断合理;表达问题和行为正确性需要分别检查。

注释解释意图保存独立卡片。

原书依据 · 1 处

1.6 命名工具

读成熟项目的命名能帮助发现常用词和职责划分。搜索结果应连同类型用途和上下文理解,不能只按词频选名字;本书插件与搜索服务是出版时例子,本轮不核验可用性或进行安装。

源码上下文辅助命名

不知道如何命名时,可搜索成熟项目中的类似职责,连同调用方式和上下文一起理解其用词。高频名称可提供候选,但不保证适合当前领域;先明确自己的业务含义,再选择表达。工具与服务会变化,方法并不依赖某个历史插件。

源码上下文辅助命名保存独立卡片。

原书依据 · 1 处

1.7 本章小结

命名把机器执行的指令转为人之间可沟通的业务表达。名称、职责和统一术语相互反馈:理解不清会导致名称含混,而检查名称也能推动重新建模。注释和中间变量则为读者补齐必要线索。

第2章 规范

规范通过减少随意差异来降低认知成本,范围从格式留白一直延伸到日志、错误、埋点与架构。稳定约定让读者预测代码位置和行为,但规则本身也需要共同理解与持续维护。日志级别连接告警,错误码连接调用契约,埋点连接数据分析;它们不能只当作排版偏好。

规范降低熵

规范统一名称、组织方式和常见处理契约,让工程师少记一批偶然差异,把注意力用于业务问题。这里“降低熵”是减少随意性的工程比喻,不是已测得的软件信息熵;规范也有维护成本,应优先约束反复引发理解或协作问题的差异。

规范降低熵保存独立卡片。

原书依据 · 2 处

2.1 认知成本

学习系统需要成本;掌握共同抽象后,读者就能复用已有知识,只关注局部差异。飞行员理解公共控制概念后再学习新机型的例子,用来说明识别共同机制的价值,不能替代实际资质和训练要求。

共同机制复用认知

认知成本是学习和理解对象所付出的代价。系统若有稳定的共同抽象和机制,使用者便可复用既有知识,把新增注意力放在差异上。规范因此应帮助识别稳定共性;把确实不同的行为硬统一,反而会使读者误用已有经验。

共同机制复用认知保存独立卡片。

原书依据 · 1 处

2.2 混乱的代价

凌乱的代码组织会让每次改动都重新寻找入口;即使最终只改一行,定位仍可能很费力。命名、包与模块归属、错误码和日志规范能提供稳定线索,减少反复理解偶然差异。

规范降低熵关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

2.3 代码规范

本节是代码规范的导航,后续分别处理格式、空行、命名、日志和异常。

2.3.1 代码格式

格式规则首先要让团队一致地阅读和修改代码。对没有语义差异的缩进等选择,可统一到IDE模板以减少争论;语言本身对格式有语义要求时仍要遵守其规则。

格式约定工具固化

团队选定一致的缩进、对齐和注释格式后,可固化为编辑器模板,降低个人偏好带来的差异。重点是让读者能稳定预测布局,而非不断争论Tab与空格。选择还需符合语言语义和项目约束,不能把所有格式差异都当作无关紧要。

格式约定工具固化保存独立卡片。

原书依据 · 1 处

2.3.2 空行规范

空行是概念分组的视觉线索。包声明、导入、方法或不同处理阶段之间的留白使读者更容易识别边界;相关代码应相邻,每行都加空行则会让这种区分失效。自动格式化只能辅助布局,逻辑分组仍要由人判断。

空行标记概念边界

把相关代码放近,在不同概念组之间留空行,可用视觉距离提示逻辑边界。例如包声明、导入和方法各自成组。没有留白会挤压结构,而每行都留白又会抹平分组差异;是否相关应按功能和阅读顺序判断,格式化工具不能独自决定。

空行标记概念边界保存独立卡片。

原书依据 · 1 处

2.3.3 命名规范

命名风格可帮助读者辨认类、方法、常量等角色。本书Java约定以类名大驼峰、方法名小驼峰和常量全大写为主;Enum、Impl等后缀是项目风格,不是所有Java项目必须遵从的语言限制。

命名风格提示制品

一致的命名形态能提示软件制品的角色,如Java常见的类名大驼峰、方法名小驼峰和常量全大写加下划线。项目还可约定异常、测试等类型后缀,但要区分语言规则与团队风格,不能因名称相似就认定职责或行为相同。

命名风格提示制品保存独立卡片。

原书依据 · 1 处

2.3.4 日志规范

日志是运行过程的可观察记录。级别应表达处理语境:ERROR对应需要关注的故障,WARN提示预期外或业务拒绝,INFO记录核心状态,DEBUG承载细节。告警需结合频率和影响,避免每次正常拒绝都成为故障报警;关键上下文有助定位,也要选择适合记录的数据。

日志分级契约

日志级别应有团队契约:ERROR记录需要处理的故障,WARN提示可预期问题或异常趋势,INFO记录关键状态变化,DEBUG提供诊断细节。把正常业务拒绝都报ERROR会制造告警噪声;WARN数量异常也可能需要告警。级别与阈值应结合恢复能力和业务影响,不能只按异常类名机械决定。

日志分级契约保存独立卡片。

原书依据 · 1 处
日志上下文连接事件

故障日志应包含可关联的链路或业务标识,必要时附异常堆栈,使一次失败能连接到请求路径和关键状态。上下文要服务定位,避免只打一条孤立错误消息;记录哪些字段还应按项目的数据处理要求确定,不能把所有外部输入原样倾倒进日志。

日志上下文连接事件保存独立卡片。

原书依据 · 1 处
调试日志按请求收敛

DEBUG适合记录诊断所需的请求和响应细节,长期全量输出会增加存储、处理和阅读成本。排障时可按requestId等条件动态限定输出范围,使诊断集中到目标请求;需同时确认过滤和开关的实际生效范围,不能把开启详细日志当作故障已定位。

调试日志按请求收敛保存独立卡片。

原书依据 · 1 处

2.3.5 异常规范

错误处理要同时服务清晰代码和稳定调用契约。在请求边界集中把业务异常与系统故障映射到响应和日志,可减少散落的重复处理;需要局部恢复或补偿时仍应就地处理。书中倾向Java非受检异常,是对声明传播成本的权衡,并非所有受检异常都违反开闭原则。错误码既可采用固定编号,也可采用类型、场景、标识组成的语义名称;对外公布后就涉及兼容性。

异常收敛边界

在请求处理边界统一捕获并映射业务异常和系统故障,可稳定响应形式、日志级别与错误码,减少每层重复记录同一异常。业务内部仍应在能恢复或补偿的位置处理错误。集中处理的目标是明确契约和责任,不是把所有异常吞掉或一律转换成成功。

异常收敛边界保存独立卡片。

原书依据 · 1 处
受检异常传播成本

Java受检异常可能要求中间调用层声明或捕获,低层新增异常因此会传播到多层接口。非受检异常可减少这类声明耦合,但也使调用方更依赖文档和约定理解失败。是否使用应权衡失败是否可处理与接口稳定性,不能把减少throws当成错误处理已完善。

受检异常传播成本保存独立卡片。

原书依据 · 1 处
错误码是外部契约

错误码一旦提供给调用者,便成为识别失败和决定后续动作的契约,应尽早统一并考虑演进兼容。编号式错误码结构固定,但需解释文档和容量规划;语义式错误码可按类型、场景和标识组织,如B_Customer_NameAlreadyExist,更易读但仍需稳定定义。

错误码是外部契约保存独立卡片。

原书依据 · 1 处

2.4 埋点规范

埋点把用户动作记录为结构化事件,让业务问题能够进入采集、传输、存储建模、分析与反馈链路。事件格式和字段语义相当于数据协议;SPM例子用站点类型、站点、频道、页面四层编码,支持不同粒度的效果分析。

埋点格式是数据协议

埋点是按约定记录用户行为的数据入口。字段格式、位置含义和采集口径必须一致,后续传输、存储和分析才能把事件正确组合;随意采集会让数据无法解释。先明确要回答的业务问题,再约定数据协议,采到数据本身并不证明分析结论可靠。

埋点格式是数据协议保存独立卡片。

原书依据 · 1 处

分层位置编码分析

本书SPM例子把位置编码分成站点类型、站点、频道和页面四层。按前缀聚合,可分别观察某类站点、某站点、某频道或具体页面的点击与后续转化。这说明分层编码怎样支持不同分析粒度;字段含义属于该历史方案,不能直接假定其他平台具有相同协议。

分层位置编码分析保存独立卡片。

原书依据 · 1 处

2.5 架构规范

架构约束规定模块如何分工与协作。若口头说采用某种架构却允许实现随意跨界,就无法依靠架构预测系统结构。COLA把分层和分包约定放入脚手架,使新应用从一致结构起步;约束仍需要后续维护。

架构约束需要落地

架构要通过可执行的边界和协作规则体现,如模块依赖、分包和前后端职责。脚手架可把约定固化为新项目的初始结构,减少每次重新组织的差异;采用模板之后仍需检查后续改动是否遵守约束。架构名称本身不能约束代码。

架构约束需要落地保存独立卡片。

原书依据 · 1 处

2.6 防止破窗

已有混乱可能成为后来代码模仿的样本,因此规范需要及时维护,不能只在项目启动时宣布。破窗在这里是软件协作的类比:发现局部偏离后及时修复,并通过团队共同执行维持可读结构;它不是每个小问题必然导致全面恶化的实证定律。

及时修复规范偏离

后来者常以已有代码为参照,局部混乱若长期保留,可能使偏离规范成为默认做法。发现问题后应及时说明原因并修复,通过审查和团队共同维护保持结构一致。破窗是理解模仿风险的类比,不表示任何小缺陷都必然无限扩散,也不要求不计成本地立刻重写。

及时修复规范偏离保存独立卡片。

原书依据 · 1 处

2.7 本章小结

规范从格式扩展到日志、异常、数据协议和架构边界,目的是减少无谓的差异。团队既要共同制定可理解的约定,也要用代码审查发现和修复偏离;规范的价值要落到实际维护成本,而非只看条款数量。

第3章 函数

函数是行为表达的基本单元。条件谓词、相关参数对象化、职责分解和组合函数,让入口读成处理步骤;SLAP进一步检查同层内容是否一致。判空、缓存与降级等支撑行为可集中管理,但抽离必须保留控制流和失败语义。函数式表达减少样板,并不自动消除副作用。

3.1 什么是函数

数学函数描述输入到输出的确定对应。例如f(x)=2x+1,在x=2时得到5。这为理解软件函数提供入口;软件中的过程还可能读写外部状态,不能直接等同于纯数学映射。

数学函数描述对应

数学函数将输入按规则对应到输出,例如f(x)=2x+1把2对应到5。借用到软件时,要区分单纯计算与包含状态变化的过程:软件函数可能读写外部状态,同一个显式参数并不总保证同一结果。数学例子帮助理解输入输出,不能替代对代码副作用的检查。

数学函数描述对应保存独立卡片。

原书依据 · 1 处

3.2 软件中的函数

软件函数组织一组可调用代码,参数、执行行为和返回结果构成其接口。子程序、函数、方法在不同语言和历史中有所差异;本书主要在对象语境中称方法,其他语境称函数,不能据此把Function限定为函数式语言专用。

函数与方法依语境区分

软件函数是可调用的代码单元,用来组织可复用行为;方法通常指与对象或类型关联的操作。子程序、函数、方法的精确边界取决于语言,函数并非函数式语言专用。阅读接口时应检查参数、返回和状态变化,而不是仅凭称谓推断纯度或执行方式。

函数与方法依语境区分保存独立卡片。

原书依据 · 1 处

3.3 封装判断

复杂布尔表达式可提取成表达业务判断的谓词,调用方据此决定动作。例如客户能否进入业务员私海,应由规则函数说明资格,再由调用方执行捡入。原书前后示例对空标识的判断不同,不能视为行为等价的重构;命名改善仍需配合规则核对。

判断封装成语义

把难懂的布尔组合提取成具有业务意义的谓词,可让调用点读成“满足资格才执行动作”。谓词负责回答规则是否成立,动作由调用者决定。提取前后必须保持条件含义一致;本书私海例子把NIL_VALUE比较改成空串拒绝,不能仅因名称更清楚就认定行为等价。

判断封装成语义保存独立卡片。

原书依据 · 1 处

3.4 函数参数

参数少通常更易理解,但数量必须服从概念。一条线的起止横纵坐标天然成对,可用Point start和Point end代替四个double;而一个二维点保留两个坐标参数并不违背简洁原则。

参数对象化

总是一起传递且具有共同业务含义的参数,可抽成对象。例如绘线的四个坐标组成起点和终点两个Point,既缩短签名又显露关系。不要为减少参数个数随意打包无关值;二维点的两个坐标本就是清晰的自然输入。

参数对象化保存独立卡片。

原书依据 · 1 处

3.5 短小的函数

长函数容易掩盖内部阶段,适当拆出命名子函数有助于阅读。原书以20行为团队检查建议,但同时说明没有绝对标准;判断应结合职责和阅读效果,而非机械追求行数。

短函数以职责衡量

超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。行数阈值可以作为团队发现问题的提醒,但不是正确性的证明;拆分后若名称无意义、上下文频繁跳转,也未必改善阅读。最终检查的是职责和表达。

短函数以职责衡量保存独立卡片。

原书依据 · 2 处

3.6 职责单一

单一职责不仅关乎长度,也关乎每一层在讲哪件事。发薪示例把遍历员工、检查发薪日、计算并支付分成三个命名层次,调用者可先看总体步骤,再进入细节。它演示的是组织方式,没有展开支付事务或防重复处理。

单一职责函数

函数应围绕一个清楚的职责组织行为,再通过命名子函数分解细节。发薪示例把遍历、资格判断、计算与交付逐层表达,使外层讲步骤、内层讲实现。职责单一不等于只有一条语句,也不等于发薪业务已具备幂等、事务等保障;示例只说明表达结构。

单一职责函数保存独立卡片。

原书依据 · 1 处

3.7 精简辅助代码

判空、日志、鉴权、缓存和降级是必要的支撑,但重复散布会遮住核心业务流程。可以把稳定的横切处理集中封装,让业务函数显露主线;提取时仍要保留原有执行时机和失败语义。

辅助代码退场

判空、日志、缓存和鉴权等支撑逻辑容易在多个函数里重复,遮住业务流程。可将稳定的公共处理集中到工具、拦截器或边界,让业务步骤更清晰。抽离不等于删除:执行顺序、权限检查和失败行为仍必须明确,不能为简洁牺牲必要约束。

辅助代码退场保存独立卡片。

原书依据 · 1 处

3.7.1 优化判空

Optional用容器明确表示值可能缺失,并通过映射继续处理或选择缺省值。使用map还是flatMap取决于转换函数是否已返回Optional。原书由普通getAddress/getCountry的判空代码跳到flatMap写法,却未说明返回类型变化,还遗漏toUpperCase,因此不能称为等价重构。

可选值链需匹配类型

Optional表示一个值可能存在也可能缺失。转换返回普通值时用map,转换本身返回Optional时用flatMap,缺失时可用orElse给默认值。原书链式示例还漏掉旧代码的toUpperCase();减少嵌套之前,应先核对每步返回类型和缺失、转换规则,而不是直接替换语法。

可选值链需匹配类型保存独立卡片。

原书依据 · 1 处

3.7.2 优化缓存判断

缓存处理可统一接管查缓存、收集未命中ID、回源和结果合并,使业务方法专注查询。本书MultiCacheable等为自研注解示意,注解的存在不提供完整实现契约,尤其不能省略部分命中、回源失败和顺序处理的定义。

缓存编排独立维护

批量查询中,查缓存、汇总未命中ID、回源和合并结果会遮住业务主线。把这些重复步骤集中到缓存组件,可减少对具体缓存实现的耦合。组件仍需定义部分命中、异常、结果顺序等契约;本书自研注解只说明分离方式,不是可直接使用的通用API。

缓存编排独立维护保存独立卡片。

原书依据 · 1 处

3.7.3 优雅降级

服务降级是在依赖不可用时提供预先定义的有限行为,保留可接受的部分服务。注解可把降级入口从正常路径中分离,但替代结果的含义、签名匹配和触发范围仍是契约。书中Hystrix示例属于历史方案,默认用户对象也不能代表真实用户查询成功。

降级保留有限服务

依赖服务不可用时,可转入预先定义的降级路径,保留可接受的有限服务能力。降级逻辑应与正常路径分离,并明确替代结果的含义,不能把空用户当成查询成功。书中Hystrix注解示例仅演示组织方式,回退方法参数还需与命令契约匹配。

降级保留有限服务保存独立卡片。

原书依据 · 1 处

3.8 组合函数模式

组合函数使入口读起来像处理步骤的目录,细节在下层函数里展开。属性复制例子把校验、遍历、检查读写能力和赋值分解,便于先理解整体再进入细节。但重构草稿省略了目标对象、ignoreProperties等处理,且actualEditable作用域和空writeMethod检查不完整,不能直接作为完整替代。

组合步骤逐层展开

组合函数把高层方法组织为一系列有意义的步骤,具体实现放到下层方法。读者先理解流程,再按需进入细节;例如属性复制可拆成校验、遍历属性、判断可复制和执行赋值。提取步骤必须保留原契约和数据传递,示意草稿不能仅凭更短就认定等价。

组合步骤逐层展开保存独立卡片。

原书依据 · 1 处

3.9 SLAP

SLAP要求函数内叙述处于同一抽象层次。制作咖啡的入口讲选粉、加水、调味和搅拌,把咖啡类型与加奶加糖的分支放进对应步骤。它与组合函数相配合:拆出子函数提供层次,统一层次让高层主线不再与局部实现交错。Spring refresh示例则用初始化阶段方法组织生命周期,同时保留异常清理。

组合函数同层

SLAP要求一个函数中的叙述处于相近抽象层次。入口可只列选粉、加水、调味、搅拌,把粉种和糖奶分支留给子函数。组合函数提供分解结构,SLAP检查每层是否混入底层细节。层次由读者理解的业务步骤决定,不必把每条语句都拆成方法。

组合函数同层保存独立卡片。

原书依据 · 1 处

3.10 函数式编程

函数式写法可把行为作为值传入通用处理过程。Java示例用Function承接字符串转换,依次比较具名类、匿名类、Lambda与方法引用。Lambda省去样板代码,并不自动消除共享状态或副作用,因此也不自动保证并行安全。

函数值压缩行为样板

行为可通过函数式接口作为参数传递,通用流程就能复用不同操作。Java的字符串转整数示例可写为Function<String,Integer> f = Integer::parseInt;,减少具名类和匿名类的样板。语法简短不等于函数纯净:若Lambda操作共享可变状态,线程安全仍需单独判断。

函数值压缩行为样板保存独立卡片。

原书依据 · 1 处

3.11 本章小结

函数章从参数分组与职责划分出发,用组合函数和SLAP组织主线,再把缓存等支撑行为抽离。最终目标是让读者理解行为,不是机械追求零参数、固定行数或短语法。私海是销售人员专属客户库,公海是共享客户资源库。

第4章 设计原则

设计原则提供比较方案的视角:职责检查变化原因,开闭安排扩展,替换维护行为契约,接口隔离减少无关依赖,依赖倒置保护规则免于直接绑定细节。DRY与YAGNI提醒在重复与预设计之间寻找时机,三次原则只是观察提示。原则的用途是改善设计结果,不是让术语数量增加。

原则服务权衡

设计原则是组织经验的判断工具,用来改善可理解性、可扩展性和维护成本。应用时先识别当前问题,再比较收益和代价;原则之间可能存在张力,需要结合上下文取舍。为满足名称而增加无用抽象,会违背控制复杂度的目的。

原则服务权衡保存独立卡片。

原书依据 · 1 处

4.1 SOLID概览

SOLID将单一职责、开闭、里氏替换、接口隔离和依赖倒置放在同一组设计语言里。它们共同关注变化如何被隔离、契约如何被依赖;这是关联视角,不表示严格地分成目标与方法或保证一旦采用就稳定。

SOLID五个设计视角

SOLID包含单一职责、开闭、里氏替换、接口隔离和依赖倒置五个原则,分别帮助检查变化原因、扩展方式、替换契约、客户端依赖与抽象方向。这些视角互有关联,可共同分析一个设计;缩写本身不是稳定性证明,也不要求每个问题都增加五套结构。

SOLID五个设计视角保存独立卡片。

原书依据 · 1 处

4.2 SRP

模块职责可用独立变化原因检查。矩形的绘制与面积计算可能因不同需求改变,因此可把绘制分离,并选择数据与函数分开或保留业务数据和面积、委托绘制等方案。关键是隔离变化,不是规定一个类只能有一个方法。

职责按变化原因分离

单一职责用独立变化原因检查模块边界。矩形的绘制方式和面积规则可能分别变化,可把绘制移到独立对象,让领域对象保留其业务数据与计算。是否拆分要看变化来源和内聚性;两个方法不必然是两个职责,一个方法也可能混入多种变化原因。

职责按变化原因分离保存独立卡片。

原书依据 · 1 处

矩形职责分离结构

矩形示例提供两种组织方式:把数据抽为RectangleData供绘制与面积计算使用,或让Rectangle保留业务表达并委托外部能力。ScreeDrawer是原图的实际拼写;图只保留原图给出的签名,不推测未展示的构造与字段。虚线表示使用依赖,不表示继承或组成生命周期。

结构图:

classDiagram
class RectangleData
class ScreeDrawer {
  +draw()
}
class AreaCalculator {
  +calculate() double
}
ScreeDrawer ..> RectangleData : 使用数据
AreaCalculator ..> RectangleData : 使用数据

矩形职责分离结构保存独立卡片。

原书依据 · 1 处

4.3 OCP

开闭原则把稳定的使用方式与可变实现分离,使新需求尽量通过扩展接入。多态、策略或包装是可用手段,但扩展点不能被完全预知;过度预留会增加成本,而且新增实现仍可能影响已有行为,不能免除验证。

开闭封装变化

开闭原则希望把稳定契约与变化实现分开,使新行为尽量通过扩展接入,例如策略接口接入新算法。先识别真实变化方向,再决定扩展点;无法预见的变化仍可能要求修改。新增类也可能改变组合行为,因此“不改旧代码”不等于没有回归风险。

开闭封装变化保存独立卡片。

原书依据 · 1 处

4.4 LSP

里氏替换关注可观察行为:使用父类型契约的代码换成子类型之后仍应满足正确性。检查重点是子类型是否维持原有允许的操作和含义;覆盖方法、类型检查或强制转换只是检查线索,不能仅凭语法判定违反。

继承必须可替换

继承关系要保持父类型的行为契约:依赖父类型的调用者换用子类型后,仍能按原约定工作。覆盖方法本身并不违反原则,关键是是否改变了调用者可依赖的含义、限制或结果。现实中的“是一个”关系不足以证明软件接口适合继承。

继承必须可替换保存独立卡片。

原书依据 · 1 处

4.4.1 警惕instanceof

调用者必须识别子类并强转才能调用某些行为,可能说明它依赖的抽象没有表达真正需要的能力。可以检查是否存在共同语义,再提升到公共契约;并非所有子类特有方法都应上移,否则会迫使不相关类型实现无意义行为。

类型分支检查抽象缺口

调用者若反复用instanceof识别子类才能完成同一职责,应检查公共抽象是否遗漏共同能力。存在真实共同语义时,可提升为通用契约并让实现各自完成。类型检查不是自动违例,也不能把所有子类方法盲目搬进父类;先确认所有实现都能满足该契约。

类型分支检查抽象缺口保存独立卡片。

原书依据 · 1 处

4.4.2 子类覆盖父类函数

矩形接口允许独立设置宽和高,而本书Square覆盖这两个方法直接抛异常,增加setLength同时设置两边。调用者若只知道Rectangle便无法安全替换成Square;问题出在可变操作契约,而非两个形状面积公式的数学矛盾。

矩形子类破坏契约

Rectangle承诺可分别设置宽高;本书Square继承后拒绝这两个操作,只接受等边设置。依赖矩形接口的调用者因此遇到新异常,替换契约被破坏。这里的冲突源自可变接口,不是数学上正方形不属于矩形;不同接口设计可能避免该冲突。

结构图:

classDiagram
class Rectangle {
  #int width
  #int height
  +setWidth(int width) void
  +setHeight(int height) void
  +area() int
}
class Square {
  +setWidth(int width) void
  +setHeight(int height) void
  +setLength(int length) void
}
Rectangle <|-- Square : 原示例继承

空心三角指向父类;Square前两个覆盖方法在原示例中均抛异常,图示关系不代表这种继承合理。

矩形子类破坏契约保存独立卡片。

原书依据 · 1 处

4.5 ISP

接口隔离从客户端真正需要什么出发。某客户端只用少数能力时,不应被迫依赖其他无关方法;可按职责拆接口,减少变化牵连。拆得越碎越好并不是目标,界面仍要能表达一个连贯能力。

接口按客户端能力分离

接口隔离要求客户端只依赖自己需要的能力。若不同客户端使用大接口的不同部分,可按连贯职责拆开,减少无关变化的牵连。拆分以实际使用关系和内聚性为准,不是每个方法都建立一个接口;小接口仍需有可理解的业务含义。

接口按客户端能力分离保存独立卡片。

原书依据 · 1 处

4.6 DIP

依赖倒置使高层业务围绕需要的契约表达,而由低层实现适配该契约。日志例子用MyLogger隔离具体日志框架;架构层则让领域逻辑免于直接依赖基础设施。增加一层包装要服务明确边界,不能把再包一层本身当成质量保证。

依赖抽象

依赖倒置使高层规则和低层实现都围绕稳定抽象协作,抽象表达高层需要的能力,具体实现适配它。例如业务依赖日志契约,适配器再连接具体框架。这样更换低层实现可少影响业务;并非任意增加一个接口就已正确倒置,契约归属和依赖方向仍要清楚。

依赖抽象保存独立卡片。

原书依据 · 1 处

4.7 DRY

重复实现同一规则会让修改散落在多处,容易漏改或逐渐不一致。DRY通过识别同一知识来源并共享其实现减少这种风险;不能因为两段代码长得像,就认定它们会因同一个原因变化。

同一规则避免多处实现

同一规则被独立实现多次,变更时可能需要四处同步并产生矛盾。DRY鼓励为确实共享的知识和行为建立单一维护入口,减少散弹式修改。先确认重复属于同一规则与变化原因;只是暂时相似的代码,过早合并可能制造不必要耦合。

同一规则避免多处实现保存独立卡片。

原书依据 · 1 处

4.8 YAGNI

YAGNI反对提前投入尚无证据需要的功能和扩展结构,让当前软件保持可用且简洁。它与DRY会产生时机上的张力,但不必然冲突:当前已经重复且确有共同规则时,消除重复本身就是当前需要。

推迟无依据的预设计

YAGNI提醒不要为假想未来需求提前实现功能和复杂扩展结构,应先交付当前需要的行为。它不等于完全不设计,也不阻止处理已经出现的重复与风险。是否抽象可依据当前证据与变化成本决定,避免把“以后可能需要”当作无限加层的理由。

推迟无依据的预设计保存独立卡片。

原书依据 · 1 处

4.9 Rule of Three

三次原则用重复出现作为重新检查抽象的时机:第一次解决具体问题,第二次观察相似性,第三次考虑共同实现。它平衡重复维护和过早抽象,是经验提示,并非必须先复制三次的硬性规则。

三次再抽象

三次原则把重复出现作为抽象的观察信号:先解决具体问题,再从后续相似需求中识别稳定共性,第三次出现时认真考虑共同实现。它平衡重复维护与提前猜测的成本,是经验法则;若共享规则已明确,可更早抽象,若只表面相似,也不应机械合并。

三次再抽象保存独立卡片。

原书依据 · 1 处

4.10 KISS原则

KISS追求对使用者和维护者真正简单的表达。达到简单常需要先分析多种关系再收束到核心,不能把不做设计、直接堆代码当作简单;简陋方案可能只是把复杂度推迟给后来人。

简单来自分析收束

KISS要求控制不必要的复杂度,让设计易懂易用。做到这一点常需要先理解问题、探索方案,再收束为少量清楚的概念和关系。简单不等于省略思考或必要保障;外表代码短,却把歧义和维护成本留给调用者,也未必简单。

简单来自分析收束保存独立卡片。

原书依据 · 1 处

4.11 POLA原则

最小惊奇要求接口行为符合使用者根据名称、规范和既有经验形成的合理预期。约定稳定可减少反复猜测,但“惊奇度”在这里是理解成本的类比,不是本轮计算的软件复杂性指标。

接口行为符合合理预期

接口和代码应尽量符合目标读者的合理预期,让名称、行为与项目约定一致,减少突然的特殊规则。规范可为这种预期提供共同基础;若存在必要例外,应显式表达原因和限制。原则不是禁止新设计,也不能把熟悉的旧行为当作永远正确。

接口行为符合合理预期保存独立卡片。

原书依据 · 1 处

4.12 本章小结

设计原则共同服务于可用软件和较低复杂度。当原则相互牵制,应比较当前问题、真实变化与维护成本,选择有理由的折中,而不是为了满足术语而制造更多层次。

第5章 设计模式

模式把典型问题与可复用协作结构连接。GoF三类23种模式提供词汇,拦截器围绕目标安排横切行为,插件管理外部扩展,管道组合阶段处理。使用模式需要说明原问题、顺序和边界;本章拦截器草稿的重复执行缺陷说明结构看似正确并不替代控制流核对。

5.1 模式

模式在理论原则和具体实现之间提供可迁移的范例。模式不是现成框架,也不是无条件套用的流程;要理解它回答的问题和适用情境,再决定是否用于当前设计,使用数量并不是设计水平的指标。

模式不是套件

设计模式是典型问题及其可复用解决结构的范例,帮助团队用共同语言讨论设计。它不是可直接装入系统的框架,也不能脱离问题情境照搬。先识别反复出现的协作问题,再比较模式的收益和代价;模式用得多不代表设计更好。

模式不是套件保存独立卡片。

原书依据 · 1 处

5.2 GoF

GoF整理23种模式,以创建、结构、行为三种任务分类。这里逐一介绍各模式的基本用途,具体实现仍需结合对象职责、变化方向和使用契约;命令不天然拥有可靠重试,观察者也不天然保证跨节点投递。拦截器、插件与管道不在这23种清单内,本章后续单独展开。

单例控制实例入口

单例限制某个类的实例数量,并提供统一访问入口,用于需要共享同一对象的场景。它解决实例与访问方式的约束,不自动保证对象内部状态线程安全。

单例控制实例入口保存独立卡片。

原书依据 · 1 处

原型复制现有对象

原型以已有对象为模板复制新实例,适合创建过程依赖既有配置的对象。复制产生新对象,但引用成员是否继续共享仍要由复制契约说明,不能只凭“复制”假定完全独立。

原型复制现有对象保存独立卡片。

原书依据 · 1 处

工厂方法委托创建

工厂方法为产品创建定义接口,由具体子类决定创建哪一种产品,使使用产品的流程不必直接绑定所有具体构造。扩展应围绕真实产品差异,不是给每次new都机械加一层。

工厂方法委托创建保存独立卡片。

原书依据 · 1 处

抽象工厂创建产品族

抽象工厂提供创建一组相关产品的接口,使不同实现能给出对应的产品族。它关注多个产品之间的配套关系,区别于只选择一个产品的创建方式。

抽象工厂创建产品族保存独立卡片。

原书依据 · 1 处

建造者分步构造

建造者把复杂对象的构建分解为较简单的部分,再按需要组合得到结果。它分离构建步骤与最终表达,适合有多个构建环节的对象;简单对象未必需要额外构建结构。

建造者分步构造保存独立卡片。

原书依据 · 1 处

代理控制访问

代理位于客户端和目标对象之间,代表目标提供访问入口,可控制、增强或限制访问。理解代理时要看被代理的操作和访问契约,不能把任何转发对象都当成相同的代理机制。

代理控制访问保存独立卡片。

原书依据 · 1 处

适配器转换接口

适配器把已有接口转换为使用者需要的接口,使原本接口不兼容的对象能够协作。转换要说明两边语义如何对应;接口形状相似并不保证行为可直接映射。

适配器转换接口保存独立卡片。

原书依据 · 1 处

桥接分开变化维度

桥接把抽象部分和实现部分分开,通过组合协作,使两个维度可以各自演进。重点是识别相对独立的变化维度,而不是为固定对象任意增加一组继承层。

桥接分开变化维度保存独立卡片。

原书依据 · 1 处

装饰包装附加职责

装饰通过包装对象动态附加职责,使原对象不必为每种功能组合建立新类型。附加行为仍应符合调用者依赖的接口含义,包装层次增加时也需要检查执行顺序。

装饰包装附加职责保存独立卡片。

原书依据 · 1 处

外观统一子系统入口

外观为多个复杂子系统提供一致的使用入口,减少客户端了解内部协作细节的负担。它简化的是访问界面,不意味着子系统内部复杂度已消失。

外观统一子系统入口保存独立卡片。

原书依据 · 1 处

享元共享细粒度对象

享元通过共享可复用的细粒度对象减少重复占用,适合大量相似对象的使用场景。共享前要分清哪些状态能够共同使用,不能把具有不同可变状态的对象简单混为一个。

享元共享细粒度对象保存独立卡片。

原书依据 · 1 处

组合统一树状访问

组合把单个对象和对象集合组织为树状层次,使使用者能以一致方式访问叶子与组合节点。它适合整体和部分具有共同操作含义的结构,不要求所有树形数据都实现同一业务接口。

组合统一树状访问保存独立卡片。

原书依据 · 1 处

模板方法固定算法骨架

模板方法固定一组处理步骤的骨架,把部分步骤留给子类定制。它适合主流程稳定而局部行为变化的场景;定制仍须维护骨架的顺序和契约。

模板方法固定算法骨架保存独立卡片。

原书依据 · 1 处

策略封装可替换算法

策略把一组实现同类目标的算法分别封装,让使用者通过共同契约选择替换。替换应维持调用者需要的输入输出含义,不能仅因方法签名相同就视为可互换。

策略封装可替换算法保存独立卡片。

原书依据 · 1 处

命令分开发出与执行

命令把请求表示成对象,使发起请求的一方与负责执行的一方分离。它先解决请求表达和责任边界;是否可排队、重试或撤销,还需另外实现相应契约。

命令分开发出与执行保存独立卡片。

原书依据 · 1 处

职责链逐个传递请求

职责链让请求沿多个处理对象传递,直至某个处理者响应或按规则终止。它减少发起者对具体处理者的了解,但链的顺序、继续条件和无人处理时的结果必须明确。

职责链逐个传递请求保存独立卡片。

原书依据 · 1 处

状态对象承接行为变化

状态模式让对象的行为随内部状态改变而变化,把状态相关行为组织为明确职责。它用于表达状态与操作含义的联系;合法迁移和异常处理仍需由具体状态模型定义。

状态对象承接行为变化保存独立卡片。

原书依据 · 1 处

观察者通知依赖对象

观察者围绕一对多的依赖关系组织通知:被观察对象改变时,相关观察者得到通知并响应。通知机制本身不保证响应的执行顺序、事务原子性或跨节点可靠投递。

观察者通知依赖对象保存独立卡片。

原书依据 · 1 处

中介者集中交互规则

中介者把多个对象之间的交互集中到一个协作入口,减少它们彼此了解的需要。它隔离对象间的联系,但中介对象本身仍应保持清晰职责,避免变成新的全能控制器。

中介者集中交互规则保存独立卡片。

原书依据 · 1 处

迭代器隐藏遍历实现

迭代器提供顺序访问聚合元素的方式,使调用者不必直接掌握集合内部表示。遍历时是否允许修改、怎样结束等行为仍应查看具体迭代契约。

迭代器隐藏遍历实现保存独立卡片。

原书依据 · 1 处

访问者分离元素操作

访问者把作用于一组元素的操作放到独立访问对象中,使同一元素结构能接受不同处理。它分离的是元素与操作职责;是否便于扩展还取决于元素类型与操作各自的变化频率。

访问者分离元素操作保存独立卡片。

原书依据 · 1 处

备忘录保存恢复状态

备忘录在不破坏封装的前提下保存对象状态,供之后恢复。保存的是约定范围内的状态,不自动包含外部系统副作用,因此恢复能力需要明确边界。

备忘录保存恢复状态保存独立卡片。

原书依据 · 1 处

解释器表达语言规则

解释器为一类语言定义文法及其解释方式,把句子的含义转为可执行处理。它适合规则明确的特定语言,不能把简单条件判断都扩大成完整语言框架。

解释器表达语言规则保存独立卡片。

原书依据 · 1 处

GoF按设计任务分类

GoF的23种模式分为三类:5种创建型关注对象如何产生,7种结构型关注对象和类如何组合,11种行为型关注职责分配与协作。分类帮助定位设计问题,并不表示模式彼此孤立;一个系统可组合使用多种模式,但仍应逐一说明适用情境。

GoF按设计任务分类保存独立卡片。

原书依据 · 1 处

5.3 拦截器模式

拦截器在核心操作之前或之后插入横切处理。TargetInvocation组织目标与拦截器序列,拦截器决定是否继续调用链;日志拦截器可在继续前后记录。原书invoke忽略拦截器返回值,递归回来又执行目标,因此不能按展示输出认定目标只执行一次。结构与控制流必须同时正确,不能仅凭日志看起来符合预期。

拦截器隔离切面

拦截器围绕目标操作安排日志、审计等横切行为,调用组织者按顺序把控制交给拦截器,拦截器可继续或中止。原示例invoke()忽略intercept()返回值,递归返回后又执行目标,会造成额外执行;正确理解模式不能直接照抄这段草稿。

结构图:

classDiagram
class Target {
  <<interface>>
  +execute(Request request) Response
}
class Interceptor {
  <<interface>>
  +intercept(TargetInvocation targetInvocation) Response
}
class TargetInvocation {
  +invoke() Response
  +addInterceptor(Interceptor interceptor) void
}
class AuditInterceptor {
  +intercept(TargetInvocation targetInvocation) Response
}
class LogInterceptor {
  +intercept(TargetInvocation targetInvocation) Response
}
TargetInvocation o-- Interceptor : 组织序列
TargetInvocation --> Target : 调用目标
Interceptor ..> TargetInvocation : 决定继续
Interceptor <|.. AuditInterceptor
Interceptor <|.. LogInterceptor

空心三角虚线表示实现接口,空心菱形表示持有序列,依赖箭头表示使用;不声称TargetInvocation拥有拦截器生命周期。

拦截器隔离切面保存独立卡片。

原书依据 · 1 处

5.4 插件模式

插件把扩展实现交给宿主之外的组件,宿主先定义扩展点,框架再完成发现、描述、注册、依赖处理和激活。外部组件独立打包不等于必然热加载;是否运行中加载卸载取决于框架的类加载、状态与生命周期管理。

插件外部扩展

插件把新增能力放在宿主之外的组件中,由宿主定义扩展点、插件提供实现,框架管理发现、注册、依赖和激活。插件能减少修改宿主的需要,但独立打包不自动代表可安全热部署;类加载、资源释放和版本契约仍须明确。

结构图:

classDiagram
class PluginRegistry {
  +register()
}
class PluginDescriptor {
  +getExtensionPoint(uniqueId)
}
class ExtensionPoint {
  +getConnectedExtensions()
}
class Extension {
  +getExtensionPoint()
  +getParameters()
}
class PluginManager {
  +getRegistry()
  +activate(String pluginId)
  +deactivate(String pluginId)
}
class Plugin {
  +doStart()
  +getPluginDescriptor()
  +getManager()
}
PluginRegistry o-- PluginDescriptor
PluginDescriptor o-- ExtensionPoint
ExtensionPoint o-- Extension
PluginManager --> PluginRegistry : 使用注册信息
PluginManager --> Plugin : 激活
Plugin ..> PluginDescriptor : 读取描述

空心菱形为原图聚合,实线箭头为使用关系,虚线为依赖;原图没有返回类型及uniqueId参数类型,故不补造。

插件外部扩展保存独立卡片。

原书依据 · 1 处

5.5 管道模式

管道把一个连续处理过程分成多个阶段,各阶段负责一部分转换,再依次组合。水处理只是类比,软件中真正需要明确的是阶段输入输出、顺序以及继续和终止条件。

5.5.1 链式管道

链式管道通过每个阀门保存下一节点来传递数据。StandardPipeline维护头尾并把新阀门插在尾节点前,普通阀门处理后继续,尾阀门处理后结束。示例先设置尾节点、再添加普通节点,从头传入字符串;这个初始化顺序是演示成立的条件。

管道拆分流程

链式管道让每个Valve处理输入后交给下一节点。StandardPipeline维护头尾,新普通阀门插在尾节点之前;TailValve处理后停止。示例须先设置tail再添加节点,空链和修改尾节点的行为未完整定义,不能直接作为生产通用容器。

结构图:

classDiagram
class Valve {
  <<interface>>
  +getNext() Valve
  +setNext(Valve v) void
  +invoke(String s) void
}
class ValveBase {
  <<abstract>>
  +Valve next
  +getNext() Valve
  +setNext(Valve v) void
  +invoke(String s) void
}
class FirstValve {
  +invoke(String s) void
}
class SecondValve {
  +invoke(String s) void
}
class TailValve {
  +invoke(String s) void
}
class Pipeline {
  <<interface>>
  +getHead() Valve
  +getTail() Valve
  +setTail(Valve v) void
  +addValve(Valve v) void
}
class StandardPipeline {
  #Valve head
  #Valve tail
  +getHead() Valve
  +getTail() Valve
  +setTail(Valve v) void
  +addValve(Valve v) void
}
Valve <|.. ValveBase
ValveBase <|-- FirstValve
ValveBase <|-- SecondValve
ValveBase <|-- TailValve
Pipeline <|.. StandardPipeline
ValveBase --> Valve : next
StandardPipeline --> Valve : 头与尾

虚线三角为接口实现,实线三角为继承,普通箭头表示引用;节点持有next并不等于拥有下一节点的生命周期。

管道拆分流程保存独立卡片。

原书依据 · 1 处

5.5.2 流处理

流处理把数据经过一连串阶段转换。UNIX管道连接程序的输出与输入;Java Stream则把筛选和分组写成操作链,直到终止操作触发求值。sort等阶段可能需要缓存数据,因此流式表达不保证全过程一次只占用一个数据项的空间。

流管道连接处理阶段

流处理把前一阶段的输出接到后一阶段的输入。UNIX例子依次连接文件、转小写、排序、取末三行;Java例子先筛选金额大于1000的交易,再按货币分组。阶段组合突出处理意图,但排序或分组可能积累数据,不能据“流”字断言恒定内存。

结构图:

flowchart TD
 A[读取交易] --> B[筛选金额大于1000]
 B --> C[按货币分组]
 C --> D[得到分组映射]

流管道连接处理阶段保存独立卡片。

原书依据 · 1 处
流操作延迟求值

Java Stream可以先描述筛选等处理阶段,在终止操作触发时求值;本书例子用collect把筛选后的交易按货币分组。collect是终止操作的一个例子,不表示只有收集才能执行流。写出操作链只建立处理描述,是否需要遍历、缓存和多少内存还取决于具体操作。

流操作延迟求值保存独立卡片。

原书依据 · 1 处

5.6 本章小结

模式提供共享的设计语言,但采用的理由应来自真实场景。GoF分类提供基本词汇,拦截器围绕目标插入行为,插件管理外部扩展,管道组合处理阶段;它们各有结构与契约,不以模式数量评价设计。

第6章 模型

模型是按目的筛选信息的表达,不是现实本身。物理、数学、概念与思维模型服务不同问题;UML提供共享符号,类图要准确区分关联、依赖、继承和实现。C4、页面与业务流程图补不同视角,好的表示法让读者理解同一问题,而不是只让画面整齐。

6.1 什么是模型

模型为某个问题保留重要特征、隐藏无关细节,是目的明确的简化抽象。同一对象可以因问题不同而使用不同表达;判断模型好坏要看能否帮助理解与解决当前问题,而不只是符号是否复杂。

模型按目的省略细节

模型是为理解某个问题而建立的简化表达,只保留当前目的相关的性质和关系。同一对象可有多个模型,因为读者与任务不同。先说明模型要回答什么,再选择符号与工具;模型越详细不代表越有用,省略部分也不表示现实不存在那些部分。

模型按目的省略细节保存独立卡片。

原书依据 · 1 处

6.1.1 物理模型

物理模型以有形实体表达对象,可按需要缩小、放大或等比例构造。汽车、建筑和风洞模型把部分空间特征或实验条件变得可观察;比例相似仍不表示每种性质都自动一致。

物理模型以实体表达

物理模型用有形实体表达被研究对象,可缩小、放大或保持原尺度,例如汽车模型和实验模型。它便于观察空间结构或特定行为,但代表哪些性质仍取决于建模目的和相似条件,不能仅凭外形相像就代替真实系统。

物理模型以实体表达保存独立卡片。

原书依据 · 1 处

6.1.2 数学模型

数学模型用方程、变量和参数表达对象之间的关系,用来描述或预测特定行为。图中将4S店相关信息抽取为特征,再拟合直线;其公式和散点表达线性回归,图中“线性逻辑回归”文字不作为模型类型的正确依据。

数学模型表达变量关系

数学模型用变量、方程和参数表示系统关系,可用于描述、计算或预测。建立时要确定保留哪些量以及关系的假设;拟合出关系不自动证明因果。本书销售预测图的线性公式与散点直线是回归示意,不能仅凭图中文字把它当成逻辑回归分类模型。

数学模型表达变量关系保存独立卡片。

原书依据 · 1 处

6.1.3 概念模型

概念模型描述问题域中的事物和联系,不先绑定数据库或具体程序。汽车的轮子和发动机等概念能作为分析入口;图用UML类图形式表达,不意味着概念模型已经等于最终代码结构。

概念模型先表达业务

概念模型表达问题域中的事物、性质和关系,先帮助人们形成业务认识,不绑定具体程序或数据库。即使使用类图表示,也不代表每个概念都应直接变成一张表或一个代码类;技术设计还需考虑边界与实现约束。

概念模型先表达业务保存独立卡片。

原书依据 · 1 处

6.1.4 思维模型

思维模型用结构化表达组织思考过程,使某类问题的分析方式可被复用。金字塔模型是后文实例;模型的适用情境仍需说明,不能把一套思考套路作为所有问题的答案。

思维模型组织分析

思维模型用图形、符号或结构化语言组织分析步骤,帮助人们复用某类解决问题的方式。它像一套可检查的思考框架,而不是保证结论正确的公式;使用前仍要确认目标、信息和适用条件。

思维模型组织分析保存独立卡片。

原书依据 · 1 处

6.1.5 模型不能代替现实

模型受观察视角和已有认识影响,只能代表某些方面。软件模型应随需求和问题理解变化而调整,像代码重构一样维护其有效性;当前能解释问题的模型也不意味着永远正确。

模型需要迭代

模型受观察视角和已有知识限制,是为当前问题建立的简化表达,不能取代现实。需求变化或理解加深后,应检查概念、关系和边界是否还合适,并调整模型及实现。一次模型能够解释当前案例,不代表它对所有情境都成立。

模型需要迭代保存独立卡片。

原书依据 · 1 处

6.2 UML

UML为软件模型提供共同符号,不同图从不同角度表达结构或行为。它帮助交流系统视图,但每张图只覆盖某个目的;类图尤其适合表达概念和类型关系,后文区分其元素与关系符号。

UML共享模型符号

UML提供表达结构和行为的共同建模符号,使读者能在一致表示法下讨论系统。选择图形应依据读者、阶段和问题:类图表达类型与关系,其他图可表达行为视角。共同符号提高交流一致性,但一张图并不覆盖系统全部事实。

UML共享模型符号保存独立卡片。

原书依据 · 1 处

6.3 类图

类图由类和类之间的关系构成。分析阶段可用它讨论概念的角色与责任,设计阶段可记录实现类型的结构;先辨别图服务哪个阶段,再决定符号是否对应实际代码。

6.3.1 类的UML表示法

类图用分区矩形表达类名、属性和操作,属性与方法带类型与可见性。Employee例子中图和文字写getName():String,Java草稿却写void后返回name;笔记按图的有效签名表达并标明代码错误,不能照抄编译。

类图标明属性与操作

类图可分为类名、属性和操作三部分,用+、-、#分别表示公有、私有和受保护。Employee图的getName返回String;原Java片段写void却返回name,与图矛盾,不能直接编译。图应保存真实语义,不能把矛盾签名同时当成正确实现。

结构图:

classDiagram
class Employee {
  -String name
  -int age
  -String email
  +getName() String
}

类图标明属性与操作保存独立卡片。

原书依据 · 1 处

6.3.2 类的关联关系

关联表达对象间稳定联系,多重性说明每一端允许关联多少对象,限定符则在某个键或场景下选择目标。整体与部分还需区分聚合和组合:前者允许部分独立,后者强调所有权与生命周期约束。代码里持有字段或是否有setter只是线索,不能单独决定UML关系。

关联多重性表达数量

关联表示对象之间的结构联系。多重性规定另一端的一个对象可对应多少本端对象,如0..1、1..*、0..*。还要分别说明导航方向和角色,不能把关联线、阅读方向与对象数量混为一谈;未标导航也不应自动推断代码已双向持有引用。

关联多重性表达数量保存独立卡片。

原书依据 · 1 处
限定符选择关联目标

限定关联在某个键或场景下选择目标;User可拥有多个Role,但同一scenario映射一个Role。示例用Map保存关联,getRole按场景取值;键缺失时如何处理需由接口另行规定,图示单值并不保证运行中一定存在。

结构图:

classDiagram
class User {
  -Map~String,Role~ roles
  +getRole(String scenario) Role
}
class Role
User --> Role : 按scenario选择

普通箭头表示单向使用;限定条件写在线上,不能把整个User到Role关系误画成始终只有一个角色。

限定符选择关联目标保存独立卡片。

原书依据 · 1 处
节点自关联

自关联表示同一种类型的实例之间仍可存在关系。例如Node通过subNode字段引用另一个Node,可表达递归层次。字段类型相同不代表自动没有环,是否允许环和空引用取决于模型规则。

结构图:

classDiagram
class Node {
  -Node subNode
}
Node --> Node : subNode

节点自关联保存独立卡片。

原书依据 · 1 处
聚合允许部分独立

聚合表示整体与部分的关系,同时部分可以独立存在。Car由外部传入Engine,可在概念上表达发动机独立于某辆车的生命周期;构造或setter注入是示例实现方式,本身不证明所有权规则。

结构图:

classDiagram
class Car {
  -Engine engine
  +Car(Engine engine)
  +setEngine(Engine engine) void
}
class Engine
Car o-- Engine : 原示例聚合

空心菱形在整体端,构造函数Car是类的操作而非独立类型。

聚合允许部分独立保存独立卡片。

原书依据 · 1 处
组合约束部分生命周期

组合强调部分由整体拥有,生命周期受整体约束。Head在构造时创建Mouth是本书示例;真正判断组合仍看模型的拥有关系,不能只因没有setter便推出“共生死”。Java引用可被共享,构造位置也不能单独保证独占。

结构图:

classDiagram
class Head {
  -Mouth mouth
  +Head()
}
class Mouth
Head *-- Mouth : 原示例组合

实心菱形在整体端,用来表达组合所有权,不是垃圾回收的执行图。

组合约束部分生命周期保存独立卡片。

原书依据 · 1 处

6.3.3 类的依赖关系

依赖表示一个元素使用另一个元素,后者变化可能影响前者。方法参数、局部对象和调用静态方法都可产生使用依赖;Teacher把Projector作为方法参数并调用演示,没有展示需要长期持有投影仪的字段。

临时使用表达依赖

依赖表示某元素使用另一元素,其变化可能影响使用方。Teacher在use方法中接收Projector并调用demonstrate,表达一次使用,不必推断长期拥有。参数、局部变量和静态调用都可能形成依赖。

结构图:

classDiagram
class Teacher {
  +use(Projector projector) void
}
class Projector {
  +demonstrate() void
}
Teacher ..> Projector : 使用

虚线箭头从使用方指向被使用方,不表示继承或生命周期所有权。

临时使用表达依赖保存独立卡片。

原书依据 · 1 处

6.3.4 类的泛化关系

泛化用共同父类型表达共享性质,子类再增加自身特征。Person保留姓名和年龄,Student增加学号,Teacher增加教师编号;结构上的继承仍需满足第4章的行为替换约束。

泛化提取共同类型

泛化用父类型表达共有属性和行为,子类型保留专有特征。Person含name和age,Student、Teacher分别增加学生和教师编号。共享结构只是继承关系的一部分,行为是否可替换仍应按父接口契约检查。

结构图:

classDiagram
class Person {
  #String name
  #int age
}
class Student {
  -String studentNo
}
class Teacher {
  -String teacherNo
}
Person <|-- Student
Person <|-- Teacher

实线空心三角指向父类;省略的原文方法不补造。

泛化提取共同类型保存独立卡片。

原书依据 · 1 处

6.3.5 接口与实现关系

接口规定能力,实现类型提供具体行为。Metrics实现Measurable,而Statistics依赖这个可度量契约;类图的实现箭头与使用依赖不同,插座表示的是需要接口,不能当成继承。

接口实现与使用分开

接口表达一个可提供的能力,实现类型负责满足契约,使用者可以只依赖接口。Metrics实现Measurable,Statistics需要它进行度量;二者分别是实现关系和使用依赖,不能混成继承。

结构图:

classDiagram
class Measurable {
  <<interface>>
  +measure() int
}
class Metrics
class Statistics
Measurable <|.. Metrics
Statistics ..> Measurable : 需要度量能力

虚线空心三角表示实现,普通虚线箭头表示使用。measure():int按本节图69,不与第13章calculateScore示例混用。

接口实现与使用分开保存独立卡片。

原书依据 · 1 处

6.4 领域模型

软件开发把业务问题转成可实现的解决方案。领域模型帮助识别业务关键概念和关系,为用户、分析人员与开发者提供共同认识,再指导设计;它是这座桥中的表达,不能等同于数据库、代码或整个解决方案空间。

领域模型搭桥

领域模型表达某一业务范围内的关键概念和关系,帮助用户、分析人员与开发者共同理解问题,并为后续设计提供依据。它把业务认识连接到软件实现,但不等同于整个技术方案,更不等于一组数据库表。模型应围绕要解决的业务问题组织,而非先按技术分层堆名词。

领域模型搭桥保存独立卡片。

原书依据 · 1 处

6.5 敏捷建模

敏捷建模以理解、交流和交付为目标,采用足够简单的工具,允许模型随认识变化。每个模型都应知道读者与用途;完成使命后可不再维护,必要时用多种视角表达同一系统,而不是为文档数量画图。

敏捷建模

敏捷建模用模型改善理解、沟通和软件交付。先确定读者与目标,再选择足够简单的工具和适当视角;保留有持续价值的模型,允许其随需求变化,已完成使命的临时模型可舍弃。交付重点是可用软件,不能把模型数量或精美程度当成成效。

敏捷建模保存独立卡片。

原书依据 · 1 处

6.6 广义模型

建模不被某套图形语言垄断。只要表达能帮助抽象问题、让读者理解并高效沟通,就可以作为模型;下一组小节分别用C4、页面跳转和业务动线说明。

6.6.1 C4模型

C4用不同缩放层次讨论软件架构:上下文说明系统与外部环境,容器说明主要运行单元,组件再看内部职责,代码层进入实现。容器在这里是架构层级词,不应仅凭名字理解成Docker容器。

C4分层缩放视图

C4以不同缩放层次表达软件架构:上下文看系统与环境,容器看主要运行单元,组件看单元内的职责划分,代码层进入实现。不同读者可选择适合的问题尺度;这里Container是建模层级,不专指某个容器部署产品。

C4分层缩放视图保存独立卡片。

原书依据 · 1 处

6.6.2 UI流程图

UI流程图把页面及其流转连成系统交互路径,用于业务检查和新人理解。电商原型将登录、购物、搜索、购物车、订单汇总和确认连起来,也保留再次搜索或修改订单的返回路径;页面流与后台完整事务流程仍不同。

页面流转检查交互

UI流程图用页面节点和跳转关系表达用户怎样完成任务,可检查入口、返回、分支和终止路径,也适合介绍业务。图中的购物流程含搜索、选品、购物车、订单汇总和确认;它表达页面导航,不自动说明后台状态、权限和交易原子性。

页面流转检查交互保存独立卡片。

原书依据 · 1 处

6.6.3 业务模型

业务图可以给线条、粗细、位置和颜色约定明确含义。电商动线以粗细表示流量、虚线表示退出,就医示例以空间上下区分线上线下,再用线表达时间顺序。图例清楚且与读者问题一致,才能支持理解;图的形象不能证明观察数据和因果结论正确。

图形也是模型

建模不限于UML:可以约定线条粗细表示流量、虚线表示退出,或用位置区分线上线下步骤。图形元素须有清楚含义,并服务读者要回答的问题。可视化能显露路径与关系,但不能凭图好看就认定数据可靠或已经证明原因。

图形也是模型保存独立卡片。

原书依据 · 1 处

6.7 本章小结

模型是为理解和交流而选择的表达。UML提供公共符号,C4组织架构尺度,页面和业务图则从用户路径或运营问题出发;选择依据是用途和读者,模型还需随认识更新。

第7章 DDD的精髓

DDD把语言、概念、行为与边界连起来。账户规则可回到账户和透支策略,聚合通过根维护不变式,领域服务协调不自然属于单体的行为,事件表达过去事实,上下文限定词义。用例分析与四色建模提供候选组织方式;模型仍需与代码反复演化,Repository等名字不能代替实际领域分析。

7.1 什么是DDD

领域驱动设计通过共享语言、划定领域边界和建立业务模型来组织复杂规则。本书对比把行为集中在Service与把规则交回业务对象;这是一种职责安排,不意味着使用Spring或Hibernate就必然不能进行DDD。

DDD控复杂

领域驱动设计围绕业务模型组织语言、边界和行为,帮助团队处理复杂业务规则。它关心概念如何保持一致、规则由谁负责,而不只是把数据对象改名为实体。采用某个框架不自动得到DDD,使用事务脚本也不必然混乱;应按问题复杂度和维护成本选择组织方式。

DDD控复杂保存独立卡片。

原书依据 · 1 处

7.2 初步体验DDD

转账示例比较两种组织方式。事务脚本把透支检查和余额修改写在转账服务里;领域模型让Account.debit/credit表达账户行为,再由OverdraftPolicy承担不同透支规则,转账服务负责协调两个账户和交易记录。这只是职责与策略的示意:代码中的double金额、持久化省略号及缺少并发、重试说明,都使它不能代表可直接上线的完整资金实现。

行为回到实体

将与账户紧密相关的扣减、入账和透支规则放回账户及策略对象,协调服务就可专注账户之间的转账流程。这样业务概念由类型与方法显式表达,规则也更集中。示例未说明完整事务、并发和重试保障,不能把领域对象封装当成资金正确性的充分条件。

结构图:

classDiagram
class Account {
  -String id
  -double balance
  -OverdraftPolicy overdraftPolicy
  +balance() double
  +debit(double amount) void
  +credit(double amount) void
}
class OverdraftPolicy {
  <<interface>>
  +preDebit(Account account, double amount) void
  +postDebit(Account account, double amount) void
}
class NoOverdraftAllowed {
  +preDebit(Account account, double amount) void
  +postDebit(Account account, double amount) void
}
class LimitedOverdraft {
  -double limit
  +preDebit(Account account, double amount) void
  +postDebit(Account account, double amount) void
}
Account --> OverdraftPolicy : 扣减前后调用
OverdraftPolicy <|.. NoOverdraftAllowed
OverdraftPolicy <|.. LimitedOverdraft
OverdraftPolicy ..> Account : 检查账户余额

虚线空心三角是接口实现,其他箭头是调用依赖;double为原例真实字段,不是实际金额类型建议。

行为回到实体保存独立卡片。

原书依据 · 1 处

透支策略封装差异

账户扣款把允许透支与透支额度的规则交给OverdraftPolicy。NoOverdraftAllowed要求扣减后余额非负,LimitedOverdraft允许余额不低于负额度;扣款前校验、之后预留后置处理。这里只组织规则差异,未证明并发时校验和修改具有原子性,也未给出失败回滚的完整实现。

透支策略封装差异保存独立卡片。

原书依据 · 2 处

7.3 数据驱动和领域驱动

接下来用CRM比较以数据库组织实现与以业务概念组织实现的两种起点。

7.3.1 数据驱动

以表为起点时,需求先被转成数据关系,再由服务脚本操作这些数据。CRM可用salesId是否存在区分占有状态,但公海、私海等业务概念可能因此只隐含在字段条件里。数据模型能表达存储关系,却未必直接表达业务操作和责任。

数据模型可能隐去概念

以数据库为中心组织实现时,业务概念可能只体现在字段条件里。CRM例子用机会是否带salesId推断公海或私海,却没有显式表达领地概念;读者需要从条件恢复业务含义。数据关系没有错,问题在于它是否足以支持当前业务的规则表达和维护。

数据模型可能隐去概念保存独立卡片。

原书依据 · 1 处

7.3.2 领域驱动

领域驱动以业务语义和责任为起点,先分析领域与上下文,再建立实体、聚合和值对象等模型,随后安排存储。CRM显式区分Territory及其私海、公海、经理海等概念,让业务人员可共同检查模型;最终仍需要数据映射和技术设计。

领域驱动先组织语义

领域驱动从业务概念、责任和边界出发,再考虑数据怎样存储。CRM把公海、私海等领地显式建模后,团队可直接讨论客户流转,而不是从salesId等字段推断规则。领域模型与数据模型可以不同,两者仍需映射;先画领域图也不能代替后续实现验证。

领域驱动先组织语义保存独立卡片。

原书依据 · 1 处

7.3.3 ORM

ORM在对象和关系数据之间进行映射,能减轻部分持久化工作。它不能替团队决定哪些概念应存在或怎样划分行为。原书从一次实践经历推断Hibernate/JPA衰落,并声称大厂普遍使用MyBatis,这些时代性市场判断不作为已验证事实保留。

ORM不代替领域分析

对象关系映射帮助连接对象表示与关系数据,领域模型和表结构却不必一一对应。映射工具能处理部分持久化机制,不能自动识别公海、私海等业务概念或决定其行为。应先理解模型差异,再选择映射方式;框架选型不能代替领域分析。

ORM不代替领域分析保存独立卡片。

原书依据 · 1 处

7.4 DDD的优势

后续从语言、对象、语义表达和技术分离四方面解释领域模型的收益。收益应落到沟通与复杂度管理,不能以个人喜欢某方法作为充分证据。

7.4.1 统一语言

统一语言由业务与技术共同协商,不是单方面照抄某一方现成词。约定要贯穿PRD、模型、讨论和代码,理解变化时也要同步重构,否则名词表和实际实现会逐渐分离。

统一语言闭环

统一语言由业务与技术共同定义领域术语,再在需求、模型、交流和代码中保持一致。业务方并不天然拥有最佳命名,技术方也不能随意翻译。含义变化后应同步调整相关代码与文档;仅有一份术语表而实现继续分裂,并未形成闭环。

统一语言闭环保存独立卡片。

原书依据 · 1 处

7.4.2 面向对象

DDD的对象分析先识别业务责任和行为,再决定其软件表达,避免一开始就把数据和行为分别分配到表与大Service里。它强调业务意义,不是禁止使用数据库、服务或过程式实现。

业务对象保留责任

业务对象建模先分析事物承担的责任和行为,再安排数据及实现。若一开始只把数据放进表、所有行为塞进大Service,概念容易与规则分离。对象设计应让行为归属有理由,而非为了符合面向对象形式把任意动作硬塞进实体。

业务对象保留责任保存独立卡片。

原书依据 · 1 处

7.4.3 业务语义显性化

透支策略从条件分支变成有名字的业务对象后,读者可以直接讨论规则的含义和替换。统一语言和对象结构共同让业务语义显露,其评价标准仍是是否减少理解与维护的困难。

透支策略封装差异关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

7.4.4 分离业务逻辑和技术细节

把业务规则和UI、数据库、框架等技术机制分开,能让两种变化分别演进。核心规则通过契约使用外界能力,具体实现由外部适配;技术依然重要,只是不让业务表达直接被某个技术选择牵引。

业务与技术分治

业务逻辑表达规则,UI、存储和框架提供运行与接入机制。把二者分开,可分别处理业务变化和技术变化;需要外界能力时通过契约连接并让适配实现依赖核心抽象。技术细节并非不重要,边界要服务变化隔离,而非假定数据库永远不影响任何业务设计。

业务与技术分治保存独立卡片。

原书依据 · 1 处

7.5 DDD的核心概念

本组小节介绍实体、聚合根、领域服务、领域事件和边界上下文,分别回答业务对象、规则边界、跨对象行为、已发生事实和模型适用范围的问题。

7.5.1 领域实体

寻找领域对象可以从用例里的名词出发,再辨别哪些是主体、属性、活动或组合概念。求职故事中的求职者、工作机会可能成实体,电话可能只是属性,中介则可拆为公司与员工。名词只提供候选,新增故事会继续改变模型。

用例名词提供对象候选

从用例中寻找名词能得到对象候选,再按业务责任辨别实体、属性和其他概念。求职故事里,求职者和工作机会可成为实体,电话可能是属性,中介还可拆成公司与员工。名称不是最终设计,新增场景可能补充或改变对象;不能把每个名词直接变成类或表。

用例名词提供对象候选保存独立卡片。

原书依据 · 1 处

7.5.2 聚合根

聚合把需要共同维护规则的对象纳入边界,由根作为外部访问入口。外部不直接拿内部对象绕过根,修改时须维护边界内不变式;内部标识与跨聚合引用也要以各自范围解释。银行图将Account与Transaction画成两个聚合,不代表跨聚合转账已自动原子。

聚合根守边界

聚合把需共同维护不变式的一组对象纳入封装边界,由根承担对外入口和规则检查。外部通过根访问,避免持有内部对象直接绕过约束;内部对象的标识可只在聚合内有意义。边界由规则和生命周期需求决定,不能仅因为对象有关联就全放入同一聚合;跨聚合也不自动获得同一事务。

聚合根守边界保存独立卡片。

原书依据 · 1 处

7.5.3 领域服务

领域服务承接重要但不自然属于单个实体或值对象的业务行为。跨两个账户的转账可由无状态服务协调账户行为,而不是让一个账户长期知道所有可能的对方账户;无状态指不依赖服务实例保存某笔业务的可变状态。

领域服务承接跨对象行为

领域服务表达重要的业务操作,但该操作不自然属于单个实体或值对象。例如转账跨两个账户,可由服务协调各账户的业务行为。它通常按活动命名并保持业务无状态,不把某次交易的进度存进共享服务实例;也不等于所有逻辑都应回到Service。

领域服务承接跨对象行为保存独立卡片。

原书依据 · 1 处

7.5.4 领域事件

领域事件表达已经发生、并值得其他部分知道的业务事实,名称应体现结果而非命令意图。事件内容可选择携带足够数据让消费者直接处理,或只带标识让消费者回查;两种方式在数据体量、依赖和语义上各有成本,消息也不自动保证可靠。

领域事件解耦

领域事件表达已经发生的业务事实,供其他模块或系统响应。名称应让人看出发生了什么结果,例如转账成功与失败分别表达。事件解耦了触发方和消费者的处理职责,但可靠发布、重复消费和失败恢复仍需机制支持,不能只靠“发消息”保证正确性。

领域事件解耦保存独立卡片。

原书依据 · 1 处
事件携带与回查取舍

事件载荷可携带处理所需信息,让消费者少回查,也可只带标识,由消费者另取详情。前者增加消息体和数据契约,后者增加调用依赖、负载及查询时点差异。应先确定消费者需要事件发生时的事实,还是查询时的当前状态,再选择载荷范围。

事件携带与回查取舍保存独立卡片。

原书依据 · 1 处

7.5.5 边界上下文

边界上下文限定一套模型含义生效的范围,内部保持一致,边界之外允许另有模型。ICBU会员与CRM客户可共享部分属性却承担不同职责,防腐层负责把外部表达转成内部业务概念,减少外部变化直接渗入。它能隔离部分影响,不能保证外部任何变化都无影响。

上下文限定模型含义

边界上下文限定术语和模型的适用范围,同一词在不同业务范围内可有不同含义。网站会员与CRM客户可能字段相似却职责不同,因此不必强用同一个对象。先在边界内保持逻辑一致,再显式定义跨边界的转换,避免把同名误当成同一概念。

上下文限定模型含义保存独立卡片。

原书依据 · 1 处
防腐层转换外部语义

防腐层把外部上下文的模型和接口转换为内部需要的表达。CRM客户与网站会员即使属性相似,也可通过转换层保持各自责任,减少外部改动直接侵入。转换层仍需随接口契约变化维护,不是保证外部变化永远不影响内部;是否两侧都建立转换应按边界需要决定。

防腐层转换外部语义保存独立卡片。

原书依据 · 1 处

7.6 领域建模方法

后续把领域建模落实为用例分析、四色模型与其他协作方法,先收集候选概念,再组织其关系和职责。

7.6.1 用例分析法

用例分析从具体场景出发:先读需求描述,提取名词候选,再判断需要记住的联系,区分对象和属性,最后按需要精化层次与边界。动词不自动成为关联,关联也不等于数据流或调用。供应商示例逐步把基本工资、佣金、订单号收为属性,示范候选如何经分析收束。

用例分析逐步收束模型

用例建模先获取场景描述,提取名词候选,添加需要记住的语义关联,再区分属性,最后按需要补泛化、组合和子域。名词和动词只提供线索:候选可能是同义词、属性或无用词,关联不等于调用或数据流。每一步都应回到用例含义,而非机械把语言成分翻译成表。

结构图:

flowchart TD
 A[获取用例] --> B[提取候选概念]
 B --> C[判断必要关联]
 C --> D[区分属性和概念]
 D --> E[按需要精化模型]

用例分析逐步收束模型保存独立卡片。

原书依据 · 1 处
概念与属性按用途区分

辨别概念和属性可先看它是否只是某对象的描述值、是否具有独立关系与职责。基本数据类型能充分表达、只依附一个对象且无其他性质的候选,常可作为属性。这是初步启发,不是硬规则;相同文本或数字在不同业务里也可能值得独立建模。

概念与属性按用途区分保存独立卡片。

原书依据 · 1 处

7.6.2 四色建模法

四色模型从需要追溯的业务时刻出发,区分事件或时间段、承担职责的角色、客观存在的人事物、以及用于描述分类的信息。书店核查少书和计价争议时,需要把订单、支付与配送记录连接起来,才能重建有限范围内发生了什么。建模顺序因此是先说明运营问题,再找关键时刻与足迹,补周边对象、角色和描述;没有记录就不能凭模型还原事实。

关键时刻记录业务发生

四色模型中的Moment-Interval表达某个时刻或一段时间内发生的业务,如下单、询价或租赁。本书译为业务关键时刻,常以粉红色表示,并通过标识和时间记录发生经过。它强调事件的可追溯表达,不是把所有带时间字段的对象都当成同一类业务活动。

关键时刻记录业务发生保存独立卡片。

原书依据 · 1 处
角色区别承担者

角色表达某个参与者在具体活动中承担的责任和权利,四色模型通常以黄色表示。同一个人或物在不同活动里可承担不同角色,因此应区分“谁在场”与“以什么身份参与”。是否独立建角色对象,要看这种差异是否服务实际业务问题。

角色区别承担者保存独立卡片。

原书依据 · 1 处
人事物表达客观参与者

四色模型用人、组织、地点或物等类别表达活动中的客观参与者,通常标绿色。它们可以在不同业务时刻承担不同角色,从而把参与者自身特征与活动中的职责分开。模型是按目的分类,不能只靠名词的日常含义机械上色。

人事物表达客观参与者保存独立卡片。

原书依据 · 1 处
描述对象集中共性信息

四色模型中的描述对象承载分类或描述性信息,通常用蓝色表示,用来组织一类事物共有的性质。它与具体参与对象、活动和角色分开,可减少概念混杂;是否值得独立建对象仍应看信息共享及维护需求,而非为凑齐四种颜色。

描述对象集中共性信息保存独立卡片。

原书依据 · 1 处
业务足迹支撑追溯

业务追溯需要把关键动作及其结果记录并连接。书店面对少书或计价争议,可对照订单、支付记录和快递存根,检查订了什么、付了多少、送了什么。记录提供事实线索,但能还原到何种程度取决于完整性与关联质量;业务事件不一定天然留下足够足迹。

业务足迹支撑追溯保存独立卡片。

原书依据 · 1 处
四色建模从追溯目标开始

四色建模先确定管理与运营要追溯的问题,再寻找关键业务时刻及记录,补充周围的人事物、角色和描述。顺序的意义是让对象服务业务目标,而非先画一套颜色齐全的图。模型应能回答原始问题,必要时继续调整。

结构图:

flowchart TD
 A[确定运营追溯目标] --> B[识别事件与业务记录]
 B --> C[补人事物]
 C --> D[辨认参与角色]
 D --> E[补分类描述]
 E --> F[检查能否回答原问题]

四色建模从追溯目标开始保存独立卡片。

原书依据 · 1 处

7.7 模型演化

模型演化需要重新寻找能包容多种观察的抽象,同时排除错误类比带来的性质。象鼻例子保留活动和喷水特点,舍去毒牙或消防车存放等误导关系;不是把两张旧模型直接拼在一起。

模型演化筛选共同解释

合并不同模型时,应寻找能够解释共同事实的新抽象,同时排除旧类比附带的错误性质。象鼻类比可保留活动与喷水等观察,却不能继承蛇的毒牙或水管的存放方式。模型演化依靠新证据和业务理解,不是简单叠加原有名称与结构。

模型演化筛选共同解释保存独立卡片。

原书依据 · 1 处

7.8 为什么DDD饱受争议

DDD实施失败在这里指没有达到控制复杂度的目标,而不只是功能做不出来。后文从概念照搬、抽象分歧和层次边界三个方面分析风险;个人见闻不能直接代表所有团队的失败概率。

7.8.1 照搬概念

加入Repository、Domain和ValueObject等名字,并不自动改变职责划分。模型要真正表达业务概念与规则,否则只是给旧层次换标签;也不必为了“像DDD”强迫所有问题套用相同对象清单。

DDD别照搬

DDD的价值在于业务语言、职责和边界真实进入设计,而不是项目里出现Repository、Domain和ValueObject等名字。若规则仍散乱,只换目录和类名不会控制复杂度。是否采用某个构造应能解释它解决的具体问题,不能按概念清单机械凑齐。

DDD别照搬保存独立卡片。

原书依据 · 1 处

7.8.2 抽象的灵活性

领域模型受视角、业务知识和预期变化影响,多个方案都可能工作。团队需要有经验的人帮助比较表达、扩展和维护代价,也应让判断依据可讨论;不能因为经验重要就把某个资历的人意见当作最终证据。

模型分歧比较上下文

不同业务理解和变化预期可能产生多个可工作的模型,不能只按图形形式判断唯一正确。团队应借助业务经验,比较模型对当前规则的表达、变化代价和可理解性,并记录选择依据。经验支持判断,不代替验证;不合理抽象也可能比直接实现更复杂。

模型分歧比较上下文保存独立卡片。

原书依据 · 1 处

7.8.3 领域层的边界

领域层若直接依赖技术实现,业务规则就会随基础设施变化。书中记录COLA从1.0到2.0的调整:可让基础设施适配领域契约,也可把实体获取与组装的协调上移到应用层。两者作用点不同,应以责任归属说明,而非只讨论Repository放在哪个文件夹。

领域边界按责任隔离

领域规则需要外部数据和能力时,可定义契约让基础设施反向适配,也可由应用层先获取并组装领域对象,再调用规则。两种方式分别隔离依赖方向与协调责任。Repository位置取决于契约归属及谁承担组装,不能仅凭目录名称推断业务已与技术解耦。

领域边界按责任隔离保存独立卡片。

原书依据 · 1 处

7.9 本章小结

DDD章把共享语言、规则承载、边界封装和演化连接起来。建模方法帮助从用例或追溯目标得到概念,但最终仍要根据业务语义、变化成本和实现责任检查结果;照搬术语可能增加复杂度。

第二部分 思想

第二部分转向支撑设计的思考方法,后续依次处理抽象、分治、工作方式与技术领导。

第8章 抽象

抽象按目的保留共同特征,又通过层次让人选择合适信息尺度。重复代码可暴露缺失概念,类型判断可提示公共能力不足,金字塔则把材料归类成可解释结构。抽象过高也会丢掉有效约束。阅读、总结和领域建模可作为练习入口,但不能从个人经验推导确定的能力增长规律。

8.1 伟大的抽象

从具体对象到共同类别,使人能用一个概念谈论许多实例。树、植物等层次是概念泛化的例子;这说明分类语言的用途,不能用叙事直接证明人类认知演化的精确历史。

8.2 到底什么是抽象

抽象为某个目的过滤信息,只保留相关特征。皮质足球可忽略材质成为球,单个苹果也可归入苹果类别;不同目的保留的内容不同,不存在越抽象就无条件越接近唯一“本质”。

抽象过滤细节

抽象按目的过滤具体事物的信息,保留当前任务相关的特征,隐藏无关差异。把不同苹果归为苹果,就是忽略各自大小、颜色等差别来谈共同类别。抽象的有效性取决于目的;若要判断成熟度,先前忽略的颜色也可能重新重要。

抽象过滤细节保存独立卡片。

原书依据 · 1 处

8.3 抽象是OO的基础

对象分析先从问题域识别关键概念,设计再确定对象与协作,编程则落实为代码。Apple到Fruit示例说明范围扩大时需要不同层次的共同表达;不是只要使用类语法便完成了对象分析。

对象分析设计实现相连

OOA从问题域识别关键对象和责任,OOD安排对象及其协作结构,OOP用语言实现这些安排。三者都需要抽象,但关注阶段不同。使用类语法不代表模型已贴合业务;问题范围变化时,还应检查原有概念是否仍能覆盖,例如Apple不足以表达多种水果。

对象分析设计实现相连保存独立卡片。

原书依据 · 1 处

8.4 抽象的层次性

较高层抽象保留更少限定,能涵盖更广范围;较低层则提供更具体的信息。报纸例子说明任务应选择足够但不过细的层次:查某日新闻不必绑定到“我拥有”的那份实物。软件分层也通过约定接口屏蔽部分细节,但增加中间层并非总能解决问题。

抽象层次匹配

高层抽象通常减少限定、扩大适用范围,低层抽象保留更多细节。选择哪层取决于任务:查某日新闻需要指定报纸与日期,却未必关心哪份实物属于谁。软件接口也应暴露本层需要的信息,既不能过泛到没有约束,也不能泄漏所有底层细节。

抽象层次匹配保存独立卡片。

原书依据 · 1 处

8.5 如何进行抽象

后续从寻找共性、提升抽象层次和结构化归纳三个角度练习抽象。

8.5.1 寻找共性

重复搜索代码暴露出搜索条件和组装过程两个缺失概念。把条件表示为SearchCondition、把公共组装放入SearchConditionAssembler后,可让相同规则集中维护;抽象成立仍要核对输入和所有差异是否被保留。

共性产生抽象

抽象可从重复中寻找共同规则,再为这组共性命名。重复搜索逻辑可分别抽出搜索条件与组装职责,使调用者不必反复处理模板细节。应比较所有使用场景的真实差异;名称相似或代码形似不足以证明同一抽象,简写也不能证明行为等价。

共性产生抽象保存独立卡片。

原书依据 · 1 处

8.5.2 提升抽象层次

当调用者只关心水果是否可口,而具体水果用不同指标判断时,可以把共同问题提升为Fruit.isTasty。这样选择器依赖统一契约,各类保留自己的判断。抽象层次也不能无限提高到什么都能包含的“物质”,否则失去表达实际关系的能力。

提升到共同业务能力

若调用者为了同一业务目的不断识别具体子类,可检查是否存在共同能力。水果选择器关心“可口”,可依赖Fruit.isTasty,让苹果和西瓜分别使用自身规则。原文未给出调整后的两个覆盖实现,不能把新基类声明当成完整可运行重构;语义一致仍需由实现满足。

结构图:

classDiagram
class Fruit {
  <<abstract>>
  +isTasty() boolean
}
class FruitPicker {
  +pickGood(List~Fruit~ fruits) List~Fruit~
  -check(Fruit e) boolean
}
FruitPicker ..> Fruit : 调用统一能力

虚线为使用依赖;未展示的Apple和Watermelon覆盖方法不补造成原文代码。

提升到共同业务能力保存独立卡片。

原书依据 · 1 处

8.5.3 构筑金字塔

金字塔先从材料向上归类概括,再从结论向下表达依据。购物清单按水果、蔬菜、奶蛋等类别组织,可让上层组名提示细项;作用来自有含义的分组,而不是把九个词任意分成三堆。

金字塔表达

金字塔结构先把具体材料按逻辑归类并概括,再在表达时先给结论、后展开依据。上层概念应能提示下层内容,购物清单按有意义类别组织,比任意分堆更容易检查和回忆。结构能帮助理解,不保证论据真实或结论充分,归类关系仍需核对。

金字塔表达保存独立卡片。

原书依据 · 1 处

8.6 如何提升抽象思维

抽象可作为持续练习的能力,后续提出阅读、总结和领域建模三种练习入口。对儿童躲猫猫的解释不足以支持抽象能力的发育结论,本笔记不据此进行心理评估。

8.6.1 多阅读

阅读文字需要把语言与概念联系,可把它作为抽象练习的输入来源。但本节对屏幕活动、学业分化和职业教育的因果归因没有给出证据,不能据此评价孩子或不同教育路径。

阅读作为概念练习输入

文字阅读可用作抽象练习的材料:读者需要把描述联系为概念,而非只接收现成画面。若要观察是否理解,可再用自己的话组织要点,这是对书中建议的实践延伸;不能据此断言阅读总优于图像,或把学习与职业选择简单归因于抽象能力。

阅读作为概念练习输入保存独立卡片。

原书依据 · 1 处

8.6.2 多总结

写总结要求把材料重新组织成自己的解释,从而暴露是否抓住关键概念。读书笔记若只是复制句子,很难显示理解;可以先归纳再以原文核对,保持自己的表达与证据相连。

总结要求重新组织理解

总结应把材料压缩为自己能解释的概念及关系,而非复制原句。写段落大意、博文或读书笔记,都可作为归纳练习。自己的话也可能误解,因此仍要回到来源核对关键限定;记录完成不等于已经掌握。

总结要求重新组织理解保存独立卡片。

原书依据 · 1 处

8.6.3 领域建模训练

领域建模把问题分析、概念抽取、边界划分和关系组织放在同一次练习中。通过反复模型化并回看业务场景,可练习抽象选择;作者自述熟练感增强是经验,不代表练习次数可保证同样提升。

建模练习抽象选择

领域建模可作为抽象练习:分析场景、筛选概念、组织关系并划分边界,再检查模型能否解释原问题。反复比较不同方案有助于发现自己遗漏的特征,但仅画更多图不保证进步;练习需要与实际规则和反馈相连。

建模练习抽象选择保存独立卡片。

原书依据 · 1 处

8.7 本章小结

抽象按目的筛选信息,以分类、命名和层次组织共同概念。寻找共性、提升到合适契约、用金字塔组织表达相互补充;阅读、总结和建模是可尝试的练习入口,效果仍需实际任务反馈。

第9章 分治

分治让人一次专注于较小部分。算法需说明分解、终止和合并;函数按职责与抽象层次拆分;架构与数据再按层次、业务和路由分开。每次拆分都引入协作成本,不能只看局部变小。两次创造把实现和结构整理放在同一开发循环内,避免长期累积只可运行却难理解的半成品。

分治降低脑负载

分治把大问题组织为职责较清楚的部分,让人在一次分析中集中处理其中一块,降低同时考虑的复杂度。收益依赖边界和协作规则;若拆分制造大量跨块依赖,只是把内部复杂度转为协调复杂度。分解后仍要检查整体能否满足原问题。

分治降低脑负载保存独立卡片。

原书依据 · 1 处

9.1 分治算法

算法分治把原问题分解为规模更小的同类问题,直到足够简单可直接求解,再按需要合并结果。关键是子问题可求解、分解会终止、合并能保持原问题要求;仅拆成多个函数并不自动构成分治算法。

算法分治递归求解

分治算法先把问题分成更小的同类问题,缩小到可直接解决的情况,再逐层合并结果。设计时要说明规模怎样缩小、何时停止以及怎样合并,不能只写递归而没有终止条件。并非每种算法都需要显式合并,具体步骤仍由问题结构决定。

算法分治递归求解保存独立卡片。

原书依据 · 1 处

9.1.1 归并排序

归并排序把序列拆成两个较短序列,分别排序后再合并。一次合并需要线性工作,每层的总元素量约为N,层数约log N,因此在该二分模型下得到N log N量级的时间。这是算法分析,不是本轮实测性能。

归并排序分解与合并

归并排序递归地把序列拆成两部分,子序列有序后再逐层合并。若每次近似对半,递推式为T(N)=2T(N/2)+O(N):每层合并工作总量约N,共约log₂N层,因此时间为O(N log N)。图中38、27、43等数只是教学输入,未实际执行排序。

结构图:

flowchart TD
 A[拆分原序列] --> B[左半递归排序]
 A --> C[右半递归排序]
 B --> D[合并两个有序序列]
 C --> D
 D --> E[得到当前序列的有序结果]

归并排序分解与合并保存独立卡片。

原书依据 · 1 处

9.1.2 二分搜索

二分查找利用有序性比较中点,只保留可能包含目标的一半区间。每轮必须排除已比较的中点,并在区间为空时返回未找到。原递归代码没有left>right的结束分支,因此找不到目标时可能继续递归或越界,不能把例子只找到1的展示当作完整正确性。

二分查找需要空区间终止

有序数组查找中,比较目标与中点后,可排除不可能的一半,并在相等时返回位置。递归前还要处理left>right的空区间,表示未找到;原代码遗漏此分支,不能处理所有缺失目标。区间更新应排除中点,计算中点还需考虑索引加法的表示范围。

二分查找需要空区间终止保存独立卡片。

原书依据 · 1 处

9.1.3 K选择问题

第K小选择先按枢轴划分大小,再根据较小分区的元素个数判断目标在哪一侧,只递归目标那一侧。原书先把S(1)定义为较大组,后续却用它当较小组计算名次,分区标签与比较不一致;笔记按小于枢轴的组重新说明。近似均分时线性时间成立,极端偏斜时并非保证线性。

第K小依较小分区定位

求第K小元素时,设L为小于枢轴的元素数,先考虑元素互异且K从1计数:K≤L时去较小组,K=L+1时返回枢轴,否则去较大组找第K-L-1小。划分标签必须与大小方向一致;重复值还需单独处理等于枢轴的一组,不能直接套互异元素公式。

第K小依较小分区定位保存独立卡片。

原书依据 · 1 处
选择线性时间有划分前提

选择算法只递归目标所在分区。若每次近似对半,划分工作依次约N、N/2、N/4,几何和为O(N);若每次只排除一个元素,工作和可变成N+(N-1)+…,达到O(N²)。因此本书的线性分析依赖理想划分,不能作为任意枢轴策略的最坏情况保证。

选择线性时间有划分前提保存独立卡片。

原书依据 · 1 处

9.2 函数分解

函数分解把职责和抽象层次重新组织,使阅读者能逐层理解。长短只是发现问题的线索,不能构成单一职责的充分必要证明;短函数也可能把不相干行为混在一起。

短函数以职责衡量关联本项背景,实质主要讲解在对应位置。

原书依据 · 2 处

9.3 写代码的两次创造

两次创造把行为实现与表达改进分成两个注意阶段:先建立可工作的逻辑,再检查职责、名称和组织方式。这是编码内部的循环,不是让未验证的粗糙版本直接交付后再期待未来修复。

代码两次创造

编码可先聚焦实现行为,再聚焦命名、职责、函数层次与重复等表达问题。两次创造是开发中的注意分工,不要求第一遍故意写差,也不允许把安全与正确性拖到第二遍才考虑。应在交付前完成必要的结构整理与行为验证。

代码两次创造保存独立卡片。

原书依据 · 3 处

9.3.1 第一遍实现功能

第一遍先把输入、处理和结果的逻辑串起来,允许暂时不完美的组织,以便确认自己在解决正确问题。暂时的粗糙必须进入后续整理范围;这不是随意命名和制造重复的强制要求。

代码两次创造关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

9.3.2 第二遍重构优化

第二遍逐项检查命名、职责、长度、扩展点和抽象,保持行为的同时改善理解与维护成本。把整理作为编码的一部分,可避免长期积累半成品;系统一系统二在此只是解释为什么认真检查费力,不能把快慢思考简单等同于感性与理性。

代码两次创造关联本项背景,实质主要讲解在对应位置。

原书依据 · 3 处

9.4 分治模式

机器人按页面、场景、类目和租户逐级寻找应答,前面命中即可返回,最后租户规则兜底。职责链把各自判断放到不同处理器,减少单组件堆叠;整体行为仍依赖明确的顺序与命中条件。

职责链按优先级兜底

当多个规则有明确优先级时,可让请求依次经过职责链。机器人示例先按页面、场景、类目判断,均未命中才使用租户规则兜底。每个处理器承担自己的匹配职责,链定义组合顺序;改变顺序会改变结果,不能把链当成可任意交换的集合。

结构图:

flowchart TD
 A[页面规则] -->|未命中| B[场景规则]
 B -->|未命中| C[类目规则]
 C -->|未命中| D[租户兜底]
 A -->|命中| E[返回应答]
 B -->|命中| E
 C -->|命中| E
 D --> E

职责链按优先级兜底保存独立卡片。

原书依据 · 1 处

9.5 分层设计

分层通过给不同关注点安排边界,让每层能够聚焦相对简单的责任。是否只允许访问相邻层、允许越过哪些层,需要在架构规则里明确,不能从“分层”名称自动推出。

9.5.1 分层网络模型

OSI七层与TCP/IP四层提供不同通信组织视角,图中按职责作近似对应。分层能够隔离关注点,也增加接口和转交成本,因此应选有实际价值的层次;不能仅从层数断言某模型一定低效。

分层只取必要

分层把不同关注点放进明确边界,让读者与实现者逐层处理问题。但每层也增加接口、转发与维护成本,应能说明它隔离了什么变化。七层和四层网络模型提供不同组织视角,不意味着层越多越先进,也不能只用层数推断实际协议效率。

分层只取必要保存独立卡片。

原书依据 · 1 处

9.5.2 分层架构

严格分层只依赖相邻下层,开放分层允许按约定跨过某些层。对无需领域行为的查询,应用层可直接使用数据访问能力,减少纯转发;涉及业务不变式的修改仍要经过规则边界。层是否可跳过应是明确政策,而非任意跨层。

开放分层明确可跳过层

开放分层允许按约定跳过某些中间层,避免没有增值的纯转发。例如无需领域行为的查询可从应用层直接访问数据能力。应明确哪些层可跳过以及哪些规则必须保留;读取捷径不能自动推广到绕过业务校验的修改路径。

开放分层明确可跳过层保存独立卡片。

原书依据 · 1 处

9.6 横切和竖切

垂直拆分按业务职责把数据分到不同库,水平拆分则把同类数据按路由规则分片。商品、会员、交易是垂直例子,userId取模是水平例子;后者会影响关联查询和扩容迁移,因此不能以理论分片数推出无限扩展保证。

横竖切分扩展

垂直拆分按领域或职责把不同数据分开,如商品、会员、交易;水平拆分则按路由键把同类记录分到多个分片。前者隔离业务范围,后者分摊同类数据规模。拆分会引入跨分片协作和路由成本,并非只增加库数就能无限扩展。

横竖切分扩展保存独立卡片。

原书依据 · 1 处

取模分片绑定路由规则

把用户交易按userId对10取模,可把同一用户的数据路由到固定分片。需要统一取模结果与物理分片的映射,查询也要知道路由键。分片数变化可能使同一键映射到不同位置,因此扩容不能只改除数而忽略已有数据;这是对该公式的直接推导。

取模分片绑定路由规则保存独立卡片。

原书依据 · 1 处

9.7 本章小结

分治的共同点是按可理解边界组织部分,再以明确协作回到整体。算法关心子问题与合并,代码关心职责与层次,系统拆分还要处理路由和跨边界成本。

第10章 技术人的素养

技术素养是持续判断与改进工作的习惯。方法选择要看上下文,批判性思维检查概念与证据,结构化表达组织关系,工具化减少无价值重复,目标与笔记帮助学习形成路径。心态建议属于个人价值与经验,不是心理诊断,也不应把人的成败简单归因于一种思维标签。

10.1 不教条

不教条要求先理解规则为何存在,再判断它能否改善当前问题。把小应用拆成几十个服务可能让协调成本大于收益,微服务名称本身不代表进步;方案选择应回到可理解、可维护和可扩展的实际结果。

不教条看上下文

技术方法应按当前问题、团队和变化需求选择,而非为采用流行名称照搬结构。小应用拆成很多服务可能增加协调成本,分层或模式也可能过度。先理解规则希望解决什么,再比较实际收益与代价;不教条不是任意违反契约,而是给出有根据的取舍。

不教条看上下文保存独立卡片。

原书依据 · 1 处

10.1.1 瀑布还是敏捷

开发过程不必在纯瀑布和纯敏捷之间二选一。需求、设计、实现、测试与部署都需要完成,只是在不同迭代阶段投入比例不同。敏捷不等于跳过基础设计,计划详尽或每天站会也都不单独保证交付成功。

迭代过程调节工作重心

需求、设计、实现、测试和部署在迭代中可交错推进,不同阶段分配不同重心。先建立必要的系统边界与共同机制,再依据反馈逐步完善;敏捷不等于无设计,详尽前期计划也不保证成功。应按不确定性和变更成本选择节奏,避免只执行仪式。

迭代过程调节工作重心保存独立卡片。

原书依据 · 1 处

10.1.2 贫血还是充血

贫血模型主要承载数据,行为由外部组织;充血模型让数据和相关行为在同一对象里表达。选择应看责任是否清晰、规则是否易维护,不能只按是否有方法评判复杂度或对象设计质量。

数据行为组织看职责

贫血模型主要保存数据并提供访问,相关行为由服务等结构组织;充血模型把数据与业务行为放在一起。二者是组织选择,不是质量等级。应检查规则是否集中、责任是否明确以及变化是否容易处理;仅给对象加方法不自动形成好模型。

数据行为组织看职责保存独立卡片。

原书依据 · 1 处

10.1.3 单体还是分布式

单体、分布式与能力中台应按规模、协作和复用问题选择。业务聚合不等于物理上只有一个进程,中台集中管理共享能力,也可能以分布式方式部署;不能把它简单称为所有团队都该迁移的超级单体。

架构形态按问题演进

业务早期可用单体保持交付简单,规模和协作需求变化后再评估拆分。中台集中共享能力以减少重复建设,逻辑聚合与物理部署可以分别选择。单体、分布式或中台都不是必经阶段;应比较复用、边界、运行和协调成本。

架构形态按问题演进保存独立卡片。

原书依据 · 1 处

10.2 批判性思维

批判性思维要求检查断言的概念、依据和推理,而不是只求辩论取胜。对话中同一个词从气概换成生理意义,会造成偷换概念;发现词义变化后应重新对齐问题,再判断论证是否相关。

批判性防误判

批判性思维检查概念、证据和推理是否支持结论,既不全盘接受,也不为反驳而反驳。若同一个词在论证中换了含义,就可能形成偷换概念;应先对齐定义,再判断理由是否回答了原问题。目的在提高判断质量,而不是保证争论获胜。

批判性防误判保存独立卡片。

原书依据 · 1 处

10.3 成长型思维

成长型思维把能力视为可以通过学习发展,遇到挫折时更愿意尝试改进;固定型视角则容易把一次表现解释为能力定论。这是观察学习行为的框架,不是把人永久分成两类,也不能由一个态度保证所有领域成功。

成长型抗挫

成长型思维把能力看作可学习与发展的,面对挫折时关注策略、练习与反馈,而不是把一次失败当成永久能力判决。它提供一种应对方式,不保证努力就能达成任何目标,也不应把人固定贴成某种思维类型。个人经历能启发尝试,效果仍需看具体条件。

成长型抗挫保存独立卡片。

原书依据 · 1 处

10.4 结构化思维

结构化思维把信息按明确逻辑关系组织,再用适合的分析框架检查。演绎、时间、空间和重要性是常见顺序,MECE帮助检查分类重叠与遗漏,5W2H提供问题维度;清单帮助展开思考,不能代替证据或证明所有逻辑只限四种。

结构化表达

结构化思维既要有清楚的组织关系,也可借分析框架检查遗漏。可按推理、步骤、组成或重要性安排材料,再以问题维度补充信息。编号整齐不等于论证有效,时间先后也不自动构成因果;每组材料应能说明彼此为何关联。

结构化表达保存独立卡片。

原书依据 · 1 处

MECE检查分类重叠遗漏

MECE要求在当前分类目的下,各部分尽量不重叠并共同覆盖范围。它适合检查拆解是否重复或漏项,但前提是边界与分类维度已经说清;真实问题可能跨维度关联,不能为形式整齐强行抹去联系。

MECE检查分类重叠遗漏保存独立卡片。

原书依据 · 1 处

5W2H展开问题维度

5W2H用原因、参与者、时间、地点、对象、方法与数量成本等维度展开问题,帮助从单点描述走向较全面的分析。它是一组提示,不要求每个问题都机械填满,也不保证已发现根因;每项回答仍要有信息与依据。

5W2H展开问题维度保存独立卡片。

原书依据 · 1 处

10.4.1 如何落地新团队

进入新团队可并行建立业务、技术和人员三张认知图。体验产品与流程、围绕核心用例读架构和代码、了解组织职责并沟通,能逐步把“谁负责什么”与“系统怎样完成任务”连起来。

新团队按三面建立认识

进入新团队可从业务、技术与人三个面展开:体验产品并理解流程,围绕核心用例阅读架构和代码,再了解组织职责与协作岗位。用具体流程把三者连接起来,比只浏览目录更能形成整体认识。访问账号、客户或代码仍应按实际授权范围获取。

新团队按三面建立认识保存独立卡片。

原书依据 · 1 处

10.4.2 如何做晋升述职

述职表达可围绕问题、分析、行动、结果和未来来组织,而不是堆叠工作流水。镜头式表达先交代背景与价值,再进入选择和实施细节,最后回到整体结果,使听者能判断工作的意义。

述职从问题走到结果

工作汇报可先提出并界定问题,再讲分析、行动与结果,最后说明未来方向。材料应让听者看出要解决什么、为何采用该办法以及产生何种价值,而非只展示做了多少页工作。框架帮助表达,实际结果仍需可核查证据。

述职从问题走到结果保存独立卡片。

原书依据 · 1 处
表达先拉近再拉远

复杂工作可按背景—细节—整体价值表达:先说明场景与重要性,再讲具体选择和实现,最后回到结果、客户价值与未来思考。视角变化为听者提供理解坐标;细节多少应依读者所需,而不是每次都完整复述技术过程。

表达先拉近再拉远保存独立卡片。

原书依据 · 1 处

10.5 工具化思维

工具化思维把反复发生的操作转成可维护的工具、脚本或配置,节省后续重复劳动。出现多次重复时可停下来估算是否值得自动化,收益还要扣除创建、维护和失败处理成本。忙碌不能直接说明个人能力低,工具也不是一劳永逸。

工具化思维

同类工作反复出现时,可评估用脚本、配置或工具自动完成。先观察重复步骤、输入与例外,再比较节约时间和创建维护成本。工具化旨在减少无价值重复,不是为每项小事开发平台;自动化仍需处理失败和后续变化,不能承诺一劳永逸。

工具化思维保存独立卡片。

原书依据 · 1 处

10.6 好奇心

好奇心可从对术语、机制和异常的疑问开始,把疑问转成资料搜集和深入检查。本节以整理缩写的经历说明小问题也能带来可共享成果;浏览量和点赞不是知识正确性或学习能力的证明。

好奇心把疑问转成学习

对一个缩写、机制或现象感到不明白时,可把疑问具体化,再查找和整理答案,让好奇心形成学习行动。公开整理也可能帮助他人,但热度不能证明内容正确。持续学习还需要目标与验证,不能仅靠不断追逐新名词。

好奇心把疑问转成学习保存独立卡片。

原书依据 · 1 处

10.7 记笔记

笔记通过归纳、关联和检索支持后续学习。把消化后的解释记录下来,按逻辑重组、以标签处理跨组内容,保留来源链接,再按篇幅突出重点或加目录。记录不是绝对不丢失的外部记忆,本节提及敏感密码只属个人经历,不是普通云笔记的存储建议。

笔记促进内化

笔记把材料转成自己的解释,再通过归类、关联和回顾形成可检索的知识结构。不要只复制粘贴;引用应保留来源,长内容用目录组织,跨分类内容可用标签。记录提供回顾线索,但不保证已经掌握或永不丢失,应继续检查理解和来源。

笔记促进内化保存独立卡片。

原书依据 · 1 处

笔记组织服务回顾

笔记工具应支持检索和必要的层次组织,内容则需定期回顾并按逻辑重组。树状目录提供主结构,标签可承接跨组内容,重点标记和目录改善长笔记阅读。组织方式要服务实际找回与理解,不必为了分类完美反复搬动所有记录。

笔记组织服务回顾保存独立卡片。

原书依据 · 1 处

10.8 有目标

目标先说明要解决什么问题,再指导资料选择和行动。想弄清Redis持久化与想了解整个集群架构,所需材料与深度不同;碎片化内容可以提供线索,但不能代替围绕具体问题形成的理解。

目标驱动学习

学习前先说明想弄清的问题,再决定资料、范围和理解深度。例如持久化、主从同步与集群架构是不同目标,不能只按推送顺序不断收集文章。目标应能引导后续解释或应用;完成阅读清单不等于问题已解决,也不表示所有碎片阅读都无价值。

目标驱动学习保存独立卡片。

原书依据 · 1 处

10.9 选择的自由

刺激与回应之间的选择框架,提醒人在条件允许时觉察情绪、价值和可用行动,再决定怎样回应。承担责任不是否认环境限制,也不是把他人造成的伤害归咎于受影响者;本节价值倡议不当成人人随时完全自由的心理定律。

觉察后选择回应

在可以选择的范围内,先觉察外界刺激和自己的反应,再按价值与后果选择行动,可减少只随即时情绪回应。这个框架强调主动性,不表示外部限制不存在,也不要求人对无法控制的事情负责。责任应与实际能控制和能选择的范围相称。

觉察后选择回应保存独立卡片。

原书依据 · 1 处

10.10 平和的心态

平和心态在这里指认真行动,同时不过分追逐一时评价和得失。海浪比喻强调感受会变化,不必把每次波动都当成必须控制的对象;作者失眠和焦虑的经历只能作为个人叙事,不支持诊断或治疗结论。

行动积极而心态平和

认真做事与不过分追逐即时得失可以并存。把情绪看作会变化的体验,可提醒自己先观察,再决定行动,而非把每次评价都变成自我价值判决。这是生活态度建议,不代表所有痛苦都能靠放下得失解决,也不替代对持续困扰的专业理解。

行动积极而心态平和保存独立卡片。

原书依据 · 1 处

10.11 精进

精进强调持续的小步改进而不是一次完成所有提升。图中1.01与0.99的365次方展示乘法累积差异,是数学比喻;技术成长没有固定每日增长率,也不会只因坚持而必然成功。

精进以小步持续改善

精进把改进分成可持续的小步,反复学习、应用和调整,避免期待一次性完成跃迁。1.01与0.99连乘的图说明累积差异的数学效果,不是人的能力增长模型;实际学习会有停滞、遗忘和条件变化,持续投入还需配合方向与反馈。

精进以小步持续改善保存独立卡片。

原书依据 · 1 处

10.12 本章小结

技术素养章把方法判断、批判性思维、学习目标、笔记、工具与心态相连。各方法可以支持反思和行动,但作者个人经历不构成统一的成功路径;适用性仍需具体任务与反馈检查。

第11章 技术Leader的修养

技术负责人需要共同经营能力、方向和信任。代码讨论、分享和读书提供学习入口,目标与规划让建设事项对齐,推理阶梯提醒行动前核验事实。技术判断与人员协作互补,评论数量、总分或活动次数只能提供线索,不能取代对真实问题和人的理解。

11.1 技术氛围

技术氛围需要有人持续组织学习与质量讨论,使业务交付之外仍有改进技术的空间。负责人若只看业务指标,技术问题可能失去明确入口;下面列举可尝试的团队习惯。

技术味道要经营

团队的技术氛围可通过持续学习、代码讨论和质量维护来经营,让业务交付与能力成长都有空间。负责人应为问题提供时间、示范和反馈,而不是只要求成员“多学习”。是否有效要看团队能否把讨论转成可理解代码与改进行动,不靠活动数量证明氛围。

技术味道要经营保存独立卡片。

原书依据 · 1 处

11.1.1 代码好坏味道

轮值成员展示好坏代码片段,让团队讨论具体表达与设计选择。开放源码与内部例子都可成为材料,但重点是分享原因和改进方式,不能把公开点名当成质量机制。

代码实例形成共同判断

定期选择少量正反代码实例,围绕命名、职责和结构讨论为什么好、如何改善,可让团队逐步形成共同判断。轮值主持能分散准备责任。重点应落在代码和依据,避免把成员羞辱当作激励;片段数量只是书中活动形式,不是质量指标。

代码实例形成共同判断保存独立卡片。

原书依据 · 1 处

11.1.2 技术分享

准备技术分享要求阅读、理解和组织表达,听者可用较低重复成本获得共同背景。对暂未实际使用的技术也能讨论,但分享应区分原理理解和实际验证,不能把一次介绍当作全员具备实施能力。

技术分享降低重复学习

技术分享让准备者整理原理并解释给同事,其他成员通过提问与讨论建立共同背景,可减少每个人重复搜集资料的成本。分享应保留来源并说明已验证范围;了解概念不等于具备落地经验,也不应把新名词介绍误作技术选型依据。

技术分享降低重复学习保存独立卡片。

原书依据 · 1 处

11.1.3 CR周报

CR周报把审查中发现的问题与典型经验汇总,使团队看见质量趋势和后续动作。评论数量可反映参与线索,但不能单独证明审查质量;典型问题的依据和处理结果比排名更能帮助学习。

审查周报透明化问题

审查周报可汇总分支质量、典型问题和处理进展,让团队共享审查经验,并帮助负责人发现反复出现的风险。评论数可作参与线索,却不能直接等同贡献或质量;应关注评论是否有依据、问题是否得到处理。轮值汇总可让机制融入日常工作。

审查周报透明化问题保存独立卡片。

原书依据 · 1 处

11.1.4 读书会

团队读书可采用共读或分章后互相分享,书目不必只限技术。选择方式要看材料是否依赖连续论证,工具类书适合按模块拆分;频率应随工作负担调整,负责人可示范持续学习。

读书会按材料组织

团队读书会可共读同一本书,也可分配章节后互相分享。主题可兼顾技术与协作成长,频率根据实际工作调整;依赖连续论证的书不宜只拼接片段理解。负责人应示范学习,但阅读书目数量不应替代对能力和工作成果的判断。

读书会按材料组织保存独立卡片。

原书依据 · 1 处

11.2 目标管理

目标管理把共同方向转为可讨论的成果,并在执行中提供帮助和纠偏。负责人需要与成员共同确认目标及进展,避免只在绩效讨论时才发现双方预期不同。

11.2.1 什么是OKR

OKR把方向性的Objective和支持它的Key Results分开,使可衡量结果始终服务原目标。只追页面浏览量可能诱使设计者拆散页面、增加操作步骤,却损害用户体验;指标不能脱离想达成的价值来解释。

OKR对齐方向

OKR用目标O说明希望改变什么,用关键结果KR说明如何观察进展。KR应服务目标,不能把代理指标增长当成价值本身:拆散页面可能提升PV,却使用户更不满意。是否与绩效挂钩是管理选择;采用OKR名称也不自动避免短视。

OKR对齐方向保存独立卡片。

原书依据 · 1 处

11.2.2 SMART原则

SMART要求目标具体、可衡量、可达成、与方向相关并有期限。这些条件帮助判断结果是否可检查,仍需确认指标确实表达价值;摩尔定律例子只是书中类比,不能证明目标是否科学并不重要。

SMART检查目标可执行性

SMART检查目标是否具体、可衡量、可达成、与方向相关以及有明确期限。把“提高效率”进一步说明对象、衡量方式和时间,才便于讨论行动与结果。指标可测仍不等于有价值,达成性也应基于资源与假设判断,而非凭愿望定数。

SMART检查目标可执行性保存独立卡片。

原书依据 · 1 处

11.2.3 OKR设定

挑战性目标能提示需要改变做法,但不能靠统一的低得分区间证明目标设计好。示例把业务能力、平台接入和复杂度改进分别连接到具体成果;目标、资源和可检查结果需要共同确认,不能直接移用书中邮件量、覆盖率或效率数字。

挑战目标校准资源与证据

挑战性目标应要求团队探索更有效的做法,同时让关键结果与业务方向、资源和期限相连。书中业务、平台和代码质量目标展示了这种对应,但0.6或0.7分不是通用优良标准。目标定得高或数字多不代表合理,应能解释实现条件与结果证据。

挑战目标校准资源与证据保存独立卡片。

原书依据 · 1 处

11.3 技术规划

技术规划从团队视角安排建设事项,个人目标再承接其中责任。可按当前问题、技术能力、业务发展和团队特色四个层次展开,让眼前补缺与长期能力都有明确位置。

规划分层拆解

技术规划可从当前问题、通用技术能力、业务发展诉求和团队差异化四层展开,再将事项连接到成员目标。这样能同时考虑紧急修补与长期建设。四层是分析视角,不是必须填满的项目清单;优先级仍需依据风险、价值、资源和依赖确定。

规划分层拆解保存独立卡片。

原书依据 · 5 处

11.3.1 当前问题

当前问题层先处理迫切阻碍,如架构弹性或反复代码质量问题。方案应来自问题证据,而不是先决定分库、服务化或缓存再寻找理由。

规划分层拆解关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

11.3.2 技术领域

技术领域层按业务和团队情况,选择可靠性、性能或效率等能力命题,再排建设优先级。监控、CDN与测试自动化都是手段,需与要改善的问题连接。

规划分层拆解关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

11.3.3 业务领域

业务领域层把业务趋势转成技术需要,通过数据和业务交流识别未来能力缺口,再安排布局。技术建设既回应眼前需求,也应能解释对后续业务的作用。

规划分层拆解关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

11.3.4 团队特色

团队特色层寻找值得持续投入的差异化能力,既比较内外条件,也说明为什么应由本团队建设。作者以控制复杂度和相关工具为例;规模与成果的叙事不能证明同样规划必然带来同样结果。

规划分层拆解关联本项背景,实质主要讲解在对应位置。

原书依据 · 5 处

11.4 推理阶梯

推理阶梯区分观察、选择信息、赋予含义、假设、结论与行动。一个人没有打招呼可能有多种原因,不能从片段观察直接断定恶意。管理行动前应确认自己掌握什么事实、哪些只是解释,并用沟通核对。

推理前先核验

判断常从片段观察逐步跳到假设、结论与行动。熟人没打招呼,可能是没看见,并不必然表示轻视。管理者采取批评等行动前,应区分事实与解释,检查遗漏信息并沟通核对。推理阶梯帮助识别跳跃,不表示主观推理永远无用或沟通能消除全部不确定。

推理前先核验保存独立卡片。

原书依据 · 1 处

11.5 Leader和Manager的区别

技术领导不仅协调事务,也要深入系统和代码,帮助团队作技术判断并成长。管理与引领是可重叠的责任,不必把职位称谓固定为两种对立人格;书中的阿里巴巴岗位变化属于当时组织背景。

技术Leader重技术

技术负责人既要协调事务,也需保持足够技术判断,深入关键系统与代码,帮助团队理解问题、改进方案和成长。领导与管理是互补责任,不是靠职位名称划成好坏两类。应把精力投入能改变团队结果的技术与协作工作,而非只停留在指令和报表。

技术Leader重技术保存独立卡片。

原书依据 · 1 处

11.6 视人为人

信任建立在尊重、坦诚和可靠协作上。工作成果与关系维护都影响团队运行,但关系不是拉帮结派或讨好;面对不同层级的人应保留同样的人格尊重,并有勇气提出事实。

视人为人

领导需要尊重成员的感受、判断和边界,通过可靠协作与坦诚沟通建立信任。绩效成果与关系维护都重要,但不能把关系当作交换利益或要求服从的工具。面对上级、同级和下属,尊重不应因权力高低而改变,必要时也要有根据地表达不同意见。

视人为人保存独立卡片。

原书依据 · 1 处

11.7 本章小结

技术领导把团队能力、目标和人的协作连成持续工作。学习氛围提供输入,规划与目标安排方向,事实核验和尊重维持信任;个人也需明确想成为怎样的负责人,并按实际反馈调整。

第三部分 实践

第三部分以历史版本COLA和工匠平台,把前两部分的命名、职责、模型与抽象落实到工程结构。

第12章 COLA架构

COLA把职责、依赖和扩展安排为具体工程约定。CQRS分开读写职责,端口与适配器隔离外界,洋葱向内依赖保护核心,再用应用领域基础设施分层与脚手架落实。扩展坐标以能力和业务身份定位实现,缺失时按父身份和默认规则回退。测试与录制回放提供反馈,但历史框架能力需按版本和场景裁剪。

12.1 软件架构

软件架构表达系统怎样拆成组件以及组件怎样通信。本书为说明COLA的位置,区分业务、应用、系统、数据、物理与运维六个视角:分别关注业务组织、应用职责与接口、非功能能力与平台选择、数据规范闭环、硬件部署、以及运行维护。它们相互关联,不必一一对应固定岗位。

应用架构控复杂

应用架构按业务场景组织代码与组件职责,定义接口和数据交互约定,使应用能够被理解、扩展与维护。它与关注部署、平台选型或数据治理的视角相互配合。COLA在本书定位为应用架构实践,不是替代所有系统和运维设计的完整解决方案。

应用架构控复杂保存独立卡片。

原书依据 · 1 处

架构按关注点分视角

本书用六种视角讨论架构:业务看领域与能力,应用看职责和接口,系统看非功能要求与技术协作,数据看定义处理与使用闭环,物理看软件部署到硬件,运维看运行管理和自动化。分类帮助分工与沟通,各视角仍会交叉,不是固定岗位或互斥层次。

架构按关注点分视角保存独立卡片。

原书依据 · 1 处

12.2 典型的应用架构

在COLA之前先比较分层、CQRS、六边形和洋葱等应用架构视角,观察职责与依赖怎样安排。

12.2.1 分层架构

分层按职责组织代码,但层数和转交路径也会带来成本。千层面反模式指过度抽象、多余层次或严格转交使结构和运行更复杂;要检查每层是否真正隔离变化,而不是为了形式完整添加纯代理。

过度分层增加转交成本

千层面是过度分层的反模式:层数不断增加,却没有相应的职责收益,上层必须经过许多纯转发才能到达需要的能力。检查每层隔离的变化和实际增值,必要时合并或按约定开放访问。减少层数也不能随意绕过必要规则,目标是清楚边界与可接受成本。

过度分层增加转交成本保存独立卡片。

原书依据 · 1 处

12.2.2 CQRS

CQS在方法层区分修改状态的命令与不改变状态的查询;严格表述里的命令不返回值。CQRS进一步在应用职责和模型上分开读写路径,让两侧按需求优化。命令是否返回业务结果需结合接口责任,CQRS并不要求所有命令方法都void,也不要求两个物理数据库。

CQRS隔离读写

CQRS把改变状态与读取信息的职责分开,使写路径集中维护业务规则,读路径按展示或查询需要组织模型。读写可使用不同表示,不必使用不同物理数据库。它有利于分别优化,但也增加模型与同步管理成本,不保证天然更快或更简单。

CQRS隔离读写保存独立卡片。

原书依据 · 1 处
CQS区分方法责任

CQS把方法区分为修改状态的命令和只提供信息的查询,帮助调用者理解副作用。经典严格表述中命令不返回值;实际接口若返回创建结果等信息,应明确它属于动作的业务结果,并说明状态改变。不要把这种方法约定误认为CQRS强制所有命令返回void。

CQS区分方法责任保存独立卡片。

原书依据 · 1 处

12.2.3 六边形架构

端口定义业务内核与外界通信的契约,适配器把具体协议连接到它。驱动侧适配器调用应用实现的端口;被驱动侧适配器实现应用需要的端口,接入数据库或外部服务。方向不同,但都让核心只知道契约。

端口隔离外部

六边形架构把业务内核与外部机制分开,用端口表达契约、适配器转换具体协议。驱动适配器调用应用提供的能力,被驱动适配器实现应用需要的外界能力;同一端口可接不同适配器。隔离有助替换与测试,但端口仍须定义清楚行为和失败含义。

结构图:

flowchart LR
 A[驱动适配器] --> B[应用输入端口]
 B --> C[业务用例]
 C --> D[应用所需输出端口]
 E[被驱动适配器] -.实现契约.-> D
 E --> F[数据库或外部服务]

图表达组件角色与调用、契约方向;虚线是适配实现所需契约,不表示外部服务反向调用业务。

端口隔离外部保存独立卡片。

原书依据 · 1 处

12.2.4 洋葱架构

洋葱架构让领域模型处在中心,应用用例和基础设施位于外围,依赖方向向内。需要调用外部能力时,核心依赖自己需要的契约,外部适配实现它;运行时调用方向和源码依赖方向因此可以不同。

洋葱反转依赖

洋葱架构把领域规则放在核心,应用用例与技术机制分层围绕它,代码依赖由外向内。核心需要外部能力时依赖契约,外部实现适配该契约;运行时可向外调用,但源码不必依赖具体基础设施。替换是否容易仍取决于契约质量,不是只画同心圆就能消除耦合。

结构图:

flowchart LR
 A[UI与技术适配] --> B[应用用例]
 B --> C[领域服务与模型]
 A --> C

箭头表示允许的向内依赖,不把运行消息方向误作代码依赖。

洋葱反转依赖保存独立卡片。

原书依据 · 1 处

12.2.5 DDD

DDD是以领域模型组织开发的方法,并不是单一固定层次的架构。洋葱和COLA借用了领域中心的思想,但边界与依赖还要由具体架构约定落实,外部机制的替换也有实际成本。

12.3 COLA架构设计

COLA把前面几种架构视角组合为历史版本的具体约定,并增加扩展点与工程规范。下一组小节分别说明分层、扩展定位和模板如何落实,不能因组合了多种思想便预先判断所有场景适用。

12.3.1 分层设计

COLA把展现、应用、领域与基础设施分开:展现接协议和视图,应用组织输入及调用,领域维护核心规则,基础设施接入数据与技术。应用层按需要可直达基础设施,核心目标是区分业务规则与技术协调,不是强迫每个请求经过全部层。

COLA分层原则

本书COLA分为展现、应用、领域和基础设施:展现适配请求响应,应用校验与组装上下文并协调调用,领域处理核心业务规则,基础设施提供数据通道、配置等技术能力。应用可按约定直接使用基础设施;层次应按职责选择,不要求简单查询也经过空转的领域层。

结构图:

flowchart TD
 A[展现层] --> B[应用层]
 B --> C[领域层]
 B --> D[基础设施层]
 D -.适配领域契约.-> C

实线表示调用组织,虚线表示基础设施适配领域需要的能力;历史图中的组件依赖不等于每次请求必须走同一顺序。

COLA分层原则保存独立卡片。

原书依据 · 1 处

12.3.2 扩展设计

扩展坐标由扩展点和业务身份共同确定。启动时扫描并注册实现,运行时先匹配完整BizCode,失败则逐级去掉末段,再尝试默认实现,最后显式失败。身份层级表达业务场景关系,查找顺序会影响实际行为。

扩展坐标

本书COLA用扩展点名称与BizCode组成扩展坐标,注册表据此定位实现。启动注册若发现同一坐标已有值则报重复,运行时根据上下文选择实现。扩展点抽象共同能力,业务身份描述场景,不能只按业务码忽略能力类型,也不能把该历史规则当成所有版本API。

扩展坐标保存独立卡片。

原书依据 · 1 处
扩展定位逐级回退

扩展定位先查完整业务身份,未命中则去掉最末一级继续查父身份,再查该扩展点默认实现,全部缺失时抛错。例如ali.tmall.car依次尝试本级、ali.tmall、ali、默认。回退次序是行为契约,父级实现必须适用于回退场景,不能把默认当成静默成功。

结构图:

flowchart TD
 A[完整身份查找] -->|未命中| B[逐级父身份查找]
 A -->|命中| E[返回实现]
 B -->|命中| E
 B -->|已无父级| C[默认实现查找]
 C -->|命中| E
 C -->|未命中| D[抛出未找到异常]

扩展定位逐级回退保存独立卡片。

原书依据 · 1 处

12.3.3 规范设计

COLA把模块、包和类型名变成可检查的职责线索。领域模块保持核心规则,应用组织校验、命令查询、转换和仓储协调,基础设施提供通道、配置与公共能力。命名后缀让审查者容易发现错放职责,但规范不能只靠名称判断实现。

规范即架构

架构约束可通过模块、包和类型命名落实为可检查的职责线索。历史COLA用Cmd/CO表达输入与数据,CmdExe处理命令,ExtPt/Ext表达扩展,Validator/Convertor/Assembler表达支撑职责,DO/Tunnel接数据。规范帮助发现错放代码,但名字符合不代表依赖和行为已经正确。

规范即架构保存独立卡片。

原书依据 · 1 处
模块分包承接职责

模块表达较大的架构边界,包再聚集相关能力,使项目结构能从整体逐层展开。历史COLA应用层包含服务、命令查询、校验转换等,基础设施按数据通道、配置和公共能力组织。分组应保持内聚并减少跨组耦合,而非为了目录对称建立空包。

模块分包承接职责保存独立卡片。

原书依据 · 1 处

12.3.4 COLA Archetype

Archetype把架构约定变成可生成的初始工程。书中命令指定应用的groupId、artifactId、版本和package,并指定COLA原型版本,生成client/controller/app/domain/infrastructure等模块。命令是历史SNAPSHOT示例,插入的中文注释不是可直接运行的参数。

脚手架承载初始约定

应用脚手架把模块、包和命名约定固化为初始结构,减少新项目反复手工搭建的差异。历史COLA用Maven Archetype生成client、controller、app、domain和infrastructure。生成骨架不等于业务已实现,也不保证后续改动一直符合架构;原型与框架版本应匹配。

脚手架承载初始约定保存独立卡片。

原书依据 · 1 处

12.4 COLA测试

测试成本受到依赖边界影响。业务规则与数据库、远程服务紧密耦合时,准备环境和替身会变得困难;分离核心可以让部分测试避开这些外部条件,但不能断言所有service+DAO结构都不可测试。

12.4.1 单元测试

单元测试聚焦较小的行为范围,并尽量快速、稳定地提供反馈。领域规则与外部机制分开后,可以直接构造对象检查结果;粒度与时间阈值是设计提示,不能仅凭毫秒级就判断测试合格。

独立规则便于快速测试

单元测试聚焦小范围行为,尽量减少外部环境依赖,以便快速重复验证。核心规则若能直接构造并调用,就可把输入与预期结果清楚对应。函数或类是常见边界,不是绝对上限;速度快也不能代替有意义的断言与失败情形。

独立规则便于快速测试保存独立卡片。

原书依据 · 1 处
测试保护架构

测试准备成本可反馈架构边界是否清楚。若业务规则必须启动数据库和远程服务才能验证,应检查规则是否与技术协调混杂;清晰契约让部分规则可直接验证、部分依赖可替换。测试是观察设计的一种手段,不是通过几个用例便证明整套架构正确。

测试保护架构保存独立卡片。

原书依据 · 1 处

12.4.2 集成测试

集成测试检查模块组合与接口协作。真实依赖能暴露环境及协议问题,却需要稳定环境与数据;替身能控制场景和提高重复性,但需要维护与真实契约的一致。可按风险选择混合策略,不是只有全真实或全Mock两个极端。

集成测试权衡依赖策略

集成测试关注模块组合后的协作。连接真实依赖可发现协议与环境问题,但准备和稳定成本较高;用Mock可控制输入和故障,却要维护替身与真实契约的一致。应按边界风险组合选择,替身通过不等于真实集成已通过,集成测试也不必一律黑盒。

集成测试权衡依赖策略保存独立卡片。

原书依据 · 1 处

12.4.3 ColaMock

ColaMock以录制和回放减少手写替身数据。标注录制边界后,监听器在测试开始清理并注入记录机制,结束后写出数据;回放时排除真实Bean,用代理在调用时提供已录结果。录制需要可信基线,回放也无法发现所有真实依赖变化。

录制回放复用依赖样本

ColaMock在指定依赖边界录制调用数据,之后通过替身代理回放,减少反复手写Mock。录制监听器管理开始清理与结束保存,回放则用替身替换真实Bean。样本须来自合适基线,失配或过期时需要处理;回放成功不证明真实服务当前仍兼容。

结构图:

flowchart TD
 A[标注记录边界] --> B[录制运行]
 B --> C[保存输入与依赖结果]
 C --> D[回放时替换真实Bean]
 D --> E[代理返回记录数据]
 E --> F[校验业务结果]

录制回放复用依赖样本保存独立卡片。

原书依据 · 1 处

12.5 COLA架构总览

COLA总览把领域中心、向内依赖和外部适配连接起来,再用命令查询分离、扩展定位及录制回放组织请求与测试。历史纵向图还有命令总线、拦截器、事件和数据通道;这些部件按场景选择,不是每个应用都必须部署的同一条处理链。

COLA组合能力按需采用

本书COLA把领域核心与外部适配作为边界,用命令查询职责分离组织入口,用扩展点处理场景差异,用测试替身降低依赖准备成本。各能力回应不同问题,应逐项确认收益和契约;总览图不是每个请求必须经过的固定流水线,也不是当前所有版本结构。

COLA组合能力按需采用保存独立卡片。

原书依据 · 1 处

12.6 本章小结

架构能力应按实际需求裁剪。没有复杂业务分支时可以不用扩展点,简单CRUD也未必需要专门领域层;仍可保留有用的分层、命名和模板约定,避免为了使用框架而制造问题。

第13章 工匠平台

工匠平台先把技术工作拆成观察指标,再演化员工、度量、明细与权重模型,最终将计分规则、存储映射和协议入口分开。主子度量的层次加总展示模型如何进入代码,阈值断言与回归则保护已有行为。评分是业务选择而非人员价值的客观真相,示例运行与实际效果仍需后续验证。

13.1 项目背景

平台试图把业务交付之外的技术工作纳入可讨论的指标,包括代码质量、分享和技术贡献。评分是这套产品的设计选择,可支持观察,但不能因为量化就认定准确、全面或公平。

技术度量是观察模型

技术工作可以建立多个观察维度,使代码质量、分享和改进贡献不完全被业务交付量遮住。指标与评分只是人为设计的观察模型,需说明数据来源、遗漏和激励影响;量化不自动等于客观评价,更不宜仅凭总分决定一个人的能力。

技术度量是观察模型保存独立卡片。

原书依据 · 1 处

13.2 整理需求

平台把需求分成应用质量、技术影响力、技术贡献和开发质量,再给每类定义指标与权重。评论量、浏览量等容易采集,但仍是代理信号;不同岗位的责任不同,统一总分需要说明适用范围,不能把数值高直接等同贡献大。

指标体系先定义口径

指标体系应先确定观察维度,再定义数据口径和聚合方式。工匠平台用代码质量、影响力、贡献与开发质量四类组织指标,并加权汇总。浏览量或评论数只是代理信号,需检查重复、上下文及岗位差异;总分可帮助定位线索,不能自动代表贡献全貌。

指标体系先定义口径保存独立卡片。

原书依据 · 1 处

13.3 工匠Demo

Demo把团队总览与个人详细信息分开,列表支持发现差异,详情让人查看分数构成。图示只展示产品如何组织指标,不证明排名公平或谁表现更好。

13.4 使用COLA

本组使用步骤按出版时COLA项目结构介绍安装与创建骨架。它为后续示例提供环境语境,不能以“轻量”评价代替依赖与版本核对。

13.4.1 安装COLA

历史安装路径先获取COLA源码,再分别安装框架和原型到本地Maven仓库。恢复旧示例应先识别对应版本与目录,不把当前主分支默认当成书中版本。

历史COLA本地安装路径

本书安装路径是先获取COLA源码,再进入cola-framework和cola-archetype分别执行Maven安装,使框架与项目原型可在本地使用。它说明历史示例的依赖准备顺序;目录、依赖和SNAPSHOT版本可能变化,复现前应绑定对应版本并检查构建说明。本轮未克隆或安装框架。

历史COLA本地安装路径保存独立卡片。

原书依据 · 1 处

13.4.2 搭建应用

应用原型以项目坐标和基础包名生成工程,工匠示例分为控制器、对外数据接口、应用协调、领域规则、基础设施和启动测试。目录表达职责,真正的依赖与实现还要由代码落实。

骨架模块分配实现位置

工匠示例骨架把请求适配放controller,对外调用数据与接口放client,流程协调放app,业务规则放domain,数据访问放infrastructure,启动和集成测试放start。模块名帮助定位职责,但不证明依赖已经正确;生成后应按实际能力检查边界,而非把所有逻辑塞入最方便的模块。

骨架模块分配实现位置保存独立卡片。

原书依据 · 1 处

13.5 领域模型

接下来从员工、团队和度量出发,展示概念模型与代码如何相互推动演化。

13.5.1 领域建模

模型先从团队、员工档案与度量建立关系,再加入度量项、权重、主度量和子度量。每一步都回应实现中显露的表达需要:一篇文章是明细,技术影响力包含多种子度量,不同角色又可能采用不同权重。模型与代码因此交替推进,而非等模型完美后才实现。

模型代码螺旋

领域模型可先表达核心概念,再通过实现与场景反馈逐步精化。工匠平台从档案和度量加入度量项、权重以及主子度量,分别回应明细、多岗位和层次计算需要。代码能暴露概念缺口,模型又指导职责调整;不是先把所有图画完才允许实现。

模型代码螺旋保存独立卡片。

原书依据 · 1 处

13.5.2 领域词汇表

词汇表区分团队、档案、主度量、子度量、度量项、分数和权重,并贯穿讨论、设计与代码。每个词对应一个可讨论的业务职责,语言统一的价值在于能追踪概念,而不是把所有代码强制使用相同后缀。

词汇落到代码

领域词汇应对应实际职责并贯穿讨论、模型与实现。工匠平台区分mainMetric、subMetric和metricItem,使“影响力—文章度量—一篇文章”的层次能在代码中辨认。术语表要随模型理解维护;只统一拼写而含义漂移,仍会造成沟通断裂。

词汇落到代码保存独立卡片。

原书依据 · 1 处

13.6 核心业务逻辑

核心计算把每个度量项的计分、子度量汇总和主度量加权分开。文章项从基础分0.5起,按浏览、点赞、收藏和评论的台阶各加0.25;子度量求明细和,主度量再乘子度量权重。业务计算可不等待数据库实现,但原类仍出现日志、JSON等技术依赖,不能声称整段类只依赖JDK。

核心逻辑独立

把计分等业务规则组织为可直接调用的对象行为,可在数据库和协议实现尚未确定时先验证规则。独立主要指不让规则依赖具体数据访问流程;本书ATAMetricItem仍含日志和JSON解析,不能因此声称整个类完全没有技术依赖。隔离程度应据实际代码判断。

核心逻辑独立保存独立卡片。

原书依据 · 1 处

文章评分按台阶累加

原示例从0.5基础分开始,浏览每满100、点赞每满20、收藏每满15、评论每满3,各加0.25。对非负计数,分数可写为0.5+0.25×四项整除商之和;这是代码的直接归纳,不是通用文章质量标准。计数范围、异常值及实际指标有效性还需另定。

文章评分按台阶累加保存独立卡片。

原书依据 · 1 处

主子度量分层聚合

子度量汇总各明细项得分,主度量再按子度量权重加总。这样明细规则与层次聚合分开,增加新的明细算法不必重写全部总分流程。原草稿的父级、owner与构造路径需一致,重复添加或缺少owner都会影响计算,不能把结构示意当成完备实现。

结构图:

classDiagram
class Metric
class MetricItem {
  +calculateScore() double
}
class SubMetric {
  <<abstract>>
  +addMetricItem(MetricItem metricItem) void
  +calculateScore() double
  +getMetricOwner() UserProfile
  +setParent(MainMetric parent) void
}
class MainMetric {
  <<abstract>>
  +addSubMetric(SubMetric metric) void
  +calculateScore() double
}
class ATAMetric {
  +getWeight() double
}
class ATAMetricItem {
  +calculateScore() double
  +valueOf(String json) ATAMetricItem
}
Metric <|-- MainMetric
Metric <|-- SubMetric
SubMetric <|-- ATAMetric
MetricItem <|-- ATAMetricItem
MainMetric --> SubMetric : 汇总并取权重
SubMetric --> MetricItem : 求明细和
SubMetric --> MainMetric : parent

空心三角为继承,普通箭头为持有或使用;Metric未给完整声明,不补造其全部签名。

主子度量分层聚合保存独立卡片。

原书依据 · 1 处

13.7 实现技术细节

实现规则之后,再安排存储映射和HTTP适配,使技术机制有明确边界。

13.7.1 数据存储

领域模型表达业务责任,数据模型表达存储与检索,数量与结构不必对应。工匠平台把多个领域对象落到user_profile和metric两张表,重建对象需要明确映射与组装;表少不自动等于设计更好,也不证明ORM无法实现这种映射。

存储映射不照搬领域类

领域模型组织业务职责,数据模型组织存储与查询,两者不必按类表一一映射。工匠平台的多个领域概念可由user_profile和metric两张表承载,再通过映射组装对象。选择应解释读取、写入和演进需要,不能以类数与表数差异证明某类工具必然无能。

存储映射不照搬领域类保存独立卡片。

原书依据 · 1 处

13.7.2 控制器

控制器把HTTP输入转换成应用请求,再把服务结果交回响应。示例GET组装ATAMetricQry并调用查询,POST接收ATAMetricAddCmd调用新增;控制器不直接实现计分规则。RestController组合控制器与响应体语义,具体序列化格式仍由配置和内容协商决定,不应只凭注解断言永远JSON。

控制器适配协议边界

MetricsController负责把HTTP请求交给应用接口:GET接收ownerId并组装查询,POST接收新增命令,再转交MetricsServiceI。业务计分不应因协议适配散入控制器。前后端分离并不自动取消后端控制器,具体部署位置要由职责与调用边界决定。

结构图:

classDiagram
class MetricsController {
  -MetricsServiceI metricsService
  +listATAMetrics(String ownerId) MultiResponse~ATAMetricCO~
  +addATAMetric(ATAMetricAddCmd ataMetricAddCmd) Response
}
class MetricsServiceI
MetricsController --> MetricsServiceI : 转交应用请求

箭头为调用依赖;服务接口完整声明未给,故不补造其余方法。

控制器适配协议边界保存独立卡片。

原书依据 · 1 处

13.8 测试

本组示例把小范围规则验证、隔离外部依赖的集成验证以及回归使用连接起来。

13.8.1 单元测试

单元测试示例用阈值下方、刚好达标和多个台阶三组计数检查文章评分,再用有无操作者检查上下文默认值。它说明预期行为如何形成可重复断言,但样例并未覆盖所有异常输入或所有框架行为,笔记记录的是静态预期而非执行结果。

测试支撑重构

把关键规则写成可重复断言,可在新增功能或重构时检查既有行为。文章评分用阈值下方、刚达阈值和多个台阶输入覆盖不同结果,上下文用有无操作者检查分支。例子说明测试选择思路,不代表覆盖率高就没有缺陷,也不表示本轮运行过这些测试。

测试支撑重构保存独立卡片。

原书依据 · 1 处
阈值两侧检验计分规则

文章评分可用台阶边界设计输入:点赞19/浏览99/收藏14/评论2预期0.5,20/100/15/3预期1.5,100/500/75/15预期5.5。参数顺序依构造函数而定。这些为原代码推得的预期,未实际运行;还需按业务需要另查异常计数、范围和独立边界。

阈值两侧检验计分规则保存独立卡片。

原书依据 · 1 处

13.8.2 集成测试

集成示例用ColaTestRunner与ColaMockConfig替换MetricTunnel,分别断言成功新增和缺少作者时失败。对id、userId的排除比较可降低动态字段噪声,也可能遮蔽错误,因此需要说明哪些规则仍被断言,不能只看success字段就证明所有数据正确。

回放测试仍需明确断言

集成回放可替换MetricTunnel等边界依赖,让服务调用在可控样本下检查成功与业务拒绝。动态字段可按理由排除比较,但必须保留关键规则的断言;只检查response.isSuccess不能证明所有持久化数据正确,样本过期也可能掩盖真实契约变化。

回放测试仍需明确断言保存独立卡片。

原书依据 · 1 处

13.8.3 回归测试

单元和集成测试沉淀后,可在变更时反复运行作为回归检查,提高对既有行为的信心。回归通过表示已覆盖断言仍成立,不自动证明无缺陷,也不能只凭覆盖率决定跳过其他必要验证。

回归通过限定已有断言

回归测试在变更后重跑已有用例,检查已知行为是否退化,使重构有更及时的反馈。通过只说明这些输入与断言仍满足预期,未覆盖场景和真实环境差异仍可能出错。是否减少其他验证应按风险和证据决定,不能只凭覆盖率就跳过QA。

回归通过限定已有断言保存独立卡片。

原书依据 · 1 处

13.9 本章小结

工匠平台示范从需求指标到领域模型、计算规则、存储与控制器,再到测试的完整表达链。模型与代码互相推动,架构与规范提供初始约束;采用COLA仍应根据业务裁剪,框架不是必选项。本单元后半是重复的全书Table of Contents,已读并按纯目录排除,不当作新增正文。

跨章综合

命名、模型和统一语言都在回答“当前对象负责什么”。名称含糊时,不只是表达问题,也可能暴露职责与概念的错位;模型进入代码后,又会通过实现中的重复和分支反过来要求修正。统一语言因此是一条持续更新的联系,而非一次性术语表。

函数分解、接口隔离、分层与数据库拆分都在划边界,但边界的代价不同。函数边界影响阅读与调用,模块边界影响依赖与发布,数据边界影响查询和一致性;把局部更小直接等同整体更简单,会漏掉协调成本。应逐层说明边界隔离了何种变化,何时可以越过它。

开闭、插件与COLA扩展坐标都依赖稳定契约,只是扩展时点和组织方式不同。先理解共同业务能力,再决定用策略、外部插件还是场景坐标;无法预知的变化仍可能要求修改契约,预留所有扩展点反而偏离YAGNI。

测试、审查、指标和目标是反馈手段,其结果需要解释范围。回放通过不能证明真实依赖没变,覆盖率不能证明没有遗漏,评论数不能证明审查有效,工匠分也不能代表全部贡献。把反馈与事实、假设和下一动作连起来,才能让持续精进成为可检查过程。

发散与实践

本书可以沿三个有限路径进入现实。第一条从拦截器的执行和清理边界进入固定版本Spring源码,已实际读取链、接口与官方测试全文,以及DispatcherServlet的完整doDispatch方法,初步映射在本批本地材料中。它比较的是顺序、中止与清理责任,不把Spring类型硬套进原书递归实现;后续完整链路与异步观察仍为计划。

第二条以当前Cardbox导入为真实任务,检查一次命令输出与完整业务结果之间的关系,形成可复用验收清单。第三条用七天个人工作记录观察“两次创造”,比较检查投入、发现的问题与返工,并记录任务差异和反例。这两条尚未开始实测,不提前填写成果。

计划ideas/idea-001-深读拦截器完成边界.md。

计划ideas/idea-002-核对导入返回的业务含义.md。

计划ideas/idea-003-七天记录两次创造.md。

实践计划交付与实际实践完成分别记录。没有安装框架、启动服务、发送消息、执行转账或进行人员评价;轻量模式未执行生成后的笔记复核、独立审查及审查结果优化。

生成进度与管理记录

代码精进之路:从码农到工匠(异步图书)

整体评级

  • 四象限结论:工程实践(高信息浓度 + 中等偏低稳定性)
  • 信息浓度:高。全书围绕代码可读性、复杂度治理、DDD、抽象、分治、应用架构等主题展开,不只是罗列操作步骤,而是反复解释为什么命名、规范、函数、模型、分层和测试会影响长期维护成本。
  • 稳定性:中等偏低。命名、函数、SOLID、DDD、抽象、分治等原则具有长期稳定性;但 COLA、Spring Boot、Maven Archetype、ColaMock 和第13章工匠平台实战绑定了具体框架与当时实践,工具层内容会随生态变化而折旧。
  • 支撑例子:第1章把命名解释为问题理解和抽象能力的体现;第7章用银行转账对比事务脚本和领域模型;第12章从分层、CQRS、六边形、洋葱架构推导 COLA;第13章则包含较多安装、脚手架和测试框架操作,因此整体更像高质量工程实践,而非纯经典原理。

历史章节筛选

  • 第1章《命名》:精读。命名被上升为抽象与表达能力,直接影响代码可读性和团队共同理解。
  • 第2章《规范》:精读。规范从认知成本、日志、异常、架构约束等角度解释如何降低混乱。
  • 第3章《函数》:精读。函数是最小逻辑单元,章节包含封装判断、参数、职责、组合函数等高频技法。
  • 第4章《设计原则》:精读。SOLID、DRY、YAGNI、KISS等原则以权衡方式展开,稳定可迁移。
  • 第5章《设计模式》:精读。模式被解释为可复用经验,并重点讨论拦截器、插件、管道等工程模式。
  • 第6章《模型》:精读。建模被定位为理解问题域和沟通架构的工具,适合沉淀方法卡。
  • 第7章《DDD的精髓》:精读。DDD章节集中讨论领域模型、统一语言、聚合、事件和边界,是全书高浓度部分。
  • 第8章《抽象》:精读。抽象被作为面向对象、建模和架构的底层能力展开,理论迁移性强。
  • 第9章《分治》:精读。分治贯穿算法、函数、分层和分布式切分,是治理复杂度的基础思想。
  • 第10章《技术人的素养》:精读。技术人素养包含不教条、批判性、结构化、目标、笔记等可迁移做事原则。
  • 第11章《技术Leader的修养》:精读。技术Leader章节结合技术氛围、OKR、规划和沟通,适合团队管理场景复用。
  • 第12章《COLA架构》:精读。COLA章节把典型应用架构和复杂度治理落到分层、扩展、规范、测试。
  • 第13章《工匠平台》:精读。实战章节操作细节较多,但领域模型演化、统一语言、核心逻辑隔离仍值得摘取。

历史章节进度追踪

章节号 章节标题 精读/略读 状态(pending/done) 卡片数
01 命名 精读 done 3
02 规范 精读 done 3
03 函数 精读 done 5
04 设计原则 精读 done 5
05 设计模式 精读 done 4
06 模型 精读 done 4
07 DDD的精髓 精读 done 6
08 抽象 精读 done 4
09 分治 精读 done 4
10 技术人的素养 精读 done 7
11 技术Leader的修养 精读 done 6
12 COLA架构 精读 done 8
13 工匠平台 精读 done 4

总卡片数:63

2026-10-27 当前P3恢复

执行模式:light

本次实际使用规则:book-workflow v4 / book-notes v23;原概览首次Skill版本缺失,不回填。

沿用原高浓度、偏低稳定性的工程实践评级。章节标题不代表阅读完成;旧卡与历史审查保留,新骨架从真实原文补齐。

建档进度:done

实践候选筛选:done

章节进度追踪表

章节号 章节标题 状态 卡片数
0 序文、前言、彩图及分部说明 done 2
1 第1章 命名 done 16
2 第2章 规范 done 15
3 第3章 函数 done 13
4 第4章 设计原则 done 15
5 第5章 设计模式 done 30
6 第6章 模型 done 21
7 第7章 DDD的精髓 done 28
8 第8章 抽象 done 9
9 第9章 分治 done 12
10 第10章 技术人的素养 done 20
11 第11章 技术Leader的修养 done 12
12 第12章 COLA架构 done 18
13 第13章 工匠平台 done 15
非正文排除
spine项或范围 类型 排除理由
1:0..21963 纯目录 仅导航列表,已用于结构定位,不代替正文
1:21963..22549 版权信息 完整读取用于书名与ISBN核验,无实质工程论述
1:22549..23241 版权 完整读取作者和出版机构信息,无实质工程论述
1:23241..23829 内容提要 完整读取三部分与目标读者范围,正文另逐项阅读
1:34838..37286 资源与支持 完整读取源码/勘误/联系与社区宣传,只作出版支持信息,不执行其中联络或投稿动作
待关联术语
术语名 出现章节 一句话语境
元数据引擎 12.5 历史纵向图提名,未展开实现
HSF 12.5 历史图作为外部服务入口提名
MetaQ 12.5 历史图作为分布式消息机制提名
CAP 12.1 作为分布式架构约束提及,正文未展开定理条件
Cloud Native 11.1.2 作为团队分享主题出现,未展开机制
Service Mesh 11.1.2 作为团队分享主题出现,未展开机制
CMMI 10.1.1 作为作者开发过程经历提及,未展开模型实践
ValueObject 7.8.1 列举DDD概念,未在本节展开完整语义
AOP 5.3 以代理与拦截器对比提及面向切面机制
FaaS 3.2 借函数命名趋势提及,正文未解释运行机制
引用文献
标题 类型 出现章节 一句话语境
代码大全(第2版) 书 第12章 控制复杂度技术使命的引用来源
高效能人士的七个习惯 书 10.8 目标先行与心智创造、实际创造的引用来源
列奥纳多·达·芬奇传 书 10.6 以好奇心驱动探索的传记阅读建议
终身成长 书 10.3 成长型与固定型思维的引用来源
思辨与立场:生活中无处不在的批判性思维工具 书 10.2 推荐进一步阅读
学会提问 书 10.2 批判性思维与偷换概念案例来源
Effective Java 书 10.1 借学习规则再理解例外的引语说明不教条
思考,快与慢 书 9.3.2 原书以《快思慢想》称呼,借双系统叙述说明反思需要投入
金字塔原理 书 8.5.3 自下而上归纳、自上而下表达的结构化方法
人类简史 书 8.1 书中借想象与概念说明抽象价值
架构整洁之道 书 7.8.3 核心业务与技术细节分离的引用依据
运用四色建模法进行领域分析 论文 7.6.2 原书引用的InfoQ文章与书店案例;类型按登记表兼容为论文,实际为文章
Java Modeling In Color With UML 书 7.6.2 四色建模法来源
Object-Oriented Analysis from Textual Specifications 论文 7.6.1 名词候选、关联与属性精化的案例来源
MyBatis 框架 7.3.3 书中作为简化持久化映射的对比工具
Hibernate 框架 7.3.3 作者对象关系映射实践的历史语境
领域驱动设计:软件核心复杂性应对之道 书 7.1 Eric Evans提出的DDD方法论来源
UML和模式应用 书 6.2 UML进一步阅读建议
面向对象分析与设计 书 6.2 UML进一步阅读建议
WebX 框架 5.5.1 历史管道实现参考
Tomcat 源码项目 5.5.1 管道与阀门的应用实例,未在此读源码
JPF(Java Plug-in Framework) 源码项目 5.4 推荐作为插件元数据、依赖和类加载机制阅读入口
Activiti 框架 5.3 原书Activity拼写对应流程引擎引用,未展开实现
Struts2 框架 5.3 以历史Interceptor机制说明模式用法
设计模式解析 书 5.2 推荐进一步阅读
Head First Design Patterns 书 5.2 推荐进一步阅读
设计模式:可复用面向对象软件的基础 书 5.2 GoF的23种设计模式及分类
Extreme Programming Installed 书 4.8 YAGNI相关引用
The Pragmatic Programmer 书 4.7 DRY原则的引用文献
Design Principles and Design Patterns 论文 4.1 SOLID相关设计原则的引用文献
Smalltalk Best Practice Patterns 书 3.8 组合函数模式的引用来源
Hystrix 框架 3.7.3 通过历史注解示例说明降级逻辑与业务路径分离
Broken Windows 论文 2.6 书中借其比喻说明局部混乱被模仿的风险
复杂 书 第2章 以有序与无序引出规范的认知价值
重构:改善既有代码的设计 书 1.5.3 以注释坏味道说明表达能力不足
人月神话 书 前言 复杂性讨论的引用文献
COLA 源码项目 前言 作者2018年实践形成的框架,本书版本作为历史实现阅读
资金安全问题案例
问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

整书笔记为本轮正文与定位真源,全文生成收束。

实践卡进度

序号 实践标题 实践方式 状态 关联章节 产出
1 深读拦截器完成边界 实现深读 done 5.3、12.4 ideas/idea-001-深读拦截器完成边界.md;官方源码与首轮映射
2 核对导入返回的业务含义 真实任务 done 1.3、12.1 ideas/idea-002-核对导入返回的业务含义.md;有限范围的后续计划
3 七天记录两次创造 行为实验 done 9.3 ideas/idea-003-七天记录两次创造.md;有限范围的后续计划

实践候选筛选:done。采用固定版本拦截器深读、导入结果契约任务和七天个人观察。未采用全量复现历史COLA应用:安装环境与版本成本高,当前理解目标由成熟源码和边界检查即可满足;不做实际人员排名或团队绩效干预。

2026-10-27 本轮阶段2交接

light;book-workflow v4 / book-notes v23。3个正文spine、232单元和238阅读片段全部实读,124唯一图像均已查看,6处非正文范围已读排除。226知识卡(63历史文件保留、163新),226唯一primary、236位置引用与236核验来源;普通198、结构图27、操作参考1。整书导读、全部章节讲解和跨章综合已收束。三张实践计划交付:实现深读1、真实任务1、行为实验1;首轮固定版本Spring源码映射已准备,后续实践未执行。

生成后的笔记复核、独立审查及审查结果优化未执行。阶段2放行,阶段3 skipped;生产导入对账通过,226/226归档完成,pending软链0。

2026-11-14 V24恢复验收

本次执行版本:book-workflow v4 / book-notes v24,显式以 --mode light 恢复;首次版本缺失不回填,历史规则记录保留。原书131资源与活动缓存逐字节一致,232份历史放行文件hash匹配;3正文spine按实际导航拆成232单元/238阅读片段,124种图像完整阅读证据有效复用,全文文本重派生一致。真实exclusions.json为5个排除区间;232正文区间与5排除区间连续覆盖全部原始HTML,纠正历史摘要“6处”的统计,不改变原书或正文范围。

复用226知识卡、3实践计划(实现深读、真实任务、行为实验各1),本轮新增0卡、修订知识卡0;固定Spring v5.3.39的4份首轮源码/测试材料hash匹配,沿用2026-10-27访问日期,不宣称本轮重新联网核验或适用最新运行时。

整书笔记为唯一阅读正文。轻量模式:未执行笔记复核、独立审查及审查结果优化;实际实践、测试、服务启动及线上操作未执行。按书导入、236引用/236出处对账及226卡归档验收见_workflow.md。证据.local/runs/p3-168-20261114/。

2026-11-14 v24完整流程恢复

本次执行版本:book-workflow v4 / book-notes v24;执行模式:light。原概览首次Skill版本缺失,继续不补造;历史v23生成记录保留。

本书作者张建飞,人民邮电出版社,ISBN978-7-115-52102-6;版次未明,沿用整书笔记中的null,不猜测。已重算EPUB SHA-256并将131份缓存资源逐字节比对原书和历史来源清单;232个历史放行文件全部匹配。13章及前置内容的232单元/238阅读片段、124幅图的全文阅读证据有效,3个实际正文spine与6处非正文范围保持,不将章号误当spine。

本次复用226知识卡(198普通、27结构图、1操作参考),新增0、修订知识卡0、删改名0。226唯一primary、236位置引用和236原书出处;整书笔记schema1,SHA-256 a2aa945fd19960ceedc7d6b37a5fe1292a414147c0031dfe25f997fc58e86122。既有来源、概念讲解、章节大纲、候选取舍、全部卡片及实践计划对应同一有效版本。

评级沿用工程实践(高浓度、低稳定性),按代码风格与技巧主题保持P3;职责、抽象与模型思想可迁移,COLA、Spring和历史工具示例保留出版及固定版本边界,不作为最新版本使用指引。3实践计划(实现深读、真实任务、行为实验各1)及Spring v5.3.39首轮材料、两层阅读计划复用,保留2026-10-27核验日期;未执行完整实践,不声称本次重新联网或运行测试。

本轮未执行生成后笔记复核、独立审查及审查结果优化。导入、归档和验收结果见_workflow.md本次交接,证据位于.local/craft-v24-20261114/;不以历史报告或已归档状态单独代替当前版本核验。

相关主题

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

暂无公开主题。