来源书籍

UML精粹:标准对象建模语言简明指南(第3版)

Skill 版本:v23 领域建模类 148 张卡片

Martin Fowler([美]福勒) · 第3版(OPF题名)

类别清单覆盖

7/7

已覆盖 7 补充生成 0 未覆盖 0

全书导读

本书用较小的UML子集帮助读者表达软件结构与行为。最重要的不是熟记全部符号,而是知道当前需要解释对象关系、参与者交互、生命周期、工作流还是部署位置,再选能讲清问题的表示法。图是交流和推理的工具,不能仅凭形式合法就判定设计合理。

全书主线

先说明UML使用方式及开发过程,再以类图建立静态结构基础,以序列图检查对象协作,随后补充更细的类型和依赖语义。状态机与活动图分别处理单对象反应和跨步骤流程,其余图从连接、装配、发布和时间等角度补充模型。图与图是互补视角,不能将它们硬连成必须依次完成的开发流水线。

简介

UML是一套用于交流软件模型的表示法及其共同语义。首先应决定把它用于选择性的草稿、定义性的蓝图还是可执行语言,再说明图面向领域概念还是软件实现。图中省略的信息不等于不存在,建模的准确性也不能代替需求本身的正确性。

UML在实践中有三种用法:当草稿用,只挑重要部分粗略画图辅助沟通,故意不追求完整;当蓝图用,设计者画出完整细节,程序员照图编码,编码被压缩成机械活动;当编程语言用,图直接编译成可执行代码,图与源码合一。三者区别不是工具复杂度,而是对完整性的要求:草稿是探索性的,蓝图是定义性的。实践中最常用的是草稿模式。 进一步展开见UML的三种使用模式。

在建模语境下,正向工程是先画图、后写代码,用图指导或探索即将编写的实现;逆向工程是从已有代码反推生成图,帮助理解陌生系统。二者可用于UML的三种使用模式的草稿或蓝图:正向草稿讨论要写的东西,逆向草稿解释系统某部分如何运作;正向蓝图由设计者产出详图供程序员照做,逆向蓝图追求把代码细节尽量图形化。能同时做两个方向的工具称为双程工具。 进一步展开见正向工程与逆向工程。

模型驱动架构(MDA)把开发拆成两步:先建立与具体技术无关的平台无关模型(PIM),再由工具把它转成针对特定执行环境的平台特定模型(PSM),最后由更进一步的工具从PSM生成代码。若某个仓储系统要同时跑在J2EE和.NET上,只需一个PIM、两个平台各自的PSM。可执行UML是同一思路的简化版:跳过PSM,用”模型编译器+架构型”把PIM直接一步编译成可部署系统。这条链路自动化程度越高,UML的用法就越接近UML的三种使用模式中的”编程语言”;只要有人工步骤介入,就仍属于”蓝图”用法。 进一步展开见MDA的代码生成链路。

UML同时定义了表示法和元模型:表示法是图上直接看到的图形语法(怎么画类、关联、多重性);元模型是用一张图(通常是类图)定义这门建模语言本身有哪些概念及其关系,用来在不牺牲直觉的前提下提高语言严谨性。两者受关注程度取决于用法:把UML当草稿的人几乎不关心元模型,当蓝图用的人关心得多一些,当编程语言用的人必须关心,因为它定义了语言的抽象语法,直接决定图能否被正确编译。 进一步展开见表示法与元模型的区别。

语言的规则可以是强制性的(权威机构规定合法与否,如编程语言)或描述性的(含义由使用习惯沉淀,如自然语言)。UML标准文档精确,容易被误认为强制性,但对多数人而言UML其实是描述性的:标准影响最大却非唯一来源,行业和项目中的习惯同样塑造UML含义,UML 2引入的新习惯甚至与旧用法冲突。书中用标准的/规范的指严格符合标准,用习惯用法指标准之外但广泛使用的做法。 进一步展开见强制性规则与描述性规则。

UML有一条通用原则:图上任何信息都可以被收起(suppressed)不画出来,可以是全局性的(隐藏所有属性),也可以是局部性的(不展示某几个类)。这意味着读图不能因为没看到某个东西就反推它的取值——即使某元素有默认值(如多重性默认是1),看不到也可能只是被故意隐藏而非就是默认值。这条原则说明UML图天然允许不完整,完整性取决于作者出于沟通目的的取舍,读者需主动确认而非脑补。 进一步展开见UML图的信息收起原则。

UML能统一而非停留在方法战争,表面原因是Booch与Rumbaugh联手、Jacobson加入,但真正让OMG下场主导标准化的,是工具厂商的呼吁——他们担心标准被Rational一家控制、使其工具获得不公平优势,于是打着CASE工具互操作性的旗号推动OMG介入。方法学家以为自己声量最大,但商业相关方的诉求才是撬动标准化落地的真正力量,评估行业标准时应多看背后谁在买单获益。 进一步展开见UML标准化背后的真正推动力。

UML列不出你可能需要的所有图,若没有UML图符合需求,不该犹豫使用非UML图。决策表就是一例:用双线分隔条件与结果两部分,每一列表示一种条件组合导致的结果,面对复杂逻辑时比活动图更精练。屏幕流图是另一例:展示界面各屏幕及转换关系,虽无严格定义,却已被人们长期使用。原则很直接:图是否被UML收录不重要,管用就用、不管用就丢,参见好设计胜过合法UML。 进一步展开见UML之外的实用图。

对草稿和蓝图使用者来说,不必过分追求 UML 是否合法。宁可要一个用了非法 UML 的好设计,也不要合法却苍白的设计;精力应放在设计本身,而不是 UML 的细枝末节。例外是把 UML 当编程语言:那时图就是程序,不合法就跑不起来。发散:表示法是手段,评审时先问设计对不对,再问画得规不规范。参见强制性规则与描述性规则。 进一步展开见好设计胜过合法UML。

UML 规格详细定义了元模型,却没有正式规定一张图该对应哪种代码。看到一张类图,你说不出确切的等价代码,只能设想大概的样子;实践中这已够用,各团队会形成自己的本地习惯。发散:加入新团队时,先弄清他们画图的习惯,比如关联是否等于字段、属性是否代表 getter,否则容易误读。参见概念视角与软件视角。 进一步展开见图到代码没有正式映射。

没人能理解或用上 UML 的全部元素,连它的创造者也不能;大多数人只用一个小子集,关键是找到适合自己和同事的那部分。入门时先掌握基本形式的类图和序列图,它们最常用也最有用;之后再尝试高级类图表示法和其他图,没用的就丢掉。发散:团队约定一份“我们用的 UML 子集”,能减少读图分歧。参见表示法与元模型的区别。 进一步展开见先学类图和序列图。

形式方法用谓词演算等数学语言写规格,严密、没有歧义,但价值并不普适:即使能证明程序满足数学规格,也无法证明规格本身满足系统真正的需求。正因如此,大多数图形建模语言凭直觉定义也照样有用,UML 则用元模型在不牺牲好用性的前提下提高严谨性。发散:验证回答“做得对不对”,确认回答“做的是不是对的东西”,两者不能互相替代。参见表示法与元模型的区别。 进一步展开见形式规格证明不了需求。

同一张 UML 图可以从两种视角来读。软件视角下,图中元素相当直接地映射到软件元素,比如类对应代码里的类;概念视角下,图描述的是领域概念,是在建立谈论业务的词汇表,例如和会计一起澄清资产池术语。视角没有硬性规则,但不同视角会让人对同一张图的含义争论不休,所以读图、讨论前要先弄清对方的视角。发散:领域模型评审时,有人按代码读、有人按业务读,分歧往往就出在这里。参见UML的三种使用模式。 进一步展开见概念视角与软件视角。

把 UML 当编程语言面临两道门槛。一是工具是否成熟到能把模型可靠地编译成系统。二是更根本的:只有比现有文本编程语言显著提高生产率,图形编程才值得采用;从各种图形开发环境的使用经验看,这一点很难令人信服。即使真的更高效,还要有超过临界值的用户量才能成为主流,Smalltalk 就是先例:比主流语言更高效,却只成了小众语言。发散:新技术胜出要同时跨过效率和生态两道坎。参见MDA的代码生成链路。 进一步展开见UML当编程语言的门槛。

原书依据 · 26 处

开发过程

建模嵌在开发过程里才有用途。迭代围绕功能子集完成分析、实现和验证,自适应计划接受后续变化;草稿帮助探索责任,文档保存关键结构与取舍。过程与图都应裁剪到团队能够理解、维护和用于交付的范围。

瀑布和迭代的差别不在于是否敏捷,而在于用什么维度切分项目:瀑布按活动切分(需求、设计、编码、测试各自成段);迭代按功能子集切分,每个迭代内都完整走一遍分析-设计-编码-测试,结束时得到功能不全但可运行的系统。判断项目是否真迭代,看的不是术语,而是每次迭代结束是否真产出已测试、已集成、接近产品质量的软件——很多项目自称迭代,内部仍按活动分阶段推进(伪迭代)。 进一步展开见瀑布与迭代开发的本质区别。

预测性计划假设需求足够精确稳定,据此可定固定价格/固定范围合同;但多数软件项目会经历需求剧烈变动,需求一旦不稳定,预测性计划就建在流沙上。自适应计划承认可预测性多半是错觉,把变化当常态,用计划做基线评估变化而非预测未来,代价是无法承诺固定范围,只能固定价格/可变范围。经验法则:没有精确稳定需求前不做预测性计划,做不到就转向自适应计划;自适应计划必然要求迭代过程。 进一步展开见预测性计划与自适应计划。

敏捷不是某种具体方法(XP、Scrum、FDD等都算),而是共享敏捷宣言价值观的一族过程,共同假设是:项目成功最重要的因素是团队里人的素质及协作质量,过程和工具是次要因素。这个假设决定了敏捷的两个表现:高度自适应(拥抱预测性计划与自适应计划|需求变化而非假装可预测),以及用短的时间盒迭代快速获得反馈。理解这条假设,才能明白敏捷实践为什么长这样,而不是等同于没有文档、开发快。 进一步展开见敏捷过程的核心假设。

仪式(ceremony)指过程中大量的文档和控制点;注重仪式的过程被认为让变更更难、不受有才华的人欢迎,因此敏捷过程常被称为轻量的。但这里有个容易搞反的因果:缺少仪式是敏捷过程的核心假设|敏捷自适应且以人为本这一立场带来的结果,而非敏捷之所以是敏捷的原因本身。文档少只是表象,拥抱变化、信任人才是深层逻辑;只学表象削减文档而不理解逻辑,容易做出看似敏捷、实则失控的伪敏捷实践。 进一步展开见仪式与轻量过程的关系。

Rational统一过程(RUP)本质是一个过程框架而非单一固定过程,使用前需先选定适合项目的”开发案例”。所有RUP项目都遵循初始、细化、构造、移交四个阶段:初始阶段做项目初步估计、决定是否值得投入细化;细化阶段识别首要用例并迭代出系统架构雏形,结束时应已发现并解决主要风险;构造阶段继续迭代、开发出足够发布的功能;移交阶段处理部署、用户培训等不适合迭代的收尾活动。RUP本质是迭代过程,披着RUP外衣却按瀑布风格执行的项目并不少见。 进一步展开见RUP的四个阶段。

时间盒(time boxing)强制每个迭代拥有固定长度的时间;如果眼看做不完计划的功能,必须从本次迭代里删减功能,而不是延后迭代的截止日期。价值在于训练团队定期、主动地做”延迟哪些功能”的取舍——人天生难以主动砍功能,而反复的小规模取舍练习,能让团队在真正的大版本发布时更清醒地在”延期日期”和”砍功能”之间做出理性选择,同时暴露出真实的需求优先级排序,而不是把所有妥协都拖到项目末期一次性爆发。 进一步展开见时间盒。

迭代开发明确假设后续迭代会返工、删除已有代码;这在制造业是纯浪费,但软件里重写设计不良的代码往往比打补丁划算,前提是三项实践把返工成本压低:自动化回归测试(快速检测改动引入的缺陷)、重构(对代码做一系列小的、行为保留的变换,多可自动化)、持续集成(构建全自动、任何人签入都触发,配合回归测试快速捕获不一致)。三者共同把改动代价从事后大爆炸分摊成随时可承受的小成本。 进一步展开见支撑高效返工的三项工程实践。

UML只回答怎么画一个面向对象设计,模式(pattern)回答的是过程的结果:具体的例子设计,由发现重复设计主题的人总结出来供他人复用。一条合格的模式不只是画法,必须同时讲清楚问题是什么、为什么这样解决、在什么环境下管用什么环境下不管用——只有画法没有原因和适用边界不算模式。例如代理对象代替远程对象承担网络细节是常见模式,模式书籍真正传授的是这些经验,而不是怎么画代理的UML图。 进一步展开见模式的定义与本质。

详细文档应从代码本身生成(如JavaDoc),人写的附加文档不该追求覆盖全部细节,而应只强调最重要的概念,作为读者深入代码前的第一步。Ward Cunningham点出关键:精心挑选、编写良好的一小段备忘录,往往能替代面面俱到、实际只有零星几处真正有价值的设计文档,与其平均分配笔墨,不如提升关键点地位、忽略其余部分。这也解释了为什么好文档要用UML草稿而非蓝图。 进一步展开见精选备忘录优于详尽文档。

瀑布过程最大的问题是很难判断项目是否还在轨道上:早期阶段太容易宣布胜利,进度延误被藏了起来。真正能证明进度的只有已测试、已集成的软件;迭代开发不断重复产出它,偏差会更早暴露。因此不应采用纯瀑布,至少要用阶段交付:瀑布式做完分析和高层设计,再把编码和测试分成迭代。发散:文档完成率、设计评审通过都只是代理指标。参见瀑布与迭代开发的本质区别。 进一步展开见只有可运行软件证明进度。

系统种类、技术、团队规模和分布、风险性质、失败后果、团队风格与组织文化,都会改变软件开发的方式,所以不存在普适的过程。裁剪的做法是:先找出几个看起来接近适合的过程;对不熟悉的过程,先照原样做两三个迭代,弄懂它如何运作再改;从太小处开始再添加,比从太多处开始再删减更容易。发散:照搬一套完整流程,往往先得到的是仪式而不是效果。参见RUP的四个阶段。 进一步展开见过程必须裁剪。

需求分析可用用例、概念类图、活动图、状态图等技术,但最重要的是与用户和顾客沟通,而他们通常不懂 UML。因此要保持表示法最小化,不引入任何软件实现特有的东西;只要能沟通得更好,随时准备打破 UML 规则。最大的风险是画出领域专家看不懂的图:这种图比无用还糟,只会让对方不信任开发团队。发散:给业务方看的图,判断标准是对方能否指出其中的错误。参见UML的三种使用模式。 进一步展开见需求分析图要让领域专家看懂。

设计文档里最重要的一项内容,是没有采纳的设计备选方案以及没采纳的原因。这部分最容易被遗忘,却往往最有用:代码只能说明最终选了什么,说明不了为什么没选别的。缺了它,后来的维护者容易把已经否决过的方案再试一遍,或者把出于权衡的设计误当成随意之举。发散:架构决策记录的价值主要就在“考虑过但放弃的选项”这一栏。参见精选备忘录优于详尽文档。 进一步展开见文档要写未采纳的方案。

迭代开发的一大好处是支持频繁的过程改进。每个迭代末举行一次迭代回顾,迭代短的话两三个小时足够,列三栏:保持,做得好、要继续的;问题,做得不好的;尝试,打算做的过程改变。从第二次回顾起,先评审上次的条目看是否改变,并持续更新清单,否则会丢失项目感觉,错过潜在的致胜实践。项目末或大发布时,可做两三天的正式项目回顾。发散:组织不从经验中学习,就会反复犯昂贵的错误。参见过程必须裁剪。 进一步展开见迭代回顾列三栏。

蓝图和草稿在过程中的地位不同。按蓝图编码时,代码应遵循图,任何改动都是偏离,需要画蓝图的设计人员评审;草稿只是设计的第一刀,编码中发现它不对,开发者应能自如修改,只需判断改动是否大到要拉更多人讨论。探索备选方案时宜用草稿,便于快速生成和改动,选定方案后再用草稿或蓝图细化。即便好的设计人员,也很难一次把蓝图画对。发散:蓝图越详细,偏离评审越频繁,流程成本随之上升。参见UML的三种使用模式。 进一步展开见蓝图偏离须评审。

面对大量陌生代码,UML 草稿可以充当图形注解:画出包里的关键类和关键交互,边学边记录要点。现代工具能为系统关键部分生成详细的图,但不要拿它们输出大型纸质报表,而应在探索代码时用来深入关键区域。特别有用的是生成序列图,看复杂方法里多个对象如何协作。发散:工具生成的图是导航用的地图,不是存档用的文档。参见正向工程与逆向工程。 进一步展开见用工具图探索遗留代码。

原书依据 · 29 处

类图基础

类图描述对象类型及其静态关系。性质、多重性、关联和泛化共同表达可以存在哪些对象及约束;操作说明可被请求的行为,契约则说明调用双方的责任。类图无法单独说明所有运行过程,因此需要与后续行为图配合。

类图中的性质(property)代表类的结构特性,最初可粗略理解为字段,但同一个性质有两种表示法:属性把它写成类方框里的一行文本;关联把它画成两个类之间的一根线,名称和多重性标在目标端。两种画法信息大多相同,关联能额外展示多重性。选哪种更多是强调而非语义差异:小的值类型(日期、布尔)常用属性,重要的类之间关系常用关联,这样重要的类会以方框形式出现在图上,突出其地位。 进一步展开见性质的两种表示法:属性与关联。

多重性(multiplicity)指一个性质能被多少对象填充,用下限..上限表示,如1、0..1、*(即0..*简写)。下限0即可选,下限≥1即强制;上限1即单值,上限大于1即多值。多值性质默认无序、可能重复,需要有序时加{ordered}标注。属性默认多重性是[1],但图上没标出不能当作就是[1],因为多重性也可能被UML图的信息收起原则|故意收起。 进一步展开见多重性的记号与常用术语。

同一个UML性质在代码里至少有两种解释:聚焦实现的私有字段,或更面向接口的存取方法。用OrderLine的price举例,即使price是实时计算出的值而非存储字段,调用者也无法分辨背后是字段还是计算逻辑。这正是封装的本质:信息隐藏让外部只关心接口提供了什么,不关心内部怎么实现。多值性质对应集合,应通过add/remove方法维护,不直接暴露内部集合,避免调用方绕过控制篡改成员。 进一步展开见性质在代码中的字段与接口解释。

双向关联是一对相互链接的性质:Car有owner属性指向Person,Person有cars属性指向一组Car,跟随任意方向都应能回到起点集合。这种双向同步在代码里天然棘手,必须保证两个性质不脱节。实践中常让单值一侧(owner)作主控端,多值一侧(cars)作从属端;主控端设置器负责同步对方集合,从属端需向主控端暴露一个本不该公开的方法(常用friend命名标记),这是维护双向一致性的代价。 进一步展开见双向关联与主控从属设计。

操作(operation)和方法(method)常被混用,但严格来说不同:操作是对象上可调用的例程声明,方法是该例程的具体实现体。多态场景下差异会暴露——若超类型的getPrice操作被3个子类型分别覆盖,系统里只有1个操作,却对应4个实现(超类1个+子类3个)。讨论调用了什么说的是操作,讨论具体执行了哪段代码说的是方法,多态成立正是因为同一操作运行时能绑定到不同方法。 进一步展开见操作与方法的区别。

UML把不改变系统可观察状态、只取值的操作称为查询(query);把改变状态的操作称为修改器(modifier,也叫命令)。区分两者的价值:查询之间可任意调整执行顺序而不影响系统行为,给重构和推理代码留出空间。Meyer的命令-查询分离原则建议修改器不返回值,这样有返回值的操作就自动等于查询。获取/设置方法只是查询/修改器的具体实现,客户不该也不能从外部分辨查询是不是简单的获取方法。 进一步展开见查询与修改器和命令查询分离原则。

泛化把共性抽到超类型、差异放进子类型,如Customer拆出Personal与Corporate Customer。判断子类型是否合格的关键原则是可替换性(Liskov替换原则):用到Customer的代码换成Corporate Customer都应照常工作,调用者不需关心差异。继承是实现可替换性的常见手段,但带来不必要的包袱,因此有人区分子类型化(接口继承,只要求可替换)与子类化(实现继承)。 进一步展开见泛化与可替换性。

如果改变一个元素(供应者)的定义会迫使另一个元素(客户)跟着改变,二者之间就存在依赖。依赖是控制系统改动范围的核心工具:依赖失控会让一处改动产生大范围波动。表示层依赖领域层、子类依赖超类是典型单向依赖,反过来不成立,这种单向性使改动表示层不会波及领域对象。依赖默认不可传递(不像”胡子长度”那样能逐级推导),判断改动影响范围要看直接依赖而非假设传递。应尽量避免环状依赖,尤其是包之间的环。 进一步展开见依赖关系的方向性与非传递性。

类图中的关联、属性、泛化只能表达部分约束(如Order必须恰好属于一名Customer),更复杂的业务规则需用约束补充,写法是把内容放进花括号里。UML允许用自然语言、编程语言或形式化的对象约束语言OCL写约束,OCL基于谓词演算、能消除自然语言的含糊性,但也引入新风险:若作者和读者都不真正理解谓词演算,形式化表示法反而制造新误解。除非确定读者熟悉OCL,否则用自然语言写约束通常更安全。 进一步展开见类图中约束的表达方式。

按契约设计用断言(不应为假的布尔陈述,为假只因bug)精确划分接口责任,核心三种断言:前置条件(执行前世界应满足的条件,如求平方根要求input≥0)明确调用者的检查责任;后置条件(执行后世界应变成的样子,如input等于result乘result)说明操作承诺做什么而非怎么做;不变式(关于类本身任何时候都应为真的断言)约束实例状态一致性。三者共同把谁负责检查什么写清楚,避免漏检或重复检查。 进一步展开见按契约设计的三种断言。

继承的危险之一是子类重定义操作时可能和超类的承诺不一致,按契约设计的三种断言|契约限制子类能改什么来防止这种不一致:不变式和后置条件必须应用到所有子类,子类只能加强、不能减弱;前置条件则相反,只能减弱、不能加强。这个反直觉的规则背后是泛化与可替换性|可替换性原则——若子类加强了前置条件,超类操作按超类契约调用子类实例时就可能失败,破坏了动态绑定的基础。 进一步展开见契约在子类化中的强化与减弱规则。

如果一个类只有一堆字段和对应的存取器(getter/setter),没有任何实质行为,这是一个警示信号:面向对象设计的目标是提供能做丰富行为的对象,而不是把数据简单地交给别人处理。更具体的诊断方法是看调用方——如果某处代码反复调用一系列存取器来取数据,这本身就说明有一段行为被放错了地方,应该把这段逻辑挪到真正拥有这些数据的类里去,而不是让外部代码围着数据转。 进一步展开见存取器堆砌是行为错位的信号。

想在类图里画出全部依赖是吃力不讨好的:依赖太多,又变得太快。只在和当前沟通主题直接相关时选择性地画,真要理解和控制依赖,最好在包图层面做。依赖本来就能从代码里看出来,所以最有用的做法是用工具逆向工程生成依赖图。类之间画依赖,最常见的用途是表达瞬时关系,比如一个对象作为参数传给另一个对象。发散:人画的依赖图会过时,工具生成的才可信。参见依赖关系的方向性与非传递性。 进一步展开见依赖图交给工具生成。

概念类图用来探索业务语言,画法和软件类图不同:不画导航性箭头,因为导航性在概念层面不重要;操作不用来详述接口,只用几个词点出类的首要责任,类似 CRC 卡上的责任;整体要把软件排除在讨论之外,保持表示法非常简单。发散:和业务人员一起画图时,一旦出现可见性、类型、方法签名,讨论就会滑向实现。参见概念视角与软件视角、需求分析图要让领域专家看懂。 进一步展开见概念模型不画实现细节。

类图内容太丰富,容易被过度使用。先只用类、关联、属性、泛化和约束这些简单构造,需要时再引入进阶表示法;不要为每样东西都画模型,而要集中于关键区域,少量常用且保持更新的图,胜过一堆被遗忘的过时模型。类图最大的危险是只盯结构、忽略行为,所以理解软件时要配合某种行为技术,在各种技术间频繁切换。发散:类图画得越全,越容易被当成设计已经完成。参见性质的两种表示法:属性与关联。 进一步展开见类图不要贪全。

原书依据 · 36 处

序列图

序列图把一个场景中不同参与者的消息按时间展开,用来检查职责究竟落到谁身上。调用、返回、创建和删除都为协作提供线索,但过多控制逻辑会遮蔽消息关系;复杂分支应选择更合适的表达。

同一个计算场景可以用两种序列图风格实现:中央控制让一个参与者负责所有处理,其余参与者只提供数据,是对象新手更习惯的方式;分布控制把计算拆给多个参与者各自完成一小块,理解时要追着对象绕圈,却更符合面向对象设计第一原则——把数据和使用数据的行为放在一起,改变的影响因此被局部化,也为用多态替代条件逻辑创造插入点。真正适应分布控制往往需要在强制这样做的OO环境里工作一段时间才能想通。 进一步展开见中央控制与分布控制两种协作风格。

在UML 1中,交互图上的角色本质就是对象,因此按惯例名字带下画线;但UML 2把这个角色的语义扩展得复杂得多,不再等同于对象,官方规格里也没有一个正式术语来指称它。因此可用参与者(participant)这个非官方术语统称交互图里的这个角色,并相应地去掉了下画线。理解这个术语的价值在于:读到UML 2序列图时不能想当然地把每个生命线都当作一个对象实例,它的语义边界比UML 1时代更宽。 进一步展开见UML2交互图中的参与者术语。

序列图不擅长展示循环和条件这类控制结构,最好留给活动图或代码本身,序列图应被当作对象如何交互的可视化,而非建模控制逻辑的工具。UML 2提供交互框(interaction frame)作补充:框把图的一部分圈起来标注操作符,loop配合警戒条件表示循环,alt给多个片断分别标警戒条件表示多选一分支,只有一个区域时用opt。交互框容易让图的要点变模糊,伪消息技巧往往更清楚。 进一步展开见交互框表达循环与条件。

UML 1的迭代标记(消息名加*号)和警戒条件(方括号条件)已从UML 2序列图移除,但有缺陷:警戒条件无法表示互斥条件集合,且只对单条消息管用,同一块内多条消息从同一激活发出就不够用。流行的非官方做法是伪消息(pseudomessage)——把循环或条件写在自调用表示法变体上,不画消息箭头以提示非真实调用,必要时给激活条加阴影,这是比官方交互框表达循环与条件|交互框更受偏好的惯例。 进一步展开见伪消息表达循环与条件。

同步消息要求调用者原地等待直到消息处理完成,等同于调用子程序;异步消息发出后调用者可立即做其他事,不必等待响应,常见于多线程和消息中间件,带来更好响应性、减少瞬时耦合,代价是更难调试。UML 2用实心箭头表示同步、条形箭头表示异步,但差异过于细微,且与UML 1.4之前用半箭箭头表示异步的老习惯不兼容。读图时宜默认箭头是同步的,除非确认作者刻意区分;要强调异步宁可用已废弃但更醒目的半箭箭头。 进一步展开见同步消息与异步消息的语义区别。

序列图适合查看单个用例内若干对象之间的协作行为,擅长把参与者之间的调用关系讲清楚,但不擅长精确定义算法细节(循环、条件)。需要查看跨越多个用例的单个对象行为时改用状态图;需要查看跨越多个用例或线程的行为时改用活动图;需要快速探索多种多选一的交互方案又想避免反复画图擦图时,用CRC卡先做探索性讨论,再用序列图把选定交互记录下来备查。选图的关键是当前要回答的问题落在哪个维度。 进一步展开见何时使用序列图与其他图的分工。

CRC(Class-Responsibility-Collaboration)卡由Ward Cunningham发明,虽不属于UML,却是把注意力从数据转向行为的高效交互探索方法:拿卡片代表类,围坐讨论场景,把活跃卡片举起来演绎消息如何在对象间传递。核心是责任(responsibility)——用一句话概括对象该做的某件事;以及协作者(collaborator)——记录这个类需要和哪些类一起工作。 进一步展开见CRC卡与责任和协作者。

CRC卡最大的好处是能快速考虑设计的备选方案:用序列图这类正式交互图探讨备选实现会很慢,每种方案都要花时间重新绘制和擦除;拿起卡片挪动位置就能建模一次交互、马上尝试下一种方案,讨论节奏因此快得多。实践顺序是先用CRC卡做探索性讨论定下方向,再用中央控制与分布控制两种协作风格|序列图把最终选定、值得日后查阅的交互记录下来——CRC卡负责快速发散,序列图负责精确留档,两者互补。 进一步展开见CRC卡相对序列图的核心价值。

序列图里的可选元素,画不画要看它是否增加信息。激活条对应参与者栈上的方法调用,对澄清行为很有价值,但在白板上探索设计时可以省略(难画),简单的分发调用也可去掉。返回箭头则只在能提供额外信息时才画,例如 getProduct 返回 aProduct;给每个调用都画返回,只会把图弄乱。发散:图上每多一笔都在消耗读者注意力。参见UML的三种使用模式。 进一步展开见返回箭头只在有用时画。

CRC 卡上的每条责任都应是一句短句。常见错误是写出一长串低级别责任,这就迷失了目标,因为责任应该能轻松写进一张卡片。遇到这种情况要问两个问题:这个类是否该拆分?这些责任能否上滚成更高层的陈述?发散:一句话说不清一个类做什么,通常是职责太散。参见CRC卡与责任和协作者。 进一步展开见责任清单过长要拆类。

序列图可以表达参与者的生命周期:把消息箭头直接画进参与者方框表示创建,通常标为 new;用大的 × 表示删除,箭头指向 × 是被别人删除,生命线末端的 × 是删除自身。在有垃圾回收的环境里不会直接删除对象,但仍值得画 ×,表示对象已不再需要、可以回收;关闭操作后也适合加 ×,表明对象不可再用。发散:× 表达的是设计意图,而不是内存操作。参见何时使用序列图与其他图的分工。 进一步展开见创建与删除参与者。

原书依据 · 20 处

类图进阶

进阶类图进一步区分所有权、相等性、接口与分类等语义。聚合表示法较弱,组合的排他所有权更明确;只读限制访问,冻结限制生命周期中的变化。相似图符不能代替对约束的准确说明。

记住符号含义是图形语言的负担,UML应对策略是尽量不新增符号,而是复用已有符号加关键词标注差异——接口就是用«interface»标注的类图标。UML1里双尖括号主要指构造型(stereotype),许多人因此把关键词和构造型混为一谈,但UML2已严格区分二者。构造型是扩展机制(profile)的组成部分,用一组相关构造型为特定目的扩展UML,日常使用不需要懂元模型细节。 进一步展开见关键词与构造型。

UML把应用于类本身、而非应用于类的每个实例的操作或属性称为静态的(static),概念上等同于基于C的语言里的静态成员——调用它不需要先创建一个实例。类图上用下画线标记静态特性,和非静态(实例级)特性区分开。这个区分对应到代码里就是”这个方法/字段属于类,还是属于某个具体对象”的判断,是理解类图时最基础但容易被忽略的一条读图规则。 进一步展开见静态操作和属性。

聚合(aggregation)口头上是”……的一部分”的关系,但UML里几乎没有严格语义——不同建模者对它的理解从来不一致,Jim Rumbaugh干脆称它为”建模安慰剂”,宜直接在图中忽略聚合,看到别人图里的聚合要挖得更深才能确认含义。组合(composition)则有明确规则:”无分享”:任何实例只能有唯一的拥有者,即便一个类可以是多个类的潜在组件类型,具体到某个实例也只能被一个对象拥有;拥有者被删除时,它拥有的组件也应级联删除。组合适合表达按值拥有、值对象或强排他所有权的关系。 进一步展开见聚合与组合的语义差异。

派生性质(derived property)是可以从其他值算出来的性质,例如日期范围里的天数可由开始日期和结束日期算出。对派生的常见解释是区分存储值和计算值,这种解释暴露了过多内部实现细节。更好的解释是:派生标记的是几个值之间存在的一种约束关系,具体选哪个值标记为派生其实是随意的,它的作用只是提醒读者这几个值互相牵制,这个理解方式对概念图同样适用。 进一步展开见派生性质的两种解释。

抽象类(abstract class)不能被直接实例化,只能实例化其子类;通常带抽象操作(abstract operation)——只有声明没有实现体。接口是所有特性都抽象的类,用«interface»标注。类和接口有两种关系:类可替换接口使用即供给(provides)该接口(Java/.NET靠实现接口,C++靠继承接口类);类需要接口实例才能工作即需要(requires)该接口,本质是依赖它。 进一步展开见抽象类接口与供给需求关系。

以Order用List接口而非直接用ArrayList为例:Order依赖List接口、只用equals/add/get几个方法,实际连接对象是ArrayList实例,但Order无需知道这点。好处是换实现更容易——换成性能更好的List实现,不改Order任何逻辑代码,因lineItems类型声明是List而非ArrayList,只需改创建时那行初始化代码,这正是对接口而非实现编程原则的体现。 进一步展开见面向接口编程的实践理由。

{readOnly}标记性质只能被客户读取、不能被客户更新,但内部或其他机制仍可能改变它;{frozen}(来自UML 1、UML 2已删除但仍很有用)标记的性质在对象整个生命期内都不能改变,通常称为不可变。二者容易混淆但语义层级不同:{readOnly}限制谁能改,{frozen}限制任何时候都不能改。{frozen}既可标记单个性质,也可标记整个类,表示所有实例的所有性质都冻结。 进一步展开见只读与冻结的区别。

对象是否需要靠标识判断相不相同,取决于它是引用对象还是值对象。引用对象(如Customer)标识很重要:现实里一名顾客通常只对应一个软件对象,所有引用它的地方引用同一个实例,判断两个引用是否指向同一顾客要比较标识,副本应尽量避免、出现副本要想办法同步。值对象(如Date)标识不重要:可同时存在成百上千个都代表1月1日的对象,它们是可互换的副本,判断两个值对象是否相同要比较它们代表的值而非标识。 进一步展开见引用对象与值对象的标识差异。

值对象应该是不可变的:不能把代表1月1日的对象直接改成代表1月2日,而应创建一个新对象替换它。规则根源是走样(aliasing)问题——若值对象被多处共享,一处原地修改它的值,会在开发者没预期的地方悄悄改变别处看到的值。UML用数据类型(data type)关键词标注类型系统内建值类型,但数据类型和值对象不完全等同:数据类型不能有标识,值对象可以有标识,Date是值对象但不是原生数据类型。 进一步展开见值对象的不可变性与走样问题。

限定关联(qualified association)是UML对数组、字典这类用键取值概念的对应物:限定符表示Order上下文里每个Product实例最多对应一个Order Line。最容易搞混的是多重性含义——标的不是Order有多少Line Item,而是限定符上下文里的多重性:0..1表示最多一条,1表示必须一条,*表示可有多条但需按Product索引访问。 进一步展开见限定关联的语义。

把子类型化理解为是一个(is a)关系容易踩坑,背后混杂两种关系:分类(对象是某类型的实例,如Shep是一只博德牧羊犬)和泛化(类型是另一类型的子类型,如博德牧羊犬是一种犬)。泛化有传递性,可推到Shep是一只动物;分类不具传递性,博德牧羊犬是一个品种和犬是一个物种不能像泛化那样结合传递。先分类后接泛化成立,反过来不成立,混淆会误用子类型化。 进一步展开见分类与泛化的是一个关系陷阱。

主流编程语言默认对象只属单个类(单个分类),可沿继承链找超类型;UML还支持多重分类:对象可同时具备多个未必通过继承相连的类型,如一个人可同时是女性、医生、病人,不需为每种合法组合预先定义具体类型。多重分类不同于多重继承:多重继承说类型可有多个超类型,但对象仍须归属单一类型;多重分类允许对象跨多个类型,不要求先定义组合类型。 进一步展开见单重分类与多重分类。

UML 2用泛化集(generalization set)管理多重分类中哪些类型组合合法:把相关泛化关系分到同一个命名泛化集里,同一泛化集内的子类型默认互斥——超类型的一个实例只能属于该集合里的一个子类型;分属不同泛化集(如性别集和角色集)才能自由组合。单个分类对应于单个不命名的泛化集,是多重分类机制的特例而非另一套规则。 进一步展开见泛化集管理多重分类的合法组合。

对象能否在运行期改变自己的类型归属,是单重分类与多重分类|分类之外的另一个独立问题:动态分类(dynamic classification)允许对象在子类型化结构内改类,典型例子是银行账户透支后行为整体改变;静态分类(static classification)不允许换类,类型和状态被严格分开。多重、动态分类对概念建模有用,但软件实现落差太大,多数UML图应默认用单重、静态分类。 进一步展开见动态分类与静态分类。

关联类(association class)给一个关联本身添加属性和操作,例如给人参加会议这条关联加上专注程度属性,同时约束任意两个参与对象之间只能有一个关联类实例。推荐的实现方式是把关联类当作完整的类实现,但只对外暴露获取信息的方法,并在每个创建该关联类实例的方法里显式检查这对参与对象是否已存在实例,以强制执行每对只能有一个的约束——这个约束不会自动生效,需代码主动维护。 进一步展开见关联类的定义与实现建议。

判断要不要把关联提升为独立的类,关键看现实语义是否允许同一对参与者之间存在多个关联实例:若一家公司可在同一合同里扮演多个角色,角色该建模成完整的类而非关联类的定义与实现建议|关联类,因关联类约束每对参与对象只能有一个实例;反之若一个人对同一技能只该有一条能力记录,用关联类天然表达了这个约束。对需保留历史的关系,更宜用非标准的«temporal»关键词标注关联,而非强行造额外的类。 进一步展开见何时把关联提升为完整的类。

一些语言(最著名C++,Java和C#后来也引入)支持参数化类,也叫模板:先定义带类型参数占位符(T)的通用模板(Set),再用具体类型派生,得到Set这样的类。UML用«bind»标注派生关系,意味着派生类遵从模板接口,可当作模板子类型。与普通子类型化不同,派生不允许给绑定元素添加新特性;需要加特性须另外创建真正的子类型。 进一步展开见模板参数化类。

主动类(active class)的每个实例自带并控制自己的一条独立控制线程,方法调用既可能在调用者线程里执行,也可能在主动对象自己的线程里执行——典型例子是命令处理器:从外部接收命令对象,在自己线程内部逐个执行,而非在调用者线程里同步跑完。UML 2用两侧带竖线的类框表示主动类(UML 1用粗边框,称主动对象),这个概念用来在类图层面标记涉及独立执行线程,帮助读图者提前识别并发相关的类。 进一步展开见主动类。

UML提供4个可见性缩写:+(公开)、-(私有)、~(包)、#(保护),公开元素可被任何其他类使用,私有元素只能被拥有它的类使用。这套记号看似简单,实际含义并不统一:多种语言都用public、private、protected这类术语,但同一词在不同语言里对应的访问规则不完全相同,UML只在元模型层面定义这4个级别,解释权交给使用的语言。读UML图可见性标记时,须先弄清按哪种语言规则标的。 进一步展开见可见性的跨语言差异。

枚举表示一组固定的值,这些值除了符号本身没有其他任何性质,在 UML 中画成带 «enumeration» 关键词的类。发散:正因为枚举值只有符号,若某个取值将来需要携带数据或行为,就该考虑改用类,而不是继续扩充枚举。参见关键词与构造型。 进一步展开见枚举是固定集合。

原书依据 · 49 处

对象图

对象图用某一时刻的具体对象连接说明抽象类图。它实际上可以是部分定义的实例规格,适合用具体例子检验多重性与关联,而不是试图描述整个系统在所有时间的状态。

对象图(object diagram)是系统在某个时间点上对象配置的快照,展示实例而非类,也常被称为实例图,可看作没有消息的通信图。它的价值在于:有些结构用类图能精确定义,实际对象连接方式依然复杂到难以直接理解——这时画出具体的实例配置快照,比抽象的类关系图更容易让人看懂对象之间怎么连起来。类图回答「允许什么样的连接」,对象图回答「某一时刻实际连成了什么样子」,两者互补。 进一步展开见对象图的定义与适用场景。

对象图中的实例元素用下画线区分于类元素,命名形式是「实例名 : 类名」,两部分都是可选的:可以只写实例名(如John),可以只写类名但必须保留冒号(如:Person),也可以两者都写(如aPerson : Person)。这个语法看似只是记号细节,但它解释了一个常见的读图疑惑——为什么有些对象图上的名字前面有冒号却没有具体实例名:那是作者选择只强调这是哪个类的一个实例,而不关心具体是哪一个。 进一步展开见对象图的实例命名语法。

严格来说,对象图上画的元素并不是真正的对象实例,而是实例规格(instance specification)——可理解为部分定义的实例。这个区分重要,是因为对象图允许一些真实运行时对象不可能出现的情况:强制属性可以留空不填,或可画出一个抽象类的实例规格(现实中抽象类不能被实例化)。对象图本质是一种建模/沟通工具,享有比真实运行时对象更大的自由度,不能拿运行时规则反推对象图一定合法。 进一步展开见实例规格不是真正的实例。

原书依据 · 4 处

包图

包把元素组织为命名空间,并把大量类依赖提升成较易理解的全局结构。可见性与门面收窄对外接口,按变化原因和复用关系分组减少无关耦合。包是编译期组织,不能直接当作运行时部署单元。

包(package)是UML的通用分组构造,可把UML元素组织成更高层级单元,最常见用法是组织类,但不限于类。模型里每个类是单个包的成员,包又可嵌套成子包形成层级结构,对应Java的包、C++/.NET的命名空间。每个包是命名空间,同一包内类名须唯一;要指出重名类是哪一个,用完全限定名称——包名间用双冒号连接,如System::Date和Util::Date可以是两个不同的Date类。 进一步展开见包的定义与完全限定名称。

包中的类可以是公有的(属于包接口一部分,能被其他包使用)或私有的(对外隐藏),具体规则跟随所用编程环境习惯,即使这意味着不完全符合UML规范。一个有用的收窄接口技巧是:把包内所有类默认设为私有,只能被同包其他类看到,再添加几个公有的门面(Facade)类对外暴露公开行为,内部把操作委托给不对外暴露的私有类。这样整个包对外只露出一个很小、很稳定的表面,内部实现细节可自由重构而不影响外部调用者。 进一步展开见门面模式收窄包接口。

决定哪些类该放进同一个包,是一个需要设计技巧的复杂问题,两条常被引用的原则给出了方向:共同封闭原则主张包中的类应该因为相似的原因而一起改变,同一类需求变动总是牵连的类就该在同一个包里;共同复用原则主张包中的类应该被一起复用,引用方总是要么都用到、要么都不用的类就不该拆进不同的包。这两条原则的共同出发点都不是外观相似度,而是实际的变更和复用模式,把类的分组决策和依赖管理绑在了一起。 进一步展开见共同封闭原则与共同复用原则。

包图(package diagram)展示包和包之间的依赖:如果表示包中的类依赖领域包中的类,就说表示包依赖领域包——包之间的依赖,本质上是对它们各自包含内容之间依赖关系的一种概括、压缩后的整体表达。这条规则让包图具有实用价值:在中大型系统里,画一张包图是控制系统大规模结构最有价值的手段之一,理想情况下这张图应该直接从代码基生成,这样看到的才是系统真实的依赖状况,而不是设计者一厢情愿的期望结构。 进一步展开见包图定义与依赖的概括关系。

一个包被越多其他包依赖,接口就需要越稳定,因为接口的改动会波及所有依赖它的包,这就是稳定依赖原则。与之配套的稳定抽象原则观察到:真正稳定的包往往有更高比例的接口和抽象类,因为抽象比具体实现更经得起变化。依赖流和环的控制见依赖流要清晰。 进一步展开见稳定依赖原则与稳定抽象原则。

同一张包图能看出两种交叉的组织视角:应用的分层结构(表现层、领域层、数据映射器层、数据库层)和业务的主题区域结构(如租赁、资产)。分离画成两张图更清晰,但分离后每个部分并不是真正的UML包,因为不能把一个类同时分配给层和主题区域两个包,要落到具体的包须从两个维度里各选一个(如租赁·领域层)。这类图虽不是标准UML的一部分,但解释复杂应用结构时很有帮助,对应的正是编程语言里层级命名空间的老问题。 进一步展开见包的分层结构与主题区域结构。

把接口和实现放进不同的包很常见,常见形态是客户包定义接口、另一个包提供实现。典型场景:UI控件要和加热器、灯这类不同的东西协作,需要调用对方方法,却不希望依赖具体的加热器类——解法是在控件包里定义一个接口,由想接入的类自己实现该接口,把依赖方向反过来,控件包不再依赖具体实现包。这正是分离接口模式的体现,也是前面讲过的抽象类接口与供给需求关系|需要接口在包这个更大粒度上的应用。 进一步展开见接口与实现分离到不同包。

好的包结构有清晰的依赖流:所有依赖朝同一个方向运行,这是系统结构良好的标志。数据映射器包是常见例外,它作为领域和数据库之间的隔离层。无环依赖原则不必当作绝对规则,但环应局限在小范围内,绝不能跨层。被依赖越多的包为何要越稳定,见稳定依赖原则与稳定抽象原则。发散:这是类级依赖控制在包这一更大粒度上的体现。参见依赖关系的方向性与非传递性。 进一步展开见依赖流要清晰。

原书依据 · 20 处

部署图

部署图回答软件实体运行在哪里:节点代表设备或执行环境,工件代表可发布的物理文件,通信路径连接运行地点。它与包图的逻辑依赖属于不同视角,部署数量变化并不等于领域结构改变。

部署图展示系统的物理布局,揭示哪个软件运行在哪个硬件上,图上主要元素是由通信路径连接的节点(node)——能承载软件运行的环境。节点分两种:设备(device)是硬件本身,可以是一整台计算机,也可以是更简单的硬件部件;执行环境(execution environment)是软件形态的承载体,本身是软件、或包含其他软件,例如操作系统或容器进程。这个二分帮助分清节点是真实机器还是运行其上的软件层。 进一步展开见节点的两种形式:设备与执行环境。

工件(artifact)是节点上承载的东西,代表软件的物理显现,通常是一个具体文件——可以是可执行文件(如.exe、二进制、DLL、JAR、程序集或脚本),也可以是数据文件、配置文件、HTML文档等。把某个工件列在某个节点之内,表达的语义是:运行时系统中这个工件被部署到了该节点上。工件常是某个组件的实现,需要强调时可在工件框上加标记值说明。节点间的通信路径也可加标签,注明所用通信协议。 进一步展开见工件是软件的物理显现。

原书依据 · 3 处

用例

用例围绕执行者目标组织成功、失败和变体场景,最有价值的是表达意图的文本。执行者是角色而非固定的人;包含关系可简化复用步骤,但按目标组织不应退化成无限的功能分解。

场景(scenario)是描述用户和系统交互的一串步骤序列,例如购买产品成功、信用卡授权失败、老顾客免填配送信息,都是同一购物流程下的不同场景。它们看起来不同,本质却相似:用户在所有场景里追求同一目标——购买产品,只是路径和结果不同。这个共同目标正是用例的定义核心:用例(use case)是被同一用户目标绑在一起的一组场景集合,不是单一路径的流程图,而是为实现这个目标可能发生的所有故事的合集。 进一步展开见场景与用例的关系。

执行者(actor)是用户扮演的、和系统相关的角色,而不是具体的某个人;一个人可以在不同场合扮演不同执行者(如销售经理临时顶替客服),多个人也可共同扮演同一个执行者,执行者甚至不必是人——若系统要为另一个计算机系统提供服务,那个系统本身就是执行者。执行者和用例是多对多关系:一个执行者可执行许多用例,一个用例也可能被若干执行者执行。actor(执行者)一词源自瑞典语误译,用角色理解会更准确。 进一步展开见执行者的定义与特点。

令人惊讶的是,UML对用例的定义相当简略:它只标准化了用例图(展示用例之间的相互关系),却几乎没有规定应该如何书写用例的内容,而用例几乎全部的价值恰恰在于内容而非图。这意味着理解和实践用例时,不应该把精力优先花在画出一张漂亮的用例图上,用例图更像是用例集内容的图形目录,起到类似结构化方法里上下文图的作用——展示系统边界和外部世界的交互轮廓,真正承载分析价值的是用例的文本描述本身。 进一步展开见用例价值在文本不在图。

书写用例内容常用的结构是:先从多个场景里挑一个当作主成功场景(main success scenario),写成编号的步骤序列;再把其余场景写成扩展(extension),每条扩展先指出在主成功场景的哪一步、什么条件下会岔开,再给出这条岔路自己的编号步骤。扩展路径可以继续往下扩展,直到用户达成目标(如步骤3a),也可以走向失败(如步骤6a)。这个结构还是头脑风暴主成功场景备选情况的好办法:对每一步都问”这里可能有什么不同”“哪里可能出错”,建议先穷举所有扩展条件、暂不管后续细节,减少后期返工。 进一步展开见主成功场景与扩展的结构。

用例中若某个步骤本身很复杂,或这个步骤在多个用例里重复出现,可以把它抽成另一个独立用例,原用例则包含(includes)这个被抽出的用例;常见文本表达方式是给被包含用例名字加下画线做成超链接。这个机制适合收拾弄乱主场景的复杂步骤和多处重复的步骤,但不要把包含关系当成功能分解的工具,试图把用例逐层拆成子用例、子子用例——这种机械分解只会浪费大量时间,偏离用例本该聚焦叙事的初衷。 进一步展开见用例的包含关系与反对功能分解。

用例除主成功场景和扩展外,还可附加三类共同信息:前置条件描述系统允许用例开始前应确保为真的东西,用处是告诉程序员不必在代码里重复检查这些条件;保证描述用例结束时系统会确保的东西,成功场景结束后是成功保证,任何场景结束后至少是最小保证;触发器规定触发用例开始的具体事件。添加这些元素要谨慎,少比多好,用例应保持简短易读,过长反而不好读,违背用例本身的目的。 进一步展开见用例的前置条件、保证与触发器。

UML用例图除了简单的包含关系外,还定义了包括«extend»在内的其他用例间关系,但宜直接忽略它们——见过太多团队在该用哪种用例关系上反复纠结,白白耗费精力,却没换来叙事质量提升。这个建议背后的判断标准和用例价值在文本不在图是同一套逻辑:用例图的作用只是给用例集提供一份图形目录,展示执行者、用例及包含关系,真正该投入精力打磨的是用例的文本描述,而非让关系分类学吞掉设计时间。 进一步展开见用例图应忽略extend关系。

用例可以按颗粒度分成三个级别(借用Cockburn的术语):海平面级别(sea-level)是核心用例,代表主执行者与系统之间一次独立、能交付对主执行者有价值成果的交互,通常耗时几分钟到半小时,大多数用例都应该写在这一级;被海平面级别用例包含的下层用例是鱼级别(fish level);比海平面更高、展示海平面用例如何服务于更广业务交互的是风筝级别(kite-level),通常对应业务用例,而海平面和鱼级别通常对应系统用例。级别越高,看到的是业务如何响应事件;级别越低,看到的是用户和软件的具体交互。只盯着人机交互时也要记得,有时改变业务流程才是解决问题的最佳途径。 进一步展开见用例的三个级别。

用例和特性(敏捷/极限编程里也叫用户故事)虽都在描述需求,目的却不同:特性是把系统按可交付小块堆砌起来的单位,方便每个迭代交付一批特性;用例提供的是执行者如何使用系统的完整叙事。很多人发现更有效的顺序是先写用例,再从中生成特性列表——一个特性可能对应整个用例、用例里的某个场景、某个步骤,或某种用例叙事体现不出来的行为变体。整体上特性粒度通常比用例更细,两者是互补而非二选一的关系。 进一步展开见用例与特性(故事)的关系。

用例描述的是系统的外部视图:执行者想达成什么目标、与系统怎样交互。因此不要期望用例和系统内部的类有任何对应关系,一个用例可能牵动许多类,一个类也可能服务许多用例。发散:想看用例背后对象如何协作,可另用序列图或 CRC 卡推演;用“一个用例一个控制器类”去机械映射,会把需求结构硬套成代码结构。参见主成功场景与扩展的结构、何时使用序列图与其他图的分工。 进一步展开见用例不对应内部类。

附加信息的取舍见用例的前置条件、保证与触发器。细节多少取决于风险:早期只细化少数关键用例,其余到实现前再充实;不必全写下来,口头沟通往往更高效。最大的危险是把用例写得太复杂而卡住,通常每个用例一两页正好。发散:没人读的详尽用例,价值不如一页能引出讨论的草稿。参见用例价值在文本不在图。 进一步展开见用例细节随风险增减。

用例里的每一步都是执行者与系统之间的一次交互,应写成一句简单陈述,清楚表明谁在执行。步骤要写执行者的意图,而不是具体怎么操作,所以用例里不描述用户界面;事实上,用例通常在界面设计之前就写好了。发散:写成“点击提交按钮”的步骤,界面一改就得重写,写成“提交订单”的步骤却能一直有效。参见主成功场景与扩展的结构、用例不对应内部类。 进一步展开见用例步骤写意图。

原书依据 · 19 处

状态机图

状态机图关注一个对象在不同状态下如何响应事件。事件、守卫和动作决定迁移,内部活动与离开后重入有不同效果;超状态共享行为,正交区域拆开独立维度。仅对行为随状态明显变化的对象使用,才能让图保持有用。

状态机图里,同一状态在同一事件上可以画出多条向外转换,但事件真发生时只能执行其中一条——这要求转换的警戒条件必须互斥,不能同时为真,否则该走哪条路径没有定义。反过来,若某事件发生时没有任何转换的触发器-警戒条件组合与它匹配,这个事件就被直接忽略,不报错也没有任何行为。理解这条规则的价值在于:审查状态图时要主动检查同一事件的多条转换是否真的互斥,这是最容易被忽略却最容易引发运行时歧义的设计漏洞。 进一步展开见警戒条件互斥与无效事件被忽略。

开发人员日常讨论对象状态时,往往指对象所有字段数据的组合,是具体、细粒度的理解;但状态机图里的状态是更抽象的概念——不同状态代表对象对外部事件的不同反应方式,而非内部数据的具体取值组合。同一批字段值哪怕完全不同,只要对象对下一个事件的反应规则相同,在状态机图上就属于同一个状态;反过来字段值相近但反应规则不同,就该建模成不同状态。抓住这个抽象层次的区别,才能判断属性变化该不该体现在状态机图上。 进一步展开见状态是抽象的反应模式。

内部活动(internal activity)是状态在不发生转换的情况下响应事件的方式,写法是把事件、警戒条件、活动直接放进状态框内部。它和自转换(self-transition,转回同一状态的转换)效果相似,但有关键区别:自转换会触发状态的入口活动与出口活动|入口活动和出口活动,内部活动不会触发。这个触发与否的差异,才是判断该用内部活动还是自转换的关键依据,而非表面上看起来一样。 进一步展开见内部活动与自转换的区别。

入口活动(entry activity)是无论从哪里进入某个状态都要执行的动作,出口活动(exit activity)是无论从某个状态离开到哪里都要执行的动作,两者都绑定在状态本身而非某条具体转换上。它们的价值在于消除重复:如果一个状态有多条进入路径都需要做同一件事,与其在每条转换上重复写这个动作,不如把它定义成这个状态的入口活动,一次定义、所有进入路径自动生效,出口活动同理。 进一步展开见入口活动与出口活动。

常规活动(UML 1称为动作,action)与do-活动都代表执行行为,关键差异在时间特性:常规活动突如其来发生,一旦触发不能被打断;do-活动有持续时间跨度,标记为do/,执行期间可被事件中断(如搜索状态完成前被cancel打断,转回上一状态)。突如其来的时长因系统而异:硬实时系统可能是几条机器指令的时间,桌面软件可能是几秒——是相对该系统事件响应粒度足够短、可当作瞬间发生的动作。 进一步展开见do活动与常规活动的区别。

当若干状态共享相同的转换或内部活动时(如一组子状态都要响应同一个cancel事件跳出),与其在每个子状态重复画一遍,不如把它们嵌套进一个超状态,把共享的转换或活动画在超状态层级一次,所有子状态自动继承。这不只是省画图的功夫:它把这组状态共同响应哪些事件的设计意图显式表达出来,读图者能一眼看出哪些行为是整组共有的、哪些是某个子状态独有的,不必逐个比对转换列表才能发现规律。 进一步展开见超状态收纳共享行为。

当一个对象的状态实际由几个互不相关的维度共同决定时(如闹钟同时有CD/收音机选择和当前/闹钟时间显示两个独立维度),把它们塞进一张状态图会迅速变得混乱、难以随状态数增长而维护。解法是把这些正交的维度拆成各自独立、并发运行的状态图区域,分开画反而清晰得多——这是应对状态组合爆炸的核心手段。 进一步展开见并发正交状态。

历史伪状态(history pseudostate)解决的问题是:当一个正交区域重新被进入时(如闹钟重新开机),该恢复到离开前的状态还是回到默认状态。历史伪状态箭头指向的就是没有历史记录时应该进入的默认状态;一旦这个区域曾被进入过,再次进入时则会恢复到上次离开时所在的具体状态,而不是每次都从默认状态重新开始。 进一步展开见历史伪状态。

状态图最擅长描述一个对象跨越多个用例的完整生命期行为——同一对象在不同用例场景下如何随事件切换反应模式,这是它的独特价值;但状态图不擅长描述多个对象协作产生的行为,这种场景应换成交互图(专长单个用例内若干对象协作)或活动图(专长跨对象、跨用例的通用活动序列)。使用状态图时也不该给每个类都画一张:只对确实呈现有趣、值得梳理的状态行为的类使用它(常见的是UI和控制类对象),强行配一张只会白白耗费精力。 进一步展开见何时使用状态图。

转换(transition)表示从一个状态到另一个状态的转移,它的标签由三部分组成:trigger-signature[guard]/activity(触发器-签名[警戒条件]/活动),三部分都是可选的。trigger-signature通常是触发状态潜在改变的事件(可含参数);guard是转换要执行时必须为真的布尔条件;activity是转换期间执行的行为。三部分各自缺省有明确含义:没有活动部分表示转换期间不做任何事;没有警戒条件表示事件发生时总会执行该转换;没有触发器部分则表示要立即执行该转换(多用于活动状态场景),这种情况很少见。 进一步展开见转换的三段式标签语法。

状态图落地到代码主要有三种方式,各有取舍:嵌套switch语句最直接,但哪怕状态不多也很快变成又长又乱、容易失控的代码,即使简单情况也不宜用;状态模式(state pattern)给每个状态建一个子类,顶层抽象类把所有事件处理方法默认实现为什么都不做,具体状态类只需覆盖自己真正响应的事件,组织清晰、每种情况代码量小,但需要为每个状态多建一个类;状态表(state table)把状态图信息表达为纯数据,再配一个解释器或代码生成器去消费这份数据,前期建造成本更高,但建好后可以复用、甚至能在不重新编译的情况下动态修改。三种方式本质上都会产出相当公式化的代码,更好的做法通常是用代码生成来完成,而不是手写。 进一步展开见状态图的三种实现方式对比。

状态机图描述的是一个对象的行为,所以只能展示该对象能直接观察到或主动触发的事情。以城堡保险箱的控制器为例:打开保险箱后人们会放进或取出物品,但控制器分辨不出这些动作,它们就不应出现在控制器的状态图上。发散:画状态图前先确认“这是谁的状态机”,再只保留它能感知的事件和它能触发的动作,否则容易把整个业务流程塞进一个对象。参见状态是抽象的反应模式。 进一步展开见状态机只画对象可感知的。

原书依据 · 22 处

活动图

活动图表达动作间的先后、选择与并发约束。分叉启动并行,结合表达同步,合并收拢替代分支;令牌解释什么时候流程能够继续。局部流结束和整个活动结束的差别尤其需要明确。

在UML 1中,活动图被当作状态图的特例来定义,这个理论血缘关系导致实际问题:人们想用活动图建模它最擅长的工作流场景时,反而被状态图的种种约束(如分叉结合必须平衡)绊住手脚。UML 2把这条纽带彻底移除,活动图不再是状态图的特例,也因此在这一版里经历了UML所有图形类型中最大的一次扩展和改写。这提醒读者:拿到老资料讲活动图时,要先确认谈的是UML 1还是UML 2语境,两者底层设计假设并不相同。 进一步展开见活动图与状态图的解绑。

分叉(fork)有一个进入流和若干离开的并发流,标志着从此处开始的若干动作之间没有先后顺序约束——它们之间可以任意交错、也可以真正同时发生,活动图只表达本质上不得不遵从的先后顺序,其余全部留给执行者自由选择次序,这对建模天然并行的业务流程和并发算法都很有用。结合(join)是分叉的镜像操作:只有当所有进入流都到达结合时,离开流才会执行,用来表达”必须等所有并行分支都完成才能继续”的同步点。UML 1中活动图是状态图特例,要求分叉和结合必须成对平衡;UML 2解除了这个限制。 进一步展开见分叉与结合:并行流的开启与同步。

判断(decision,UML 1称为分支)有单个进入流和若干条带警戒条件的外向流:每条外向流的警戒条件是方括号里的布尔表达式,每次到达判断只能走一条路,警戒条件必须互斥;若某条流用[else]作警戒条件,意思是其余警戒条件都为假时才走这条路。与判断相对的是合并(merge):多个输入流、单个输出流,标志着判断开启的条件分支重新汇合。判断负责分岔,合并负责收拢,二者总成对出现在条件逻辑两端。 进一步展开见判断与合并及else警戒条件。

同一个动作有多个进入流时,UML 1和UML 2的隐含语义完全不同:UML 1里是隐式合并——任何一条流触发动作就执行;UML 2里改成隐式结合——必须所有流都到达,动作才执行。这个语义在版本间发生静默反转,同一张图在不同版本读者眼里可能读出相反行为。为避免混淆,画图时应只给每个动作用单个进入和输出流,需要合并或同步的地方一律显式画出合并或结合节点,不依赖任何隐式语义。 进一步展开见多进入流语义的版本变化。

活动图本身只说明发生了什么,不说明谁来做——编程语境下没传达每个动作归哪个类负责,业务流程语境下没传达哪个部门执行哪个动作;多数时候这不是问题,关注做了什么比关注谁做更有意义。需要展示职责归属时,可把活动图划分成分区,标出每个动作由哪个类或组织单元执行。最简单的一维分区因形似泳道俗称泳道图,是UML 1.x里唯一形式;UML 2允许用二维网格分区,按两个维度同时划分行和列,泳道比喻不再贴切。 进一步展开见分区展示谁做什么。

动作除了顺序执行,还可响应信号:时间信号因时间流逝而触发(如月末、每微秒),信号表示活动从外部进程接收事件,画出信号意味着活动持续监听、定义了收到信号后如何反应。除了接收,活动也可主动发送信号,常见场景是发消息后等待回复——若同时画出等待回复和等待超时两条并行流,本质是竞速:谁先到达终止状态谁赢并终止另一条流,这是处理超时逻辑的标准画法,此时活动结束不隐含对其余并行流的结合等待。 进一步展开见信号与竞速终止。

活动图的规则底层大量依赖令牌的产生和消费:初始节点创建一个令牌并传给下一个动作,动作执行完把令牌继续往下传;到达分叉时,一个进入的令牌会在每一条向外的并发流上各产生一个新令牌;到达结合时则相反,每条进入流的令牌到达后先不做任何事,必须等所有进入流都出现令牌,才在外向流上产生一个输出令牌。这套机制解释了分叉制造并行、结合等待同步的底层原因,用硬币或筹码在图上手动移动令牌,是理解复杂活动图行为的实用可视化技巧。 进一步展开见令牌机制。

动作可以像方法一样带参数,默认不需在图上画出,需要时可用针脚(pin)展示,若动作是从子活动分解来的,针脚对应子活动图上的参数框。严格画图时,前一动作的输出参数类型须匹配后一动作的输入参数类型,类型不匹配可插入变换(transformation)转换——变换须是无副作用的表达式,本质是用输出针脚的查询为输入针脚生成类型正确的对象。针脚还能安全展示多条流汇入同一动作,因为其本身强化了隐式的结合语义。 进一步展开见针脚与变换。

当一个动作的输出会触发另一个动作被多次调用时(如”选主题”生成一批主题、每个主题都要单独”写文章”),最佳表达方式是扩展区域(expansion region):标记出活动图的一个区域,区域里的动作会对输入集合中的每个条目各执行一次,每个条目变成一个令牌流入区域;区域内各动作的产出汇集成输出集合,当所有令牌都汇入后,区域整体对外产出一个代表该集合的令牌。默认可以并行处理集合中的各个条目(用«concurrent»标记),也可以要求逐个完整处理(迭代扩展区域);若只有单个动作需要多次调用,可用速记写法简化,对应UML 1里的动态并发概念。 进一步展开见扩展区域对集合逐项执行。

流结束(flow final)终止的是一条特定的流,不会终止整个活动;这和终止整个活动的活动结束是两回事。典型场景是扩展区域里某个元素被过滤掉(如一篇文章被拒绝),代表它的令牌在流结束处被销毁,但活动的其余部分照常继续处理其他元素,不受影响。这个区分让扩展区域能够扮演过滤器的角色——允许输出集合比输入集合小,因为被过滤掉的每个元素只是让它自己那条流提前结束,而不会连累或打断整个活动。 进一步展开见流结束与活动结束的区别。

默认情况下,结合的规则很简单:所有输入流都到达时才释放输出令牌。但有些场景需要更复杂的同步逻辑,可以给结合附加一个结合规格(join specification)——一个布尔表达式,每次有令牌到达结合就重新计算,算出为真才释放输出令牌。经典例子是自动售货机:不管顾客先选饮料还是先投币,机器每次收到动作都重新检查结合规格,只有累计投入的金额够了才会出货,而非简单等待两条流各出现一次。 进一步展开见结合规格处理复杂同步条件。

活动图最大长处是天然支持并鼓励并行行为,特别适合工作流和业务流程建模,UML 2许多改进也来自社区对工作流场景的关注。它也可当作符合UML规则的流程图使用,或理论上用分叉结合描述并发算法,但实际很少有人在并发圈子这样用——原因是并发编程核心难点是避免数据竞争,活动图在这方面帮不上忙。另一个常见但危险的用法是用活动图描述用例:领域专家往往看不懂这种表达,团队若有此问题,最好回到用例常用的文本形式。 进一步展开见何时使用活动图。

一个动作背后的复杂逻辑,可以拆出去定义成它自己的次级活动图,原图里这个动作就变成对该次级活动的一次调用,用耙子符号(小锯齿状图标)标记这种分解关系。如果动作对应某个类的具体方法,就用class-name::method-name的语法直接写在动作框里;如果被调用的行为比单个方法调用更复杂,也可直接在动作符号里写一小段代码片段。三种写法覆盖了动作背后到底是什么的不同粒度,读者不必每次都靠猜测。 进一步展开见动作分解为子活动或方法调用。

原书依据 · 30 处

通信图

通信图同样描述交互,却把重点放在参与者之间的链接,用消息编号补充顺序。序列图更易读出时间进展,通信图更易看出连接结构,选择依据是当前要解释的问题。

通信图(communication diagrams,UML 1中称协作图)也是交互图的一种,但和序列图走的是相反的表达路线:序列图把参与者固定画成垂直生命线、靠位置传达消息的时间顺序;通信图则允许参与者自由摆放,靠画出的链接展示彼此如何连接,消息顺序改用编号标注而非空间位置。除了展示正式的关联实例链接,通信图还能展示只在这次交互里临时存在的瞬时链接,比如用«local»标注一个局部变量、«parameter»标注参数、«global»标注全局变量——这几个关键词在UML 1里有,UML 2里被移除了,但因为好用,它们很可能在习惯用法里继续留存。 进一步展开见通信图与序列图的表达取舍。

通信图上最常见、最直观的消息编号是扁平序号(1、2、3……),但这种写法在UML规范里其实不合法,原因是它解决不了自调用的歧义:如果一个方法内部又调用了另一个方法,扁平编号没法表达这层嵌套关系,读者分不清某条消息到底是被哪一层调用触发的。UML要求的正式做法是嵌套小数编号(如1、1.1、1.1.1),用编号的层级结构直接对应调用的嵌套深度。代价是当调用嵌套很深时,编号会变成1.1.1.2.1.1这种难以一眼看懂的长串,模糊性问题不但没解决反而更糟糕,这也是许多人明知扁平编号不合法却仍然偏爱它的原因。 进一步展开见嵌套小数编号解决自调用歧义。

选通信图还是序列图,很大程度上是个人偏好问题,总体上大多数人更喜欢序列图。给出一个相对理性的判断标准:要强调调用发生的先后顺序,用序列图更合适;要强调参与者之间谁和谁连接在一起,用通信图更合适。通信图还有一个实用优势——在白板上比序列图更容易随手修改,适合快速探索多个备选交互方案;不过即便这种场景,CRC卡往往是更好的探索工具。 进一步展开见通信图与序列图的选择依据。

原书依据 · 7 处

组合结构

组合结构图将复杂对象展开成运行时部件及其接口连接。端口把对外供需接口按交互角色组织,使读者知道内部协作怎样穿过边界;这与包图展示静态分组的目标不同。

UML 2的一个重要新能力是深入类的内部结构层级,把复杂对象拆解成部件(part):类可在内部图上展示自己由哪些部件组成,每个部件以name:class形式命名,名字和类型可只保留一个;也可标出某部件存在多少实例(如TV Viewer内部含一个发生器部件和一个控制部件)。部件不是真实存在的实例规格,只是对内部组成结构的描述,画法上用粗体而非实例规格惯用的下画线,这个记号差异提醒读者两者语义不同。 进一步展开见组合结构把类分解为部件。

端口(port)可以加到外部结构上,作用是把一组相关的需求接口和供给接口打包成组件与外部世界之间的一个逻辑交互单元,而不是把所有对外的接口零散地摆在类的四周。要展示某个部件实现了某接口,从接口画一条委托连接器过去;要展示某个部件需要某接口,同样加一条委托连接器;部件之间的连接既可以用一根简单的线表示,也可以用小球-球窝表示法表示,两种画法信息等价,选哪种取决于想强调什么。 进一步展开见端口把接口分组为逻辑交互。

理解组合结构和包这两种分组手段的关键区别是:包是编译时的分组机制,划的是代码组织结构;组合结构展示的是运行时分组,划的是一个对象运行期间实际由哪些部件组成、彼此如何连接。正因为这个运行时视角,组合结构天然适合展示组件及组件如何分解成更细的部件,所以这套表示法主要出现在组件图里。作为UML 2里相对新的图形类型,实际效果如何还需更多实践检验,但UML委员会内部不少成员认为这项新增很有价值。 进一步展开见包与组合结构的时机区别。

原书依据 · 6 处

组件图

组件是可以相对独立替换与升级的软件片段,边界既涉及技术依赖,也涉及发布与使用方式。组件图可以表达实际装配或潜在依赖;切分过细会增加版本兼容和管理成本。

UML 1为组件提供过专门的图形符号,UML 2把这个专有符号移除,改为用一个形状相似的小图标标注在普通类框上,或直接用«component»关键词标注,本质上把组件重新纳入类这一大类符号体系,而非单独发明一套语言。除了这个图标标注,组件图不引入任何新表示法——组件之间通过实现接口和需求接口连接,画法直接借用组合结构的表示法,组件图和组合结构图基本是同一回事,只是部件的装饰更少一些。 进一步展开见组件表示法的演变。

组件相关的图有两种画法,分工不同:用组合结构图风格画组件图,展示的是某个特定上下文里组件之间实际连上了哪些接口,是一份具体的连接快照;用类图风格画组件图,通常聚焦组件之间的依赖关系,展示的是组件之间理论上可能存在哪些连接。一个好的类比是:组件类图划定了可能性的边界,组件的组合结构图则在这个边界内选取了某一个具体场景,把它实际发生的连接方式画出来——两者不是互相替代的画法,而是回答不同层次的问题。 进一步展开见组件类图与组件组合结构图的分工。

关于组件到底是什么,社区一直争论不休,Ralph Johnson的说法最有帮助:组件不是技术概念,而是关乎顾客如何与软件发生关系——顾客应能像升级音响一样,每次只买一小片软件,新小片要能无缝配合旧小片工作,按自己节奏升级而非被制造商发布节奏绑架,还能自由混搭不同厂商的小片。这个定义的价值在于把组件从怎么实现的技术讨论拉回到怎么交易组合的市场关系上,需求本身好懂,难的是真正做到。 进一步展开见组件的市场驱动定义。

把系统拆成组件,既是技术决策也是市场决策——决定了顾客能以多大的颗粒度单独购买和升级某一片软件。但要警惕组件粒度切得过细:组件数量一旦太多就会变得难以管理,版本控制问题会格外突出,多个细碎组件之间纵横交错的版本依赖很容易演变成人们常说的DLL地狱。值得一提的是早期UML版本里组件曾被用来表达DLL这类物理结构,现在这个职责已经转交给工件(见部署图一章),组件本身回归到更偏逻辑单元的定位。 进一步展开见组件粒度与DLL地狱警告。

原书依据 · 10 处

协作

协作先定义某种交互中有哪些角色,再由协作发生把角色映射到具体设计。它将通用关系与本地实现分开,但原书对这种图的实际收益持保留态度,理解构造并不意味着项目必须采用。

协作图看起来像类图,骨子里完全不同:整个协作被虚线椭圆圈起来,椭圆里画的所谓类其实不是类,而是角色(role)——应用这个协作模式时各方要扮演的职责,名字不以大写字母开头;某角色恰好对应真实接口或类并不稀奇,但协作本身不要求这种对应关系必须存在。协作对应的交互图里,参与者命名相应变成participant-name/role-name:class-name的三段式,比普通交互图多一层角色标注。 进一步展开见协作用角色而非类描述交互模式。

协作定义好后,要在类图上表明某组类确实用这个协作,可放置协作发生(collaboration occurrence):从协作椭圆连线到具体类,说明这些类扮演协作定义的哪些角色。UML官方建议用它展示设计模式的使用,但现实中几乎没有模式作者这样做;Erich Gamma提出了一种很好的备选画法:直接在元素上加模式名称或pattern:role标签。 进一步展开见协作发生与模式表示法的实际状况。

协作这个图形类型从UML 1就存在,理论上用途明确:当同一套交互行为可能由不同具体类来扮演各角色时,协作提供了组织和描述这套行为模式的方式。但即使在模式类写作中协作图也几乎没人使用,实践中它不是有竞争力的图形类型。协作被单独成章,是因为UML 2标准把它当作组合结构的部件来讨论,而在UML 1中它与组合结构没有任何关系。 进一步展开见协作在实践中缺乏竞争力。

原书依据 · 7 处

交互概述图

交互概述图在控制流中嵌入交互片段,把活动与消息两个视角结合起来。它可以显示粗粒度过程中的关键交互,也可能因混合表示而降低清晰度,应检查它是否比单独的图更容易理解。

交互概述图本质上是把活动图和序列图嫁接在一起:可以把它理解为一张活动图,只不过里面的活动被替换成了一个个小的序列图;也可以反过来理解为一张序列图,被活动图的控制流表示法(判断、合并、分叉等)打碎重组,用来表达原本序列图不擅长的分支和循环逻辑。具体做法是:用活动图搭建整体控制流骨架,在需要展示某段具体交互细节的地方嵌入小型序列图,或者用引用交互框直接引用一张已有的独立序列图,而不用重新画一遍。 进一步展开见交互概述图的混合本质。

交互概述图是UML 2新增的图形类型,它的问题在于它把活动图和序列图这两种风格强行混在一起,而这两种风格的设计初衷、擅长的问题本就不同,二者难以真正融合——是该用活动图展示控制流,还是用序列图展示交互协作,取决于当前目的本身,而不该被一种混合体图形类型替代。和其他UML 2新增的图一样,它到底在实践中有多少用处,现在下结论还为时过早,需要更多实践检验。 进一步展开见交互概述图的实用性存疑。

原书依据 · 3 处

时间图

时间图突出状态变化与时间之间的约束,适合需要解释持续时间或相互时间关系的场景。它补充一般消息顺序图难表达的时间要求,并不替代全部对象协作说明。

时间图是交互图的另一种形式,关注点和序列图、通信图都不同:它专门用来表达时间约束,既可针对单个对象的状态变化,也可展示一束对象间的时间关系,这在硬件工程领域尤其常见(时间图在电子工程中早已长期使用)。典型场景是咖啡壶的泵和电炉:泵开始工作和电炉开始工作之间至少间隔10秒,水空了泵关闭后电炉最多还能开15分钟——这类跨对象、带具体时长的约束,正是时间图存在的意义。 进一步展开见时间图聚焦时间约束。

同一组时间约束可用两种等价的时间图画法表示:一种是状态为线的风格,状态变化表现为从一条水平线跳到另一条水平线;另一种是状态为区域的风格,水平位置不变,状态变化用一个交叉记号表示。两者传达信息完全相同,选择依据是状态数量:状态种类少时,状态为线的风格更清楚;状态很多时,状态为区域的风格更合适,不必为每个状态单独占一条水平线。约束标签旁的虚线是可选的,只在需要明确约束具体针对哪个事件时才加上。 进一步展开见时间图的两种画法与适用场景。

原书依据 · 4 处

UML版本之间的变化

版本附录说明表示法会改变名称和语义。旧图中的关联、角色和扩展机制不能直接按另一个版本解释;版本识别是理解模型约束的前提,而不是只检查图符外观。

UML 1.1认识到类图上的类分两种性质:实现类(implementation class)对应开发所用软件环境里真实存在的类;类型(type)是更模糊、更少绑定实现的抽象,可能是CORBA类型,也可能只存在于规格或概念视角下。实现视角画图用实现类,规格和概念视角用类型;实现类若声明实现了某类型,用实现关系表达。类型和接口不是一回事:接口专指Java或COM风格构造,只能有操作、不能有属性。 进一步展开见类型与实现类的区别。

UML 1.0里角色(role)主要指明关联的方向;UML 1.1把这种用法正式命名为关联角色(association role),同时新增协作角色(collaboration role)——指一个类的实例在协作里扮演的职责。UML 1.1之后协作角色变得更受重视,几乎成为角色一词的首要用法。这提醒读者:不同年代的UML文档提到角色时未必指同一件事,要看上下文判断是关联方向还是协作里的职责。 进一步展开见角色术语的分化。

用例之间的关系随UML版本发生过一次实质性拆分:UML 1.1只有«uses»和«extends»两种,都是泛化的构造型;UML 1.3拆成了三种更精确的关系——«include»(依赖的构造型,表示一个用例的路径被包含进另一个用例,用于抽取多个用例共享的公共步骤)、用例泛化(表示一个用例是另一个用例的变体,特化用例可以改变基用例的任何方面)、«extend»(依赖的构造型,比泛化更可控,基用例显式声明扩展点,扩展用例只能在扩展点处改动行为)。经验规律:过去说的«uses»基本等同于现在的«include»;过去的«extends»则被拆成了现在的«extend»(受控扩展)和泛化(整体变体覆盖)两种含义。 进一步展开见用例关系的历史演变。

UML 2对图形类型清单做了一次大调整:对象图和包图这两种早就被广泛使用的画法,第一次获得官方图形类型的正式地位;UML 1的协作图被重新命名为通信图;同时UML 2还引入了三种全新的图形类型——交互概述图、时间图和组合结构图。这次调整基本奠定了本书后半部分逐一介绍的图形类型清单。 进一步展开见UML2图形类型总览。

UML版本号历史比看起来更混乱:1997年1月Rational联合一批伙伴向OMG提交版本1.0,同年9月综合各方意见提交的建议书称为版本1.1,OMG采纳时却命名为1.0版——于是同时存在Rational版本1.0/1.1和OMG版本1.0两套编号。实践中大家默契地统一把被OMG采纳的标准叫做1.1。了解这段历史的价值是:读到早期UML资料版本号时,不能想当然地假设1.0是最初或最不成熟的版本。 进一步展开见UML版本号的历史混乱。

原书依据 · 10 处

跨章综合

模型有两个需要同时维护的边界:对象和组件之间的责任边界,以及图想表达什么的沟通边界。类图中的接口和契约为序列交互提供可调用的能力,交互再帮助发现行为是否放在数据所属对象附近。包与部署则将同一系统分别投影到依赖和运行环境中,二者不同不代表图互相矛盾。

状态机和活动图尤其容易混淆:前者围绕一个对象对事件的反应,后者围绕任务之间的流程和并发。先明确观察对象,才能决定把状态、同步或超时放在哪里。贯穿全书的选择性原则同样约束文档:保留能帮助理解的重要关系,详细实现应由代码或针对性卡片进一步说明。

发散与实践

读者延伸:本书保留三份以本地cardbox为对象的任务:复查包依赖稳定性、评估sql.DB具体类型的耦合、检查导入入口的协作风格。旧卡中的包数、调用次数与结论属于历史执行记录,本轮未重测;新一轮交付为复查计划,不能将历史结果当作当前代码事实。

生成进度与管理记录

UML精粹:标准对象建模语言简明指南(第3版)

作者:[美] 福勒(Martin Fowler)

类别:领域建模类

本次实际使用规则:book-notes v10(2026-10-02 按逐 spine 覆盖台账重跑,新增 23 张卡);历史使用规则:book-notes v8(2026-09-24),详见 _workflow.md。

阶段一:整体评级

结论:经典原理(高信息浓度 × 高稳定性)

理由: - 高浓度:全书核心不是”怎么在UML里画一个类”,而是解释UML为什么长这样、该怎么用。第1章 用”草稿/蓝图/编程语言”三分法拆解UML的不同用法,并给出正向/逆向工程、表示法/元模型、 强制性/描述性规则等一系列有边界、有取舍的概念对比;UML的历史部分揭示了标准化的真实推动力 是工具厂商而非方法学家,属于”讲清为什么”而非罗列步骤。第2章讨论软件过程时同样围绕”为什么 瀑布/迭代的本质区别在于切分维度”“为什么自适应计划不是没有计划”等因果展开。 - 高稳定性:书中反复强调的判断框架——UML的三种使用模式、表示法与元模型的分离、 UML图的”收起”原则、强制性/描述性规则之分——都不依赖具体工具版本或某个UML小版本号, 即使拿到今天的建模工具或UML的后续修订,这些框架依然成立。少数内容(如UML 2具体版本号、 RUP工具生态)时效性略低,但不影响全书整体的经典原理定位。

阶段二:章节重点确认

V10 重跑(2026-10-02):历史表没有逐 spine 覆盖记录,已按 _coverage.md 逐来源项、逐单元重读后全部恢复 done;卡片数为当前 cards 文件实数,合计 148 张(含 S4 补生成 2 张)。

章节号 章节标题 精读/略读 状态 卡片数
1 简介 精读 done 14
2 开发过程 精读 done 16
3 类图:基础 精读 done 15
4 序列图 精读 done 11
5 类图:进阶概念 精读 done 20
6 对象图 精读 done 3
7 包图 精读 done 8
8 部署图 精读 done 2
9 用例 精读 done 12
10 状态机图 精读 done 12
11 活动图 精读 done 13
12 通信图 精读 done 3
13 组合结构 精读 done 3
14 组件图 精读 done 4
15 协作 精读 done 3
16 交互概述图 精读 done 2
17 时间图 精读 done 2
附录A UML版本之间的变化 精读 done 5
- 参考文献 略读 done 0
- 索引 略读 done 0

理由说明: - 第1-17章及附录A:均属于对UML建模概念/图形类型的实质性讲解(定义、用途、表示法规则、 设计考量),按”概念类内容强制生卡”规则一律精读,不因某些图形类型看似小众而降级。 - 参考文献、索引:纯列表性质,无实质性讲解内容,不计入精读范围,直接标记 done、卡片数 0。 - 后折页、封底:非正文 spine 项,不计入章节清单。

待关联术语

术语名 出现章节 一句话语境
CORBA(通用对象请求代理架构) 第1章 仅提及是OMG最广为人知的工作成果之一,未展开其具体机制。
值类型(value type) 第3章 仅提及”一般来说,值类型”作为倾向使用属性表示法的例子,未展开定义,书中标注第5章(91页)详述。
CRC责任 第3章 仅提及概念模型中操作应”使用概述CRC责任的一些词”,未展开CRC卡具体做法,书中标注81页详述。
数据蝌蚪(data tadpole) 第4章 仅提及”许多方法会用数据蝌蚪来表示数据的移动”,未展开具体画法和使用规则。
枚举(enumeration) 第5章 仅一句话说明用«enumeration»关键词标注固定值集合,内容过于简短,未单独生卡。
类图上的非标准消息表示法 第5章 标准UML不在类图展示消息调用信息,作者提及的是一种非规范扩展画法,未展开使用规则。
小球-球窝表示法的具体画法 第5章 棒棒糖/球窝符号本身是纯记号约定,其代表的供给/需求语义已见[[抽象类接口与供给需求关系]],图形细节未单独生卡。
Petri网 第11章 仅提及是与活动图风格相似的面向流技术之一,”也算不上广为人知”,未展开具体机制。
V10 补充(2026-10-02 逐单元重读)
位置 术语
第1章 OMG(对象管理组织)、CORBA、CASE 工具、双程/无转换工具、MDA、PIM/PSM、可执行 UML、架构型(archetype)、Smalltalk、OOPSLA、三友(Three Amigos)
第2章 RUP/UP、开发案例、阶段交付(staged delivery)、xUnit/JUnit、持续集成、极限编程(XP)、Scrum、FDD、Crystal、DSDM、CRC 卡、代理(Proxy)模式、JavaDoc
第3章 性质字符串({readOnly} 等)、OCL(对象约束语言)、命令查询分离、Liskov 替换原则(LSP)、Eiffel、保护代理、Data Gateway
第4章 生命线、激活条、寻获消息、交互框(loop/alt/opt)、伪消息、数据蝌蚪、CRC 卡
第5章 构造型(stereotype)、扩展机制(profile)、棒棒糖/球窝表示法、泛化集(鉴别器)、«temporal»、«bind»、«instantiate»、数据类型
第6–8章 实例规格、命名空间、门面(Facade)、共同封闭/共同复用原则、无环依赖原则、稳定依赖/稳定抽象原则、数据映射器、分离接口模式、节点/设备/执行环境、工件(artifact)、标记值
第9章 执行者/主执行者/辅助执行者、主成功场景(MSS)、扩展、«include»/«extend»、成功保证/最小保证、触发器、海平面/鱼/风筝级别、用户故事
第10章 初始伪状态、终止状态、内部活动、入口/出口活动、自转换、do-活动、超状态、正交区域、历史伪状态、状态模式、状态表
第11章 初始节点、分叉/结合、判断/合并、[else]、子活动(耙子符号)、分区(泳道)、时间信号、令牌、连接器、针脚、变换、扩展区域(«concurrent»)、流结束、结合规格、Petri 网
第12–17章 嵌套小数编号、«create»/«delete»、部件、委托连接器、端口、«component»、DLL 地狱、协作发生、交互概述图、引用交互框、时间图
附录A 统一方法 0.8、OMG 分析与设计任务组、类型/实现类、{complete}/{mandatory}、«uses»/«extends»、扩展点、动作语义、UML Forum

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境
[Larman] 书 第1章 作者推荐给对象新手的入门书,强调职责驱动设计方法,未展开具体内容。
[Rumbaugh, UML Reference] 书 第1章 官方UML标准的”更容易消化的版本”,仅作推荐提及。
[Martin] 书 第1章 面向对象设计方面更详细建议的来源,仅作推荐提及。
[Kleppe et al.](MDA) 书 第1章 模型驱动架构(MDA)标准的参考文献,正文已展开MDA机制本身(见[[MDA的代码生成链路]]),此处仅记引用来源。
[Mellor and Balcer](可执行UML) 书 第1章 可执行UML(Executable UML)概念的参考文献,正文已展开该概念(见[[MDA的代码生成链路]]),此处仅记引用来源。
[Gang of Four] 书 第2章 详细讨论23种设计模式的经典模式书籍,书中以其中”代理”一节为例说明模式写作规范,未逐一展开全书内容。
[POSA1]、[POSA2]、[Core J2EE Patterns]、[Pont]、[Fowler, AP]、[Fowler, P of EAA] 书 第2章 作者列举的其他模式类书籍,仅提及书名和作者偏好,未展开介绍各自内容。
[McConnell] 书 第2章 作者最喜爱的通用软件过程书籍,仅作推荐提及。
[Cockburn, agile]、[Highsmith] 书 第2章 敏捷过程概述类书籍,仅作推荐提及。
[Ambler] 书 第2章 关于以敏捷方式使用UML的建议来源,仅作推荐提及。
[Beck] 书 第2章 学习极限编程(XP)的推荐起点,仅作推荐提及。
[Beck and Fowler] 书 第2章 为XP而写、侧重迭代项目计划细节的书籍,仅作推荐提及。
[Kruchten] 书 第2章 关于Rational统一过程(RUP)的入门书籍,仅作推荐提及。
[Warmer and Kleppe] 书 第3章 对象约束语言(OCL)的参考文献,仅作为OCL出处提及,未展开书籍内容本身。
[Beck and Cunningham] 论文 第4章 CRC卡最原始的论文,仅作出处提及,未展开论文具体内容。
[Wirfs-Brock] 书 第4章 关于CRC卡和设计中责任划分的延伸读物,仅作推荐提及。
[Jacobson, OOSE] 书 第9章 用例最早因此书而流行,仅作出处提及,未展开书籍内容本身。
[Cockburn, use cases] 书 第9章 用例主题的标准书籍,书中的级别结构(海平面/鱼/风筝)已展开为[[用例的三个级别]],此处仅记引用来源。
[Constantine and Lockwood] 书 第9章 提供通过用例获得用户界面的过程,仅作推荐提及,未展开具体内容。
[Booch, UML user] 书 第10章 《UML用户指南》,状态图更多信息的参考书目,仅作推荐提及。
[Douglass] 书 第10章 实时设计领域关于状态图(含实现方式)的作者,仅作推荐提及,未展开具体内容。
[Hohmann] 书 第14章 关于如何把系统分解成组件(市场与技术双重决定)的优秀指南,仅作推荐提及。
V10 补充(2026-10-02 逐单元重读)
位置 文献
第1章 [Kleppe et al.](MDA)、[Mellor and Balcer](可执行UML)、[Larman]、[Rumbaugh,UML Reference]、[Martin]、Booch/Coad/Jacobson/Odell/Rumbaugh/Shlaer-Mellor/Wirfs-Brock 早期方法论著作
第2章 [McConnell]、[Fowler,refactoring]、[Fowler and Foemmel]、[Beck]、[Gang of Four]、[POSA1]、[POSA2]、[Core J2EE Patterns]、[Pont]、[Fowler,AP]、[Fowler,P of EAA]、[Kerth]、[Cunningham]、[Cockburn,agile]、[Highsmith]、[Ambler]、[Beck and Fowler]、[Kruchten]
第3章 [Meyer](按契约设计、命令查询分离)、[Martin](LSP、依赖管理)、[Warmer and Kleppe](OCL)
第4章 [Beck and Cunningham](CRC 原始论文)、[Wirfs-Brock]
第5章 [Rumbaugh,UML Reference](聚合是“建模安慰剂”);martinfowler.com/ap2/timeNarrative.html(时态模式)
第7章 [Martin](包设计原则)、[Fowler,P of EAA](映射器、分离接口)、[Gang of Four](门面)
第9章 [Jacobson,OOSE]、[Cockburn,use cases]、[Constantine and Lockwood]
第10章 [Booch,UML user]、[Rumbaugh,UML Reference]、[Douglass]、[Martin]
第14章 [Hohmann];Ralph Johnson, c2.com wiki “DoComponentsExist”
附录A [Fowler,AP];uml-forum.com;martinfowler.com

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明
无 — — — 第1-17章及附录A均未出现支付或资金安全技术问题案例,正文阶段三核对完毕。

实践卡进度

阶段三 18⁄18 正文条目(第1-17章及附录A)已全部完成,共123张知识卡(S4修订阶段新增第3章1张,见下)。阶段四已完成,实践对象为本仓库真实存在的 cardbox/ Go 项目(非虚构示例):

序号 实践标题 实践方式 状态 关联章节 产出
1 核对cardbox包依赖是否符合稳定依赖原则 实现深读 done 第7章 真实包依赖表(8个内部包,确认无环、依赖流单向汇聚到db包)
2 评估db包直接暴露sql.DB是否违反面向接口编程 实现深读 done 第5章 量化结论:*sql.DB具体类型扩散至4个包14个文件77处调用点
3 核对import命令是否为中央控制协作风格 实现深读 done 第4章 结论:newImportCmd为中央控制风格,且在CLI入口场景下合理,补充了原书未展开的适用边界

三张卡均已实际执行分析并产出结论(非待办事项),详见 ideas/ 目录。未采用现实调研/行为实验/证据验证等其他实践方式的原因:本书是UML建模技法书,知识点属于”技术原理/架构机制”形态,按路由表首选实现深读,本仓库恰好有真实可读代码,不需要虚构对象或做行为实验。

V10 重筛(2026-10-02):新增卡(如依赖流、表示依赖领域、过程裁剪)与现有三项实现深读主题重合,未产生更优的新实践,维持原 3 张。

类别清单核对

阶段三、阶段四均已完成,本书命中”领域建模类”。逐项核对7个必答维度:

维度 覆盖状态 关联卡片标题或未覆盖理由
建模方法论/流程 已覆盖 [[UML的三种使用模式]]、[[场景与用例的关系]]、[[主成功场景与扩展的结构]]
核心构建块/元语言 已覆盖 [[性质的两种表示法:属性与关联]]、[[抽象类接口与供给需求关系]]、[[引用对象与值对象的标识差异]]
边界划分原则 已覆盖 [[包的定义与完全限定名称]]、[[共同封闭原则与共同复用原则]]、[[包的分层结构与主题区域结构]]、[[依赖流要清晰]]
模型与代码的映射关系 已覆盖 [[性质在代码中的字段与接口解释]]、[[面向接口编程的实践理由]]、[[状态图的三种实现方式对比]]
一致性与事务边界 已覆盖 [[聚合与组合的语义差异]]、[[关联类的定义与实现建议]]、[[结合规格处理复杂同步条件]]
模型演化与重构 已覆盖 [[泛化与可替换性]]、[[契约在子类化中的强化与减弱规则]]、[[用例关系的历史演变]]
反模式/常见建模误区 已覆盖 [[分类与泛化的是一个关系陷阱]]、[[用例图应忽略extend关系]]、[[存取器堆砌是行为错位的信号]]、[[类图不要贪全]]、[[需求分析图要让领域专家看懂]]

“领域建模类”清单:7/7 已覆盖。

主题索引维护

本书为第8条《UML精粹》的第3版,复用该书建立的 6 个建模主题及 4 个通用主题,未新建主题;1 张无需加入。V10(2026-10-02)新增 23 张卡全部加入 9 个已有主题(成员已写入 notes/_topics/),本表覆盖当前全部 148 张卡(含 S4 补生成 2 张)。数据库中既有人工索引“如何选择合适的UML图形类型”(7 张本书卡)保持不变,Markdown 主题不与其重名。

卡片标题 结论 主题文件或原因
UML的三种使用模式 已复用 notes/_topics/modeling-purpose-notation.md
正向工程与逆向工程 已复用 notes/_topics/modeling-purpose-notation.md
MDA的代码生成链路 已复用 notes/_topics/modeling-purpose-notation.md
表示法与元模型的区别 已复用 notes/_topics/modeling-purpose-notation.md
强制性规则与描述性规则 已复用 notes/_topics/modeling-purpose-notation.md
UML图的信息收起原则 已复用 notes/_topics/modeling-purpose-notation.md
UML标准化背后的真正推动力 已复用 notes/_topics/modeling-purpose-notation.md
UML之外的实用图 已复用 notes/_topics/modeling-purpose-notation.md
瀑布与迭代开发的本质区别 已复用 notes/_topics/iterative-process-tailoring.md
预测性计划与自适应计划 已复用 notes/_topics/iterative-process-tailoring.md
敏捷过程的核心假设 已复用 notes/_topics/iterative-process-tailoring.md
仪式与轻量过程的关系 已复用 notes/_topics/iterative-process-tailoring.md
RUP的四个阶段 已复用 notes/_topics/iterative-process-tailoring.md
时间盒 已复用 notes/_topics/iterative-process-tailoring.md
支撑高效返工的三项工程实践 已复用 notes/_topics/iterative-process-tailoring.md
模式的定义与本质 无需加入 设计模式的一般定义,现有主题均不能准确表达,本书内无同类卡
精选备忘录优于详尽文档 已复用 notes/_topics/modeling-purpose-notation.md
性质的两种表示法:属性与关联 已复用 notes/_topics/static-structure-modeling.md
多重性的记号与常用术语 已复用 notes/_topics/static-structure-modeling.md
性质在代码中的字段与接口解释 已复用 notes/_topics/static-structure-modeling.md
双向关联与主控从属设计 已复用 notes/_topics/static-structure-modeling.md
操作与方法的区别 已复用 notes/_topics/interface-design-dispatch.md
查询与修改器和命令查询分离原则 已复用 notes/_topics/interface-design-dispatch.md
泛化与可替换性 已复用 notes/_topics/interface-design-dispatch.md
依赖关系的方向性与非传递性 已复用 notes/_topics/modularity-information-hiding.md
类图中约束的表达方式 已复用 notes/_topics/static-structure-modeling.md
按契约设计的三种断言 已复用 notes/_topics/interface-design-dispatch.md
契约在子类化中的强化与减弱规则 已复用 notes/_topics/interface-design-dispatch.md
存取器堆砌是行为错位的信号 已复用 notes/_topics/interaction-responsibility-modeling.md
中央控制与分布控制两种协作风格 已复用 notes/_topics/interaction-responsibility-modeling.md
UML2交互图中的参与者术语 已复用 notes/_topics/interaction-responsibility-modeling.md
交互框表达循环与条件 已复用 notes/_topics/interaction-responsibility-modeling.md
伪消息表达循环与条件 已复用 notes/_topics/interaction-responsibility-modeling.md
同步消息与异步消息的语义区别 已复用 notes/_topics/interaction-responsibility-modeling.md
何时使用序列图与其他图的分工 已复用 notes/_topics/interaction-responsibility-modeling.md
CRC卡与责任和协作者 已复用 notes/_topics/interaction-responsibility-modeling.md
CRC卡相对序列图的核心价值 已复用 notes/_topics/interaction-responsibility-modeling.md
关键词与构造型 已复用 notes/_topics/modeling-purpose-notation.md
静态操作和属性 已复用 notes/_topics/static-structure-modeling.md
聚合与组合的语义差异 已复用 notes/_topics/static-structure-modeling.md
派生性质的两种解释 已复用 notes/_topics/static-structure-modeling.md
抽象类接口与供给需求关系 已复用 notes/_topics/interface-design-dispatch.md
面向接口编程的实践理由 已复用 notes/_topics/interface-design-dispatch.md
只读与冻结的区别 已复用 notes/_topics/static-structure-modeling.md
引用对象与值对象的标识差异 已复用 notes/_topics/static-structure-modeling.md
值对象的不可变性与走样问题 已复用 notes/_topics/static-structure-modeling.md
限定关联的语义 已复用 notes/_topics/static-structure-modeling.md
分类与泛化的是一个关系陷阱 已复用 notes/_topics/inheritance-composition.md
单重分类与多重分类 已复用 notes/_topics/static-structure-modeling.md
泛化集管理多重分类的合法组合 已复用 notes/_topics/static-structure-modeling.md
动态分类与静态分类 已复用 notes/_topics/static-structure-modeling.md
关联类的定义与实现建议 已复用 notes/_topics/static-structure-modeling.md
何时把关联提升为完整的类 已复用 notes/_topics/static-structure-modeling.md
模板参数化类 已复用 notes/_topics/static-structure-modeling.md
主动类 已复用 notes/_topics/static-structure-modeling.md
可见性的跨语言差异 已复用 notes/_topics/modeling-purpose-notation.md
对象图的定义与适用场景 已复用 notes/_topics/static-structure-modeling.md
对象图的实例命名语法 已复用 notes/_topics/static-structure-modeling.md
实例规格不是真正的实例 已复用 notes/_topics/static-structure-modeling.md
包的定义与完全限定名称 已复用 notes/_topics/modularity-information-hiding.md
门面模式收窄包接口 已复用 notes/_topics/modularity-information-hiding.md
共同封闭原则与共同复用原则 已复用 notes/_topics/modularity-information-hiding.md
包图定义与依赖的概括关系 已复用 notes/_topics/modularity-information-hiding.md
稳定依赖原则与稳定抽象原则 已复用 notes/_topics/modularity-information-hiding.md
包的分层结构与主题区域结构 已复用 notes/_topics/modularity-information-hiding.md
接口与实现分离到不同包 已复用 notes/_topics/modularity-information-hiding.md
节点的两种形式:设备与执行环境 已复用 notes/_topics/model-implementation-separation.md
工件是软件的物理显现 已复用 notes/_topics/model-implementation-separation.md
场景与用例的关系 已复用 notes/_topics/use-cases-requirements.md
执行者的定义与特点 已复用 notes/_topics/use-cases-requirements.md
用例价值在文本不在图 已复用 notes/_topics/use-cases-requirements.md
主成功场景与扩展的结构 已复用 notes/_topics/use-cases-requirements.md
用例的包含关系与反对功能分解 已复用 notes/_topics/use-cases-requirements.md
用例的前置条件、保证与触发器 已复用 notes/_topics/use-cases-requirements.md
用例图应忽略extend关系 已复用 notes/_topics/use-cases-requirements.md
用例的三个级别 已复用 notes/_topics/use-cases-requirements.md
用例与特性(故事)的关系 已复用 notes/_topics/use-cases-requirements.md
警戒条件互斥与无效事件被忽略 已复用 notes/_topics/state-activity-modeling.md
状态是抽象的反应模式 已复用 notes/_topics/state-activity-modeling.md
内部活动与自转换的区别 已复用 notes/_topics/state-activity-modeling.md
入口活动与出口活动 已复用 notes/_topics/state-activity-modeling.md
do活动与常规活动的区别 已复用 notes/_topics/state-activity-modeling.md
超状态收纳共享行为 已复用 notes/_topics/state-activity-modeling.md
并发正交状态 已复用 notes/_topics/state-activity-modeling.md
历史伪状态 已复用 notes/_topics/state-activity-modeling.md
何时使用状态图 已复用 notes/_topics/state-activity-modeling.md
转换的三段式标签语法 已复用 notes/_topics/state-activity-modeling.md
状态图的三种实现方式对比 已复用 notes/_topics/state-activity-modeling.md
活动图与状态图的解绑 已复用 notes/_topics/state-activity-modeling.md
分叉与结合:并行流的开启与同步 已复用 notes/_topics/state-activity-modeling.md
判断与合并及else警戒条件 已复用 notes/_topics/state-activity-modeling.md
多进入流语义的版本变化 已复用 notes/_topics/state-activity-modeling.md
分区展示谁做什么 已复用 notes/_topics/state-activity-modeling.md
信号与竞速终止 已复用 notes/_topics/state-activity-modeling.md
令牌机制 已复用 notes/_topics/state-activity-modeling.md
针脚与变换 已复用 notes/_topics/state-activity-modeling.md
扩展区域对集合逐项执行 已复用 notes/_topics/state-activity-modeling.md
流结束与活动结束的区别 已复用 notes/_topics/state-activity-modeling.md
结合规格处理复杂同步条件 已复用 notes/_topics/state-activity-modeling.md
何时使用活动图 已复用 notes/_topics/state-activity-modeling.md
动作分解为子活动或方法调用 已复用 notes/_topics/state-activity-modeling.md
通信图与序列图的表达取舍 已复用 notes/_topics/interaction-responsibility-modeling.md
嵌套小数编号解决自调用歧义 已复用 notes/_topics/interaction-responsibility-modeling.md
通信图与序列图的选择依据 已复用 notes/_topics/interaction-responsibility-modeling.md
组合结构把类分解为部件 已复用 notes/_topics/static-structure-modeling.md
端口把接口分组为逻辑交互 已复用 notes/_topics/static-structure-modeling.md
包与组合结构的时机区别 已复用 notes/_topics/static-structure-modeling.md
组件表示法的演变 已复用 notes/_topics/modularity-information-hiding.md
组件类图与组件组合结构图的分工 已复用 notes/_topics/modularity-information-hiding.md
组件的市场驱动定义 已复用 notes/_topics/modularity-information-hiding.md
组件粒度与DLL地狱警告 已复用 notes/_topics/modularity-information-hiding.md
协作用角色而非类描述交互模式 已复用 notes/_topics/interaction-responsibility-modeling.md
协作发生与模式表示法的实际状况 已复用 notes/_topics/interaction-responsibility-modeling.md
协作在实践中缺乏竞争力 已复用 notes/_topics/interaction-responsibility-modeling.md
交互概述图的混合本质 已复用 notes/_topics/interaction-responsibility-modeling.md
交互概述图的实用性存疑 已复用 notes/_topics/interaction-responsibility-modeling.md
时间图聚焦时间约束 已复用 notes/_topics/interaction-responsibility-modeling.md
时间图的两种画法与适用场景 已复用 notes/_topics/interaction-responsibility-modeling.md
类型与实现类的区别 已复用 notes/_topics/static-structure-modeling.md
角色术语的分化 已复用 notes/_topics/modeling-purpose-notation.md
用例关系的历史演变 已复用 notes/_topics/use-cases-requirements.md
UML2图形类型总览 已复用 notes/_topics/modeling-purpose-notation.md
UML版本号的历史混乱 已复用 notes/_topics/modeling-purpose-notation.md
好设计胜过合法UML 已复用 notes/_topics/modeling-purpose-notation.md
图到代码没有正式映射 已复用 notes/_topics/model-implementation-separation.md
先学类图和序列图 已复用 notes/_topics/modeling-purpose-notation.md
形式规格证明不了需求 已复用 notes/_topics/modeling-purpose-notation.md
概念视角与软件视角 已复用 notes/_topics/modeling-purpose-notation.md
UML当编程语言的门槛 已复用 notes/_topics/modeling-purpose-notation.md
只有可运行软件证明进度 已复用 notes/_topics/iterative-process-tailoring.md
过程必须裁剪 已复用 notes/_topics/iterative-process-tailoring.md
需求分析图要让领域专家看懂 已复用 notes/_topics/use-cases-requirements.md
文档要写未采纳的方案 已复用 notes/_topics/technical-communication.md
迭代回顾列三栏 已复用 notes/_topics/iterative-process-tailoring.md
蓝图偏离须评审 已复用 notes/_topics/modeling-purpose-notation.md
用工具图探索遗留代码 已复用 notes/_topics/technical-communication.md
依赖图交给工具生成 已复用 notes/_topics/component-cohesion-coupling.md
概念模型不画实现细节 已复用 notes/_topics/static-structure-modeling.md
类图不要贪全 已复用 notes/_topics/static-structure-modeling.md
返回箭头只在有用时画 已复用 notes/_topics/interaction-responsibility-modeling.md
责任清单过长要拆类 已复用 notes/_topics/interaction-responsibility-modeling.md
创建与删除参与者 已复用 notes/_topics/interaction-responsibility-modeling.md
枚举是固定集合 已复用 notes/_topics/static-structure-modeling.md
依赖流要清晰 已复用 notes/_topics/component-cohesion-coupling.md
用例不对应内部类 已复用 notes/_topics/use-cases-requirements.md
用例细节随风险增减 已复用 notes/_topics/use-cases-requirements.md
用例步骤写意图 已复用 notes/_topics/use-cases-requirements.md
状态机只画对象可感知的 已复用 notes/_topics/state-activity-modeling.md

2026-10-23 v23轻量恢复

执行模式:light

  • 首次生成Skill版本保留;本轮实际book-notes v23 / book-workflow v4。
  • 来源与v10有效覆盖匹配,复用18项正文的全文阅读和现有知识卡;不重写历史卡元数据。
  • 整书笔记:_book_note.md,schema 1,SHA-256 032df464295698a6318108e4d1abe3c7091abf0a59a154c54fc3196d2cf3151b。每张现存卡有一个主要讲解位置及至少一处原书出处。
  • 实践沿用3项本地任务,更新路径与执行模式边界;本轮计划交付,未执行复查。
  • 轻量模式:未执行笔记复核、独立审查及审查结果优化;历史报告保留。

实践候选筛选:done

保留与实际项目有关的建模任务,不新增没有对象或明确产出的图形练习。

相关主题

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

主题索引

建模的用途与表示法边界

比较建模语言作为草稿、蓝图或编程语言的不同用途,以及表示法规则、元模型与版本演化的边界。

248 张卡片 · 29 本书

主题索引

模块化与信息隐藏

比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。

209 张卡片 · 51 本书

主题索引

用例与需求表述

比较以用户目标组织需求的用例写法、粒度分层与特性粒度的取舍。

181 张卡片 · 25 本书

主题索引

组件聚合与耦合原则

比较 REP、CCP、CRP 的组件聚合张力,以及无依赖环、稳定依赖、稳定抽象原则与 I/A 指标对组件耦合的度量。

127 张卡片 · 31 本书

主题索引

技术沟通与架构表达

比较面向不同受众的技术写作、演示与架构图方法:循序渐进的讲解、文档与幻灯片的取舍,以及让图表达连接与语义。

124 张卡片 · 27 本书

主题索引

交互建模与职责分配

比较用序列图、通信图、CRC 等描述对象协作与分配职责的方法。

106 张卡片 · 9 本书

主题索引

状态与活动建模

比较状态机与活动图在表达事件响应、并发、流程与责任划分上的用法。

93 张卡片 · 13 本书

主题索引

迭代开发与过程裁剪

比较迭代与预测式开发、时间盒与过程裁剪在不同需求稳定性下的适用性。

93 张卡片 · 26 本书

主题索引

模型与实现分离

比较逻辑模型与物理实现、值与变量、派生视图与存储结构之间的边界。

79 张卡片 · 13 本书

主题索引

类图与静态结构建模

比较类、属性、关联、聚合与组合、值对象等静态结构的建模语义与取舍。

78 张卡片 · 9 本书

主题索引

接口设计与动态分派

比较接口粒度、隐式/显式实现、接口值表示与动态分派的取舍。

66 张卡片 · 18 本书

主题索引

模式语言与选型

模式之间的关系与意图对比、组合用法,以及模式在框架、语言与重构中的适用边界。

64 张卡片 · 15 本书

主题索引

继承、原型与组合复用

比较类继承、原型继承、函数化构造与组合在代码复用上的取舍。

50 张卡片 · 18 本书