此笔记位置已失效,请从目录继续阅读。
全书导读
这本书讨论怎样投入恰好足够的架构工作。架构是用于推理系统的结构、元素、关系和外部属性;它影响系统能否快速响应、承受增长、隔离故障或方便修改。做很多设计不一定合算,完全不看结构也可能让重要风险直到实现后才暴露。阅读时可始终带着三个问题:什么可能失败,什么技术能降低这个风险,已有证据是否足以开始或继续编码。
前半部用风险驱动模型给出投入与停止的尺度,后半部给出能解释系统的共同语言:现实问题、设计与代码三层模型,模块、组件、部署视图,以及端口、连接器、场景和约束。图的作用不是装饰文档,而是让问题能在较少细节上被理解,再将推断映射回真实系统。
本书案例与语言、框架和平台属于其出版语境;本笔记把可迁移原理与历史技术判断分开。理解模型不等于获得实际系统的正确性保证,最终仍需合适的实现、测量与验证。
全书主线
全书主线从失败风险出发。风险是对失败可能性及影响的判断,团队先把隐含担心显式化并排优先,再挑选针对性的原型、建模或评估技术,最后检验风险是否真的降低。这个循环限制了无休止的前期设计,也避免把“敏捷”当作忽略困难问题的理由。
技术选择需要一个可以推理的系统表示。分治把整体拆小,抽象省去当前无关细节,已有知识提供可复用的约束与方案;但部分必须重新组合,省略也不能删除决定结论的条件。领域模型描述问题背景,设计模型作出仍有留白的实现承诺,代码模型把它落实为可执行细节。
再把设计分别从源代码组织、运行时协作和硬件部署三个角度看:模块回答制品怎样分组与依赖,组件和连接器回答谁承担工作以及如何交互,部署回答软件放在哪里。类型与实例、边界与内部、视图与主模型的关系必须说清,不能把所有方框和箭头混成一种结构。
质量属性把需求与设计选择连起来。场景给出可检查的触发与响应,职责把整体意图分配给元素,风格用一组约束换取期望性质,权衡说明付出的代价。实现中以编码约定或框架托举关键约束,仍须检验代码是否保持模型承诺;最后回到真实系统,判断它是否解决了原来的问题。
flowchart TD
R[显式化失败风险] --> Q[选择当前要回答的问题]
Q --> T[选择经济的建模或原型技术]
T --> M[解释结构 行为与质量约束]
M --> V[把结论映射到实现与验证]
V --> D{风险是否降低到可接受程度}
D -->|否| R
D -->|是| C[继续构建并随变化重新评估]
图表达风险驱动的迭代思想,不声称每次活动都必须产出完整架构文档。
序
架构设计是为系统选择结构和约束的工程工作。全面设计与尽量不设计都不能统一适用于所有项目:需要先看失败风险,再判断建模、分析的收益是否值得其成本。一个已被成熟方案解决的低风险问题,与可能使整个系统失败的新问题,需要的设计投入不同。这里提出的是取舍尺度,后面的风险驱动模型会说明怎样识别风险、选技术及评估结果。架构努力应与风险相称保留了这个投入原则的停止边界。
前言
知道编程语言的特性,不等于会设计一个系统;熟悉图形记号也不等于做出了好的设计。本书从风险出发选择技术,把架构知识交给所有开发者,而不将其集中为架构师的专属能力。架构知识应分散给全体开发者说明这种共享为何能改善沟通与反馈。
会设计还需要能解释设计。过程性知识是实际做事的能力,陈述性知识则能给经验命名、解释为什么如此,使经验可以传授;陈述性知识便于传授经验辨别两者。后续模型把系统的现实背景、设计选择、实现细节分开,帮助开发者在细节与全局间往返。作者经历、工具及致谢说明本书形成背景,不是本轮已核验的软件产品现状。
第1章 概述
系统规模增长时,单靠记住更多细节难以维持理解。概念模型是一套帮助分类与解释观察结果的思维抽象:同一段代码,熟悉相关模型的人会看出锁策略或事件驱动机制,而初学者可能只看见零散语句。篮球教练能从传球看出战术,就是这种理解方式的类比。它提高的是组织信息的能力,不是声称读者的智力数值发生改变。概念模型加速学习并解放思维记录这一学习作用。
1.1 分治、知识与抽象
应对复杂度有三种互补方式。分治把问题拆成一个人能够理解的小部分,并明确怎样重组;知识让开发者复用以前的解法,来源包括代码、模式与设计文档;抽象则隐藏当前问题无关的细节,缩小推理范围。拆分后若不能重新装配,或隐藏了当前需要考虑的细节,都不能达到目的。架构在系统层面同时使用这三种方法,而不是取代编程经验。分治知识抽象三武器保存三者各自的用途。
原书依据 · 1 处
1.2 软件架构的三个案例
Rackspace 的邮件日志查询经历了三个历史版本。第一版用脚本登录每台邮件服务器执行 grep,临时查询灵活,却需要工程师并给邮件服务器增加负载。第二版把日志集中到关系数据库,技术支持人员能够通过网页查询,随后单机 CPU、磁盘与数据导入成为瓶颈。第三版使用分布式存储和并行索引,在多台普通机器上处理更大数据量。
第三版每十分钟启动一次、约五分钟完成索引,所以搜索覆盖的数据可能滞后约十五分钟;对已有索引的查询仍可数秒返回。索引新鲜度、查询耗时以及设计新查询所需时间是不同指标。Rackspace三代架构演变用图对照三种结构,这些数字限定为原书介绍的历史案例。
原书依据 · 1 处
1.3 反思
三个系统都能查询邮件日志,但系统结构不同,说明基本功能不会唯一决定架构。评价还要看质量属性,也就是系统完成任务时表现得怎样,例如能否扩大处理规模、容易修改到什么程度、数据是否及时。第三版扩大规模的同时,让即席查询需要新作业,并引入批量索引的数据滞后;质量属性此消彼长保存这组具体取舍。
推理要选择合适层次。讨论作业如何流动时,用作业而非每次对象调用来思考更有效;而抽象上的约束会排除某些行为。例如限制无副作用,让重复执行及并行执行的相互影响更容易分析。约束提升代码可推理性说明为何主动限制能减少不确定性。模块、运行时组件与硬件节点的区别将在模型章节展开,不能混为同一种拆分。
1.4 视角转换
结构化编程的历史争论说明,新的抽象会带来约束,也可能让运行行为更容易理解。组件和连接器是一种系统层面的观察方式,并不使对象、方法和数据结构消失;应根据当前问题选择层次,见新抽象兼容而非替代旧抽象。
如果始终只增加类而不建立较高层次的边界,对象协作可能逐渐变得随意,形成难以理解的大泥球。大泥球反模式描述这种结构腐化,它是风险与常见形态,而不是类达到某个数量就自动出现的定律。
1.5 架构师构建架构
架构讨论中的三个对象需要分开。头衔说明组织安排了什么角色;过程说明团队怎样开展设计和构建;工程制品则是系统实际形成的结构。没有架构师头衔仍会有系统架构,同一种结构也可能来自不同过程,因此不能只凭头衔或工作方式判断架构优劣。架构头衔过程制品三分离对照这三者。所有开发者都需要理解自己构建的系统,架构也能够作为制品被分析和改进。
原书依据 · 1 处
1.7 敏捷开发者的架构
敏捷希望减少无用活动,同时更快构建客户需要的产品,并不要求忽略架构风险。若风险能可靠地留给后续重构处理,可以及时开始编码;若重构不足以取得所需的安全性或可伸缩性,就需要在当前迭代先降低这些风险。恰如其分的架构保存这种判断尺度。概念模型为这些判断提供系统层面的表达工具,重构和技术预演则提供改善设计的手段,两者可以相互补充。原书中的敏捷采纳比例属于历史研究背景,不当作当前比例。
原书依据 · 1 处
1.8 关于本书
全书先讨论怎样按风险决定设计投入,再提供表达和检验设计的模型工具。风险驱动方法先识别风险并排序,再选择与运用技术,最后评估风险是否下降;风险驱动模型四步骤把识别和排序分开展示,语义对应原书的三组动作。家庭媒体播放器会给出集成、交流与元数据一致性的应用场景。
领域模型描述现实世界的事物;设计模型表达准备构建的系统;代码模型对应源代码。领域设计代码三层模型结构保存三种对象的区别。视图是为了观察特定细节而选出的模型内容,见视图是主模型的一致投影。封装则让使用者依靠外部约定工作,暂不追踪内部实现,后续章节会说明怎样使这种边界有效。本节其余内容是后文主题的预告,不能据此将后文标为已读。
第2章 软件架构
软件架构讨论系统的设计,以及这些设计怎样影响性能、安全、可修改性等质量。要决定投入多少工作,先要认识架构是什么、为什么会影响成败。本章从结构和约束解释其作用,随后比较不主动关注、主动选择、集中承担质量责任三种方式。这为第3章按风险选择技术提供对象和边界。
2.1 何为软件架构?
架构是为了理解和推理系统而需要的一组结构,包含软件元素、元素关系及它们的属性。只列出组件名称不够,还需要知道这些部分怎样工作、为什么这样连接。SEI软件架构定义保存定义,并与本章末尾强调早期难改决策的另一观点对照。
架构通常关注宏观结构,却不等于所有低层细节都不重要。Java Bean 的方法命名能支持框架发现属性,因而属于具有整体影响的细节。意图链条把高层目标与低层限制联系起来,但也有难以准确界定意图、架构并非有意形成的局限;意图链条判断架构归属保留这项判断方法及限制。
2.2 软件架构为何重要?
架构像骨架,为整体活动提供结构;适合不适合,要看系统任务。这个比喻也容易让人漏掉锁策略、内存管理等不显眼的规则,见架构骨架隐喻及其局限。功能是系统能完成什么,例如管理账务;质量属性则是完成这些功能时表现如何,例如保密性、速度和可修改性。实现同一功能的架构可以不同,但有些组合会让质量目标难以达成。
约束限定系统允许和不允许怎样实现或运行。它既可传递专家判断,也能让全系统采用一致概念、减少任意例外,并使运行行为更容易分析。约束对架构设计的四大益处逐项解释这些收益。限制的价值在于服务明确目标,不能由此为任意限制辩护,也不能假定添加一种约束就自动满足所有质量要求。
2.3 架构何时重要?
解空间是能够满足需求的可接受方案集合;它越小,选错方案的回旋余地越少。再加上失败后果严重、质量指标难达、新领域经验不足,或多个产品共享同一架构时,架构决策就需要更多注意。架构重要性的五个信号对照这些风险来源。原书借阿姆达尔定律提醒关注对整体真正有影响的部分,不能把这一类比当作风险的精确性能公式。
原书依据 · 1 处
2.4 推定架构
推定架构是领域中被默认采用的主导架构族,参考架构是公开描述的一类问题解决方案。两者可能重合,也可能没有:发布参考方案不代表大家已经采用。推定架构与参考架构的区别解释事实惯例与参考规格的区别。
成熟架构能减少常见风险,因为已有配套约束和组件。例如IT系统把界面、业务逻辑与事务型数据存储分开,操作系统把任务放入独立进程以帮助隔离故障。这里的价值来自具体机制,不能只照搬架构名称并假定所有风险已消失。
原书依据 · 1 处
2.5 如何运用软件架构?
三种处理方式描述开发者怎样对待架构。架构无关的设计很少主动挑选;专注架构的设计主动选择与目标兼容的结构;提升架构的设计进一步把某个目标的实现责任集中到可识别的机制中。三种软件架构处理方式总览用车辆安全装置和性能预算作对照。这是责任与选择方式的区别,不是评价所有项目都应该从第一种升级到第三种的成熟度排名。
原书依据 · 1 处
2.6 架构无关的设计
架构无关并非系统没有架构,而是开发者没有审慎选择它。低风险且成熟惯例足够的项目也可能成功,但缺乏共同愿景时,局部、无原则的修改会逐渐增加复杂度。架构无关设计的代价保留这种演化风险。成熟数据库或服务总线能承担部分复杂机制,减轻开发者负担,但它们不能免除对当前需求和使用条件的判断。
原书依据 · 1 处
2.7 专注架构的设计
专注架构的设计先识别会影响全局的需求,再检查当前架构是在帮助还是妨碍它。统一锁顺序、内存释放规范、缓存访问约束与持久消息队列,都是让全局机制承担问题的例子;这里没有给出具体资金事故,不补造损失情节。专注架构设计的核心要求对比架构层面方案与发现一处问题修一处。
理解线程中组件与跨机器组件时,要分别注意线程安全和远程访问条件,不能只看孤立代码。关注架构也不等于必须写大量文档,何时记录应看协作需要;它与采用敏捷或瀑布过程可以分别选择。
原书依据 · 1 处
2.8 提升架构的设计
架构提升把某个反复出现的目标转给集中机制。对50毫秒响应的要求,主动选择适合的通信结构可留下更多计算预算;若进一步设置按负载补充服务器的机制,就由该机制承担部分峰值压力。不过原文明确说明,低效代码仍可能失败,因此扩容并非每个请求都满足时限的证明。提升架构设计的运作机制保留责任转移与保证条件的区别。
原书的应用服务器、EJB与Eclipse例子说明,平台可以集中承担并发、扩展、持久化或资源管理;应用必须遵守相关约束。垃圾回收减轻内存管理负担,也可能影响性能控制。只有集中机制确实减轻开发者负担、代价又适合目标时,提升才值得。表2.1已实际查看,其三行描述与这些区别一致;具体平台限制限定为原书历史背景。
原书依据 · 1 处
2.9 大型组织中的架构
企业架构职责面向多个应用形成的生态,包括集成、跨市场支持和部署标准化;应用架构职责则面向单个系统的具体实现。共享标准可减少异构混乱,却也可能压缩局部选择空间,过严约束和低估标准化都会产生问题。企业架构师与应用架构师的张力说明这种利益和代价。原文讨论的是一种大型组织模式,不要求所有公司具有同样汇报关系;各方理解约束的目的,有助于尽早发现冲突。
原书依据 · 1 处
2.10 小结
本章把架构看作可以分析的工程制品:结构提供系统骨架,约束引导实现,二者共同影响质量目标。需要多少关注取决于架构错误对整个系统的风险。默认采用成熟架构、主动挑选合适架构、把责任提升到集中机制,可以服务不同情形;组织上的职责划分也应结合收益和代价。这里收束前文,不另造重复卡。
第3章 风险驱动模型
工程设计需要预想系统会怎样失败,再选择能帮助避免失败的技术。失败分析是设计的核心说明这一出发点。设计也占用时间,不做预先设计、固定时间比例、完整文档包、凭经验临场判断,都不足以统一回答“当前该用什么技术、做到何时”。本章用风险把选择技术和控制投入联系起来,既考虑失败,也考虑分析本身的成本。
原书依据 · 1 处
3.1 风险驱动模型是什么?
风险驱动模型用三组动作组织设计:识别风险并排序,选择和运用技术,再评估剩余风险。不同团队可能认识不同,但应该给出可讨论的理由,例如“B是首要风险,X和Y能降低B,现有证据足以恢复编码”。风险驱动模型产出可评估论据保留这种论证结构。
风险必须显露在日常决策中。只追踪交付了哪些功能,可能让质量属性长期被推后;特性关注会挤占风险关注记录原书研究案例的提醒,它不是对所有敏捷团队的普遍判决。
3.2 你现在采用风险驱动了吗?
说得出主要失败风险及对应技术,才算把风险落实到工作中。三层系统的前端与后端可能面对不同风险,如果只提交同一张模块图,技术就可能与风险脱节。统一模板掩盖风险差异说明标准模板应怎样接受实际问题的检验。不同团队、领域及部署位置的风险可以不同,不能凭统一流程假定所有技术都同样合适。
原书依据 · 1 处
3.3 风险
风险通常把失败可能性和影响结合考虑。本书进一步强调这两项判断是“觉察到的”:未测试的程序即使客观无缺陷,开发者仍会不确定;分析和测试可以改变信心。风险的工程学定义保留这一认识层面的定义,不能把自信增加自动等同于实际缺陷减少。
把“可靠性不足”写成“峰值负载时界面延迟超过5秒”,才有具体条件和失败结果可检验,见风险要描述为可测试的失败场景。工程风险涉及分析、设计和实现;管理风险涉及进度、协作、交付等。工程风险与管理风险需分类应对说明工具要匹配对象,而项目整体仍需权衡二者。
需求中难以实现或含混的部分、领域检查表及专家意见都能帮助识别风险,但不可能预见一切。表3.1区分人员与市场协作问题和系统容量、解析缺陷等问题;表3.2列出IT、系统及Web的典型风险,它们提示检查方向,不代表某类项目只有这些风险。典型风险检查表的价值与盲点保存医疗软件重启时间的反例。排序时还要合并利益相关者的重要性判断和开发者的难度判断,见风险排序结合利益与难度。
3.4 技术
缓解风险既可分析问题,也可使用已知方案。为大教堂计算应力属于分析,采用飞拱属于方案;软件中的性能模型与架构模式也位于这条光谱上。分析到方案的技术光谱解释为何本模型更关注该开展哪些活动。表3.3并列软件与其他工程的建模、原型、分析手段,说明建模不是软件独有。
选型不能只看一项技术确实找到几个问题,还应比较同样时间投向其他风险能得到什么;技术选型要计入机会成本说明这种比较。多个技术可以覆盖同一风险,一个技术也可能帮助多个风险。无限分析会挤压交付和市场时机,因此工程风险无法被根除讨论的是在有限资源下的取舍,不是要求忽略已知重大风险。
3.5 选择技术的指导原则
选技术先判断需要怎样的证据。求解问题可以用一个满足条件的实例作证;要证明普遍成立的性质,则不能仅凭有限测试成功,例如“所有框架调用都合约”或“所有执行都无死锁”。要求解的问题与要证明的问题说明单次测试结论的范围。
类比模型用图中对象对应真实对象,依靠人的知识解释;分析模型则包含能直接计算所问问题的信息。相同UML记号可能支持不同分析:没有运动向量的飞机图不能直接算碰撞航向,但仍能数飞机。分析模型与类比模型的区别说明分类取决于所问问题。
视图也要匹配风险。模块结构适合看修改影响,运行时结构适合看交互和性能,部署结构适合看机器分布与单点故障;视图类型与风险的匹配保留这项原则。速率单调分析、威胁建模和排队理论在本节仅点出用途,未展开技术细节,后文仍需实际阅读。
3.6 何时停止
停止设计的条件不是模型完整,而是针对高优先级风险已有足够证据。架构努力应与风险相称说明为什么风险驱动的模型可以只描绘局部:性能是主要风险时,模型可以细画性能相关部分,不必补齐所有安全或实现细节。是否“充分缓解”仍是需要说明理由的判断,模型提供提问框架,不能代替人决定风险是否可接受。
3.7 计划式设计与演进式设计
演进式设计让设计随着实现增长。重构保持既有行为并改善组织,测试帮助发现回归,持续集成帮助团队频繁整合;这些支撑实践能减少不协调设计,却不证明任意改动都安全,架构规模的变化也超出单个小步重构的简单想象。演进式设计的能力与局限保留原书的历史讨论范围。
计划式设计先处理关键结构,多个团队开始工作前约定顶级组件、连接器和性能预算,局部内部设计仍可后续完成。计划式设计的适用场景说明代码反馈仍不可少。最小计划式设计只先处理最大的风险,把其他部分留给演进;最小计划式设计与必要张力解释早决策帮助全局协调、晚决策吸收更多信息的拉扯。原书引述的20/80是个人估算,不是通用配方。
3.8 软件开发过程
软件开发过程协调的不只是工程活动,也包括上市时间、客户接受、人员与交付风险。工程师可以把技术问题解释成失败概率与后果,经理据此与其他风险一起取舍;风险是工程师与经理的共同语言说明这种协作。
有些缓解办法内嵌在过程里:短迭代帮助尽早获得反馈,里程碑文档帮助跨团队沟通。风险内嵌进开发过程的利弊解释复用经验的收益和照搬的代价。调整过程要看规模、分布、领域与客户,而不是只看某本流程手册。
3.9 理解过程变化
本节用“可选预先设计+若干迭代”比较五类过程,表3.4已实际查看。为便于比较,瀑布被看作一次长期迭代;普通迭代过程允许返工,但自身不规定按风险或价值排序;螺旋过程按项目风险安排迭代;UP/RUP强调早期架构风险;XP强调客户价值及演进式设计,也可能有第0迭代。五种开发过程对设计工作的安排保留这组比较。图3.1中设计时间阴影随迭代变化,示意工作量要跟着认知到的风险变化,不是固定比例。
3.10 风险驱动模型与软件开发过程
风险驱动模型只回答设计活动的问题,开发过程则安排整个项目。瀑布中可把它放入分析设计阶段,迭代中可在每轮及必要时使用;螺旋和RUP虽已按风险排序,仍需要它帮助选择具体设计技术。五种开发过程对设计工作的安排可回看两者范围。以功能价值为排序中心的XP,需要进一步把风险引入待办项,下一节给出一种做法。
3.11 应用于敏捷过程
把架构风险纳入敏捷过程,可以在有时间限制的第0次迭代调查已知选择,在日常迭代内及时解决小风险,再把较大风险写成可检验的待办项。特征与风险并存的待办项保存这套安排。产品负责人负责功能和统一排序,开发团队添加技术风险并解释后果;每轮末尾要重新评估剩余风险。图3.2显示团队向待办项反馈识别到的风险,避免它们一直隐藏在功能列表之外;这不是延长第0迭代来做完整预先设计的理由。
原书依据 · 1 处
3.12 风险与架构重构
开发推进会带来新认识,设计不可能只在项目起点发生。架构重构是影响系统结构的大范围重新设计,通常比局部修改昂贵。风险驱动架构重构用Rackspace三代系统说明,是否值得改变既有架构要看继续保留它会带来什么失败风险,而不是只因今天想出一个更漂亮的方案就全部推倒。
原书依据 · 1 处
3.13 风险驱动模型的替代方案
不做设计、完整文档包、固定比例预算、凭经验临场判断,分别有适用处与局限。编码前一刻也在作设计;完整文档可能帮助协作,却不是所有项目都需要;经验判断有效,但不说明理由就难以传授。衡量标准法的价值与局限说明原书引用的COCOMO比例只可提供预算启发,不能决定具体技术或停止日期。风险已缓解不应为凑预算继续,风险仍高也不应把预算用完当作安全证据。
原书依据 · 1 处
3.14 小结
本章先选择高风险问题,再挑选能产生有效证据的技术,最后检查剩余风险。它允许设计发生在前期或开发途中,也承认技术分析不能取代项目整体取舍。本项只是收束前述机制,没有独立新增卡;下一项把这种方法与其他研究对照。
3.15 延伸阅读
风险驱动模型把“为什么做某项活动”公开成可讨论的理由。螺旋模型负责整个项目,全局分析覆盖组织、技术和产品因素,属性驱动设计用质量属性选择策略,而本模型更关注风险对应的活动及投入;全局分析与属性驱动设计保存对照。
本节还给出几种延伸。按可市场化特征增量构建说明按可交付内容组织架构建设的主张;风险管理论坛协调跨项目风险记录组织层面的研究建议;需求可变时用风险裁剪范围区分既定需求下的设计选择与需求可变时的范围选择。其余关于风险识别、最小充分模型、模式语言与敏捷实践的资料逐项登记;本节没有提供这些方法的完整实施流程,不能将推荐阅读记作已深读。
第4章 实例:家庭媒体播放器
家庭媒体播放器案例展示三类连续出现的风险。原型已能播放本地或网络媒体,但新加入的异地开发者可能不理解设计,新的现成组件可能无法集成,第三方插件也可能无法把内部元数据与外部信息对应。本章每次先问会怎样失败,再选择沟通、建模或原型手段,并根据获得的证据决定是否继续。案例假定需求和质量优先级已被理解,不代表这些前提在真实项目中可以省略。
4.1 团队沟通
新成员加入时,设计若只在老成员脑中,代码就可能逐渐偏离原意。架构侵蚀与架构偏移保存本例现象。让新人读代码成本起初较低,但目录只能提供组织线索,无法自动证明模块边界及依赖;代码也不一定清楚表达设计权衡,见代码无法替代设计沟通。
团队于是逐步补充信息:先用模块图明确依赖,再记录质量属性优先级与设计理由,然后给运行时组件、连接器及典型场景。渐进式文档创建策略说明每增加一部分就重估沟通风险。本例单机部署已明确,因而不再专门画部署图;这是风险取舍,不是对所有部署图的普遍结论。
系统优先考虑界面响应与播放流畅度,其次才是可靠性、可修改性、播放效率及可移植性。暂停指令应在50毫秒内得到执行,耗时更长的网络操作需要及时反馈;参考硬件应流畅播放参考视频。这些高优先级且有技术挑战的场景构成架构驱动的判定标准。进程隔离、共享内存、内存缓冲及限制元数据写入者等决策,应能沿这些目标说明理由。
模块图的依赖表示修改影响;组件装配中的连接器表示运行时通信。模块依赖与运行时连接器的区别解释为什么两幅图不应混用。表4.1把组件与连接器的职责列成文字模型,按通信约束区分连接器保留其中通信方式的区别。暂停场景依次经过用户输入、播放内核、渲染/播放组件,渲染端冻结画面并暂停音频后反馈,内核再更新状态;场景说明协作,不能凭一次轨迹推断所有行为。图4.1—4.4和表4.1均已实际查看。
4.2 COTS组件的集成
COTS表示现成可复用组件,本章也把开源或非营利团队组件包括在内。引入跨平台音视频组件和NextGenVideo后,风险包括能否集成、崩溃是否影响全局、屏幕菜单是否仍能显示及延迟是否达标。先解决能否集成的问题,再判断其他属性。
边界模型列出媒体输入、媒体输出、命令和状态四个端口,还要标出“显示已初始化”“独占显示”“等待命令”这类使用假设。边界模型识别架构不匹配说明接口签名之外的条件。端口适配器整合通信约定保存命令、状态和缓冲适配器怎样把新组件接入既有通信的方案。这里事件队列的绑定涉及三个端口,也提醒架构抽象与代码对象未必逐一对应。
独立进程让视频组件的崩溃较易隔离。团队监听状态更新,缺少更新时怀疑失效,在启动替代实例前终止旧进程。心跳检测隔离不可靠组件记录原书原型中约1秒恢复的结果,明确不是本次实验。原文把使这种恢复更容易的进程结构称为专注架构的设计。
为解决显示争用,叠加渲染化解显示资源争用说明在视频层之上增加透明覆盖层,并让适配器分发相应指令。主循环归谁控制仍需谨慎处理,不能靠图看起来合理就认定无误。最后,已有完整原型而关键时延未知时,直接计时比给模型填猜测值更有用;原型测量优于建模估算延迟保留这次技术选择的条件。图4.5—4.8均已实际查看;原型和故障模拟的运行结果均属于书中案例。
4.3 元数据一致性
元数据描述媒体数据,例如歌曲名称、艺术家、专辑与年份。若插件要读取歌词、传记或相关音乐,内部模型不仅要能保存这些字段,还要能够对应外部信息中的概念关系。实际抓取网页做完整插件会耗费大量与当前问题无关的工作,因此领域建模比完整原型更便宜讨论本例改用概念模型的收益和局限:模型不能替代API调试,也不会产出可运行插件示例。
团队挑三个代表性插件限制分析范围,避免为了覆盖整个音乐领域而无限建模,见选代表性样本避免分析瘫痪。原有模型有Artist、SongTitle、Album;SongTitle保存Year与Genre。把Prince等具体对象填入模型后,发现它不能表达个人与乐队之间的关系,也不能表达同一人的多个艺名。用具体实例快照检验模型缺陷说明类型结构看似合理、实例仍可能揭示缺口。
原书研究的MusicBrainz模型通过ArtistRelationship表达艺术家关系,并区分组与个人。最终本例并未照搬全部模型,而为Artist增加isGroup,增加pseudonym和memberOf关系,支持所选场景;按使用场景扩展领域关系保留修订选择。这只是缓解代表性场景的风险,没有实际建立全部插件,更不证明未来所有扩展都能成功。图4.9—4.12均已查看,相关数据库模型按原书历史描述解释,不当作当前MusicBrainz结构调查。
4.4 小结
案例的共同结构是“风险—技术—证据—剩余风险”。沟通采用逐步补充的模型和说明,组件集成采用边界模型、场景与原型,元数据兼容性则先用有限范围的领域模型。选择可以被不同工程师质疑,但理由已经明确,能够比较成本与效果。交付对象始终是能工作的系统;模型是降低不确定性的工具,不能把文档写完当作风险消除。本节收束前面各卡,不另重复生卡。
第5章 建模建议
第1部分最后一章把风险驱动架构落实为使用建议:理解系统、共享知识,让决策顺着质量属性优先级进行,同时警惕过早的大量设计和单向分解。本章也主动列出估计、比较模型与跨组织决策的困难,为第二部分学习模型工具设定边界:会画模型并不意味着已解决这些判断问题。
5.1 专注于风险
按风险选择技术,是把有限时间放到当前最重要的失败可能上。技术与风险的映射需要具体经验支持,不同领域会因风险不同而采用不同语言、分析和协作方法;这些是原书举例的背景,不能据此给所有当前项目按领域指定语言。技术选型要计入机会成本可联系理解:时间花在某项技术上,也就失去处理其他风险的机会。模型可嵌入前期设计或敏捷过程,区别在何时使用以及针对什么风险。
5.2 理解你的架构
理解架构,是把知识和抽象内化,使自己能分类观察、解释质量取舍、理解各部分如何协作。它不要求统一编程语言、固定过程或必画纸上图,也不阻止深入代码与算法。概念模型加速学习并解放思维说明这种抽象怎样支持推理。实际问题仍需要恰当细节,而不是只停留在架构名词。
5.3 传播架构技能
架构知识应成为全体开发者可以使用的能力。懂得质量属性与设计约束的人,更容易作出合适的局部决策,也能把日常代码中影响整体的信息反馈给架构工作。架构知识应分散给全体开发者保留这种双向作用。大型系统可以分工并设置专门角色,问题在于囤积知识而不共享;“未来十年”的教育预测属于原书写作背景,不当作本次已发生事实。
5.4 作出合理的架构决策
合理决策要能说明:哪项质量目标优先,因此选择何种设计,并接受什么代价。合理架构决策的三段式模板用避免供应商锁定与性能优化的例子保存表达方式。开发者的熟悉领域和直觉可能悄悄覆盖项目优先级,例如本应优先可维护性,却习惯性为了查询速度降低结构清晰度。
方案争议应把各自偏重的属性公开。一个方案提高可用性、另一个提高可测试性时,需要先确定项目当前的优先级,而不是争论谁更会设计。用质量属性优先级化解设计分歧说明这种转换不自动产生答案,却让论据可比较。
5.5 避免预先大量设计
预先大量设计把项目前期大量时间投入设计,可能设计了错误重点、缺乏运行反馈,或在系统形成前已耗尽资源。BDUF的三大陷阱与两种变体保留“设计直到完美”和“为建模而建模”的风险。原书并不要求所有前期分析都取消:对于高技术或安全风险,较多前期投入可能值得;关键风险得到足够处理后,应及时用原型或实现取得反馈,而不是继续追求图纸完美。
原书依据 · 1 处
5.6 避免自顶向下设计
自顶向下设计从高层元素逐步分解出低层职责与结构。它可以提供组织框架,但若只允许从上往下推,会晚发现低层模式与现成组件的不适配,也可能因最初分工把系统结构固定下来。自顶向下设计的三个隐患说明这些风险。细节层也能产生影响全局的洞察,例如借框架中的命令队列实现质量目标;保持自底向上的反馈比把所有设计想法都预先排进分解树更重要。
原书依据 · 1 处
5.7 余下的挑战
风险驱动方法仍有四类挑战。首先,未知风险难以识别,严重程度也容易高估或低估,见风险估算的两个难点。其次,候选架构的真实问题可能藏在细节中,但为尚未选中的所有方案补齐细节成本很高;评估架构候选方案的内在矛盾说明模型、原型与信息不足之间的取舍。
第三,模型为了某个问题而省略的信息,在另一个问题中可能必不可少。列车调度模型没有采购价格,就不能直接回答折旧问题;模型因省略细节难以跨目的重用保留这项限制。最后,方案涉及站点部署和运行管理时,选择也可能由组织成本与职责决定,工程决策与管理决策的边界选择说明不能仅按工程实现判断。
5.8 特性和风险:一个故事
手机遥控应用有大量功能,仍可能因为质量问题难用:连接失败全报同一错误,用户无法定位原因;不缓存变化很少的封面和歌曲列表,使每次导航重复等待服务器。架构缺陷伪装成孤立功能问题说明两个症状共同指向通信库及接口选择。
改进方案应区分错误状态,并让接口能够适应缓存;缓存量则受手机存储约束,不能把所有数据无限缓存。通信接口容纳诊断与缓存保存这项可演化性考虑。原书还设想客户端—服务器能否改为设备间彼此提供媒体的对等方式,这是候选思路,没有给出完成实现或效果测量。这个故事的结论是把风险和质量与功能同时考虑,相关分析活动不必遵循固定顺序。
第6章 工程师使用模型
模型是针对问题保留特定信息的表示。复杂问题难以直接在现实对象上推理时,可以先把问题转换成抽象模型,在模型里求解,再把结果解释回现实。通过抽象模型求解现实问题保留这条路径。图6.1的直接箭头表示简单问题不一定需要绕行,较长路线表示抽象提供可操作的求解空间;目的不是让所有问题都画图,而是获得可靠的理解和解决手段。
6.1 规模与复杂度需要抽象
少量类可以直接检查,协作类变多时可以借设计模式理解,再扩大时需要更高层的抽象。抽象层次取决于要解决的规模和复杂度,不能强迫所有问题都用同一层次。给同事讲解整个系统时,适当模型比逐行读几万行代码更容易呈现结构;通过抽象模型求解现实问题可联系理解这种映射,但深入细节仍可能是验证模型所必需的。
6.2 抽象提供洞察力和解决手段
抽象既能揭示问题的关键关系,也能提供求解手段。两车相距3000米、同轨相向匀速行驶,速度每秒10米和20米时,把时间设为x秒,得到10x+20x=3000,解得x=100秒,再将它解释为相遇时间。这里把距离、方向、速度映射成代数,省略了颜色等无关信息。通过抽象模型求解现实问题保存通用路径;实际场景若不满足同轨相向、速度不变等前提,就不能直接套这个方程。
6.3 分析系统质量
分析质量需要组织细节,而不是只比较技术名称。原书网站案例中,一种数据表示让每个页面请求查20次数据库,另一种只查1次。图6.2把时延分成消息传输、服务器处理和数据库查询,让主要影响能够显现。剥离无关变量定位真正瓶颈保存教学计算:10+10+20×25=520毫秒,而10+10+1×25=45毫秒。
这些是原书模型中的示意数值,省略缓存与队列等因素;它们支持定位值得验证的瓶颈,不是本次实测,也不足以单独推导并发系统吞吐量。
原书依据 · 1 处
6.4 模型忽略细节
模型有用,是因为它把与当前问题无关的信息删去,但不能删去决定答案的因素。寻最短路线时,道路标志的材质通常无关,一条可通行的窄路却可能改变结果。模型的价值在于取舍细节说明完整与易分析之间的权衡。模型太大可能无法使用,模型太简可能给出非最优或错误答案;应根据要回答的问题明确哪些限制仍能接受。图6.3也提醒读者,建模的目标是增强推理,而不只是得到规范表示。
原书依据 · 1 处
6.5 模型能够增强推理
建模技能有三个层次:能读懂已有模型,能把想法准确写成合乎语法的模型,以及能借模型发现错误、协调细节、形成更好的设计。三层建模技能用购房者、绘图员和房屋设计者区分这些任务。画得规范不等于设计得好,能够读模型也不等于已用它作出推理;软件开发者的目标是让模型帮助回答原本难以靠记忆处理的问题。
6.6 提问在前,建模在后
建立模型前先确定它要回答什么。时延模型未必能发现安全漏洞,因为两类问题需要的信息不同;先明确问题,才能选择抽象层次与必要细节。提问在前建模在后保留这条规则。它承接上一节:增强推理不是在现成图上附会问题,而是让问题决定模型应包含什么。
原书依据 · 1 处
6.7 小结
本章把模型作为解决复杂问题的工具:先映射现实问题,再利用抽象关系求解,最后解释结果;同时根据问题取舍细节。理解、编写与推理是不同能力,不能用图表数量衡量是否真正理解了系统。这是前文五张卡的收束,没有独立增量,因此不重复成卡。
6.8 延伸阅读
本节交代交互图的来源,并指出不同开发者的建模专长可能不同。选择培训时应区分课程是在教读模型、写模型,还是用模型推理,见三层建模技能。这里提供阅读和学习方向,没有展开新的建模算法或技术。
第7章 软件架构的概念模型
概念模型是一套帮助识别和分类所见现象的知识结构。它让开发者像熟悉比赛的教练那样,从零散代码和行为中看出系统安排;学习已有概念再反复实践,比只靠个人多年摸索更容易形成可以交流的理解。概念模型加速学习并解放思维保留其学习和推理作用。
使用模型不等于每个项目都要文档、不等于文档必须全面,也不等于设计必须作为一个完整阶段先于编码。关于架构文档的三个误解区分“编码前需要想法”与“整个设计过程必须先完成”。本章用招聘社交网站Yinzer作例子,将模型分成领域、设计和代码,并说明怎样用视图和对应关系把它们联系起来。
7.1 规范化模型结构
面对一幅招聘广告与公司的类图,需要先知道它画的是现实概念、设计选择还是数据库实现。规范化模型结构用领域、设计、代码三类模型分类这些事实,让分析一个层次时不被其他层细节淹没。领域设计代码三层模型结构保存三类对象的区分。视图再从各模型中挑出当前所需细节,不要求一次写出整个模型。
7.2 领域模型、设计模型和代码模型
领域模型描述当前问题中应视为给定的领域事实,例如广告、联系方式及它们的关系;这些不是软件设计者能随意改写的决定。设计模型描述准备构建的系统,包括对外可见的边界模型和更详细的内部模型,可以暂缓承诺一些实现细节。代码模型则对应实际源代码或与代码同层次的表示,至少具体到足以运行。领域设计代码三层模型结构保留这种分工。
图7.1显示内部模型可以继续包含子部分的边界与内部模型,层层细化。“领域的不变事实”应理解为此处建模的给定条件,不表示业务规则或现实世界永远不会变化。
7.3 指定与细化关系
指定关系解释领域元素与设计元素的对应,例如领域中的工作和联系方式怎样映射为系统类型。指定关系连接领域与设计提醒,系统常采用简化表示,例如把两个邮箱当作两个人,需要知道这会遗漏什么关系。
细化关系则连接同一对象的不同细节层次,如外部边界与内部设计、设计与实现。细化关系与设计代码鸿沟说明有些结构能映射到包和类,但质量预算、约束和风格未必直接显现在代码结构中。图7.2和7.3已查看:后者实际显示设计模型到代码模型的细化,旁文强调表达落差;不能将图7.3复用的“领域到设计”图注当作其真实箭头含义。
7.4 主模型的视图
视图是主模型细节子集的投影,也可能转换表示方式。一个领域模型可以有类型列表、实例快照和行为场景;设计模型可以有上下文图和部署图。视图是主模型的一致投影说明视图不是各自独立的抽屉:同一个概念或关系在不同图中应保持一致,改了主模型的理解,也要检查相关视图。
主模型可以描述已有系统,也可以是计划中的系统,甚至只存在于团队的理解中;它不要求已经存在一个大而全的文件。图7.4从领域模型投影到概念、快照和场景。使用多个视图的目的,是控制每张表示的大小与关注点,并检查它们合在一起是否讲述同一系统。
7.5 组织模型的其他方式
其他方法可能使用不同名称来组织相近内容。要比较模型,不应只对齐名字,而应检查它描述的是业务目标、现实概念、边界约定、内部设计还是代码。领域设计代码三层模型结构提供本书的分类框架。需求模型尤其容易与这些层次重叠,因不同作者对“需求”的边界不同;这种重叠不能仅凭名称就认作错误。表7.1在后续业务建模项中实际查看。
7.6 业务建模
业务模型描述组织做什么、为何这样做,以及策略、能力、流程与目标。同一领域的两个企业可能采取不同业务模型。领域模型则在本书分工中集中描述系统相关的领域事实。业务模型与领域模型的取舍说明为什么作者聚焦工程问题而没有把业务模型列为三大主模型之一,这不表示业务误解不影响项目。
表7.1已实际查看,对照Bosch、Cheesman与Daniels、Map、SEI、Jackson、RUP、Syntropy的模型名称。它提供理解不同方法的参照,不能视作所有方法在范围和语义上完全等价。
原书依据 · 1 处
7.7 UML的用法
UML是本书采用的常见建模记号,但阅读时仍需看每张图的约定。连接器可用不同线型,端口类型可能写成文字,也可能用阴影并配图例,以减少混乱。按图例解释端口和连接器说明不能把本书图形约定推广为所有工具或UML图的统一含义。模型语义与实际表示方式需要分别理解。
原书依据 · 1 处
7.8 小结
本章用三类主模型把抽象层次分开,用指定与细化连接它们,再用视图放大当前细节。这样既不把所有事实混成一幅大图,也不让许多小图失去共同参照。实际仍只建立与风险相关的子集;学全概念不等于每个项目必须画全所有模型。本项收束前文,不另重复生卡。
7.9 延伸阅读
本书的框架结合功能建模、质量属性分析和敏捷实践。延伸资料提供不同侧重:组件规范用前后置条件帮助捕错,质量属性方法强调性能与安全等分析,多视图方法围绕不同问题组织架构。活动规范:前置后置条件串联视图保存前后置条件的用途和成本;该卡主要讲解仍在后文。
视图的组织也不只有一种原则。架构视图回应利益相关者关注对照本书的一致主模型投影与此处介绍的历史标准对利益关注的强调。集成程度应匹配业务战略则提醒软件的互操作目标仍需服从业务选择。其他著作、4+1与西门子视图集、业务流程建模等按原文推荐登记;阅读推荐不是本次已读这些外部著作或已核验其当前版本。
第8章 领域模型
领域模型描述与要构建的系统有关、但不由软件实现方式决定的概念与事实。它可以包括人为形成但在项目范围内稳定的概念,例如职位与广告,不能把“永恒”理解为只允许自然事实。领域模型是团队共同语言说明它怎样让专家与开发者一起检查定义、关系与行为,而不先陷入编程语言和数据结构。模型是否值得建立,取决于领域误解会带来什么风险。
8.1 领域与架构的关系
两个故事说明领域理解会影响架构。手机与邮箱的联系人虽有相似字段,却可能承担不同使用目的;直接同步合并让通讯录膨胀,查找变难。合并不同领域概念损害可用性区分实际叙述的1400联系人与假设的误拨情景,避免把可能后果当作事故。
授权产品的活动类型会让类别权限变化影响已有用户,模板类型则可能只影响新加入者。消息格式和服务器规格一致,仍不代表这些语义一致;领域假设差异导致集成不兼容保存该区别。这里是金融公司采购授权产品的集成场景,未描述并发扣款或越权损失,不补造资金事故。
对建模的六种担心——已懂领域、领域太简单、与架构无关、需求属别人、最好边编码边了解、可能分析瘫痪——都需要结合风险判断,见六种反对领域建模的理由及反驳。限制范围的方法是先提问题、决定调研深度和广度,再比较继续建模与做原型的价值,见避免领域建模分析瘫痪的三项技术。
8.2 信息模型
信息模型首先是一份类型及定义的列表,再说明类型之间的关联。表8.1用广告、公司、个人、联系、受雇、职位和职位匹配澄清词义;图8.1表示每个Contact涉及两个人,每个Person可以拥有多个联系,每个职位匹配关联一个人与一个职位。信息模型只描述事实不代表设计保存这些领域意义。
领域类图中的线不是内存指针,类型不是数据库表设计。简化记号便于非程序员专家理解:用类型、实例、关联、连接、多重性和角色名,复杂细节可以加文字,不必依靠读者熟悉全部UML。图表及定义已实际查看,属性也应先按领域含义解释。
8.3 导航和不变量
不变量规定合法模型状态必须满足的条件,导航则沿关联引用对象。例如从某个人通过network得到其联系,再通过person得到联系涉及的人。角色名给路径以可引用的名字,多重性规定一端可以有多少对象。不变量形式化思考的价值保留自然语言与OCL表达的区别。
原文以人数等于联系数加1作约束示意。按图8.1允许零个联系的多重性,空网络沿集合导航仍为空,0不会等于0+1;因此不能把原式未经处理地当成所有状态的完备约束。这个边界是读者结合已核验OMG集合语义作出的推导,没有运行OCL编译器,也没有修改原书证据。形式化是帮助检验想法,不能用符号形式替代正确性检查。
原书依据 · 1 处
8.4 快照
快照描述某一瞬间的具体实例和连接,信息模型描述它们的类型与关联。Bradley和Owen是Person实例,连接他们的无名对象是Contact实例;每个实例与类型之间具有类别关系。快照与场景刻画领域模型的动静态保存这一层次区别。
图8.2已实际查看。通过画出希望允许或禁止的快照,可以发现模型缺少的条件,例如禁止一个人通过联系又回到自己;类型图看似合理,仍需要用实例检查。
8.5 功能场景
功能场景是一条可能的事件路径,描述初始快照如何逐步变化。图8.3从Bradley已在Widgetron任职开始,依次增加Owen与Bradley的联系、公司的职位广告、Owen与职位的匹配,最后Owen成为公司雇员。快照与场景刻画领域模型的动静态说明快照给静态实例、场景给变化轨迹。
只记录影响当前模型的事情,洗衣服等未建模事件可以省略;若它对问题重要,就需要同时扩充类型模型。场景里的真实人不等于计算机中的记录,一条路径也不代表所有路径;活动图或状态图能表达更一般的行为,但成本更高。
8.6 小结
把领域与设计分开,可以先回答“当前员工是否收到本公司广告”等语义问题,再决定数据库和类结构。领域模型是团队共同语言可回看共同理解的作用。领域无限丰富,模型仍要简化;本例把一条广告限制为一个职位,是建模范围选择,不是现实世界的一条普遍规律,见信息模型只描述事实不代表设计。
能否停止,要看模型是否足以回答与可用性、互操作性等风险有关的问题,以及剩下的误解是否会使系统失败。不是把所有真实事实都收入模型才算完成。
8.7 延伸阅读
本节交代本书领域建模以催化法为基础,并推荐Cockburn的用例写作著作;本节只说明其组织与停止编写的指导价值,没有展开该书流程。功能场景与用例的详细比较留在后文,不把推荐阅读当作已经完成的外部全文阅读。
第9章 设计模型
设计模型描述怎样构建一个能处理领域概念的软件系统,包含结构、行为、约束及取舍。领域给出当前需要尊重的事实,设计则有多种可选实现。本章用Yinzer从外部接口走进内部协作,再把不同图按视图类型归组,说明怎样组织大量设计信息,而不是要求一次画出所有细节。
9.1 设计模型
设计主模型是包含已知设计细节的概念参照,实际工作仍要把问题拆小。视图挑选信息,封装把对外承诺与内部实现分开,嵌套则允许内部元素继续展开为更小的边界和内部模型。视图封装嵌套组织设计模型说明三者怎样组合。图9.1把顶层边界和内部都作为同一设计模型的视图,内部通过细化保留同一个外部对象的承诺。
原书依据 · 1 处
9.2 边界模型
边界模型描述用户可见的行为、交互数据及质量要求,是接口承诺而非实现承诺。边界模型承诺须由内部模型兑现说明只有承诺保持成立,内部实现才能自由改变。顶层边界描述整个系统与外部的关系,不需要把系统每个内部组件都暴露给使用者。
9.3 内部模型
内部模型增加实现细节,细化边界描述的同一个对象。若边界承诺99.5%的时间在线、运行在Linux上,内部选择也必须支持这些条件;细节变多不允许悄悄改变外部约定。边界模型承诺须由内部模型兑现可对照这种一致性。边界与内部可以都使用场景、组件、连接器、端口和职责等元素,只是公开的信息不同。
9.4 质量属性
质量属性描述系统做事时表现怎样,例如速度、可修改性、安全性和部署便利。它们通常是整体结构与交互共同产生的结果,不能只找到一个名叫“安全”的函数就认定系统安全。质量属性是自然产生的解释这里的“自然产生”是整体涌现,不是无需主动设计。不同系统对同一功能可能有不同质量优先级,原书交换机拨号音与银行安全的例子用于说明取舍,不是当前行业规范的断言。
9.5 Yinzer系统的设计之旅
本节把外部可观察的系统逐层展开成内部协作。用例图回答系统支持哪些一般功能,功能场景给出一个具体调用路径;图9.2—9.3中邀请、接受邀请、发布广告、匹配和更新简历形成一条路径,却没有证明所有合法事件只能按此顺序发生。用例图与功能场景的分工保留这一区别。场景省略暂不影响问题的界面操作,可以让设计保留空间。
系统上下文图突出系统与外部系统怎样通信。图9.4包括Yinzer、两种浏览器使用场景、两个邮件客户端和邮件服务器,矩形表示组件实例,同一类型可以有多个实例,见系统上下文图与组件实例。端口把相关交互分组,连接器表达运行时通道;端口区分提供与请求服务说明提供Web服务与请求SMTP服务的不同依赖。连接器的吞吐量、同步性或加密是要显式赋值的模型属性,书中示例值不是协议自动提供的保证。
模块视图看代码制品和依赖,部署视图看组件或模块分配到哪台机器、节点之间怎样通信。图9.5显示外部可见的端口相关模块,内部实现模块保持私有;图9.6显示主备数据中心、路由器和用户PC的部署,不意味着仅画两中心就已证明故障恢复。重大设计决策应说明选择与理由,可联系合理架构决策的三段式模板理解怎样把意图公开。
质量属性需求先排序,再写为具体场景。表9.1实际含六项:源、触发、环境、制品或作用对象、响应、响应测量;示例是用户在正常运行时请求页面,整个系统在一秒内返回。原文邻接概述漏列制品,这里按实际表格补齐。利益相关者评重要性,开发者评难度,既重要又困难的场景值得作为架构驱动重点处理。质量属性场景与架构驱动元素保存评级方式及场景模板。
权衡说明为什么某种设计让一项工作更容易、另一项更困难。技能写成结构化分类便于算法匹配,却可能增加填报负担;自由文字容易填写,却让匹配更模糊。权衡是领域中的洞察力金矿记录这种领域洞察,不能推导成所有安全措施都会降低易用性。
内部组件装配保留同样的外部端口,再显示Contacts、Advertisements、Users与Emails怎样协作。绑定把外部端口的交互交给内部兼容端口,它是封装映射,不是一个独立执行工作的连接器,见绑定连接外部端口与内部端口。两级场景保持外部编号步骤,再用字母细分内部查询用户、生成邀请、交给邮件组件等动作,让内部合作可以与外部承诺对照。
名称不足以说明所有行为,职责说明消除名称歧义解释为什么应补职责表或文字。约束则限定允许的设计与行为,以便分析内存预算、平台依赖或响应路径,见约束是分析的前提。异步邮件不阻塞页面响应给出具体例子:慢邮件进入异步队列,Web路径不用同步等待,但仍需验证整体时限。重复出现、被命名的一组元素和约束构成架构风格;架构风格是被命名的约束模式说明其共享词汇与限制作用。图9.2—9.8和表9.1均已实际查看。
9.6 视图类型
视图类型把较容易相互对应的视图归组。模块视图描述源代码、类型、接口和依赖;运行时视图描述实例及协作;部署视图描述软件到硬件与地点的分配。另有跨类型的Spanning视图,例如质量权衡。视图类型分组标准架构三视图对应图9.9与表9.2,这些视图可以在运行前绘制,不能将“描述运行时”误读为“文档只在运行时存在”。
类型定义与实际实例分属模块和运行时关注,见类型与实例分属不同视图类型。从代码推想实例数量和连接关系通常费力,跨视图类型思考的困难与应对建议用清楚的代码结构减少鸿沟,同时从适当视图直接回答问题。
分开后还要重新联系:场景可以说明配置怎样创建实例、部署变化如何影响行为,权衡可以连接可修改性与性能。场景与权衡串联视图类型保存这种整体理解方式。讲解系统时要考虑每种视图类型是否存在别人不知道的假定,不把只画自己熟悉的图当作已经完整沟通。
9.7 动态架构模型
动态架构模型描述组件配置在执行中怎样变化。装配图常画稳态,但系统还会启动、关闭或因节点加入离开而重组;忽略这些阶段可能漏掉错误。动态架构应尽量避免的两个理由保存原书偏好稳定结构的原因:易理解、易分析质量。此处经验和工具不足的判断属于写作时背景,不当作当前平台现状;需要动态变化时应描述它,而不是靠省略让图看起来静态。声明式配置是原书给出的一种帮助理解结构的手段。
原书依据 · 1 处
9.8 架构描述语言
架构图也使用语言,有允许的元素和关系,也应有可理解的语义。通用画图工具允许任意形状,不会自动告诉读者紫色三角形是什么;专门工具能帮助限制记号,却不能保证设计有意义。建模语言的约束与意义说明语法正确与语义正确的区别。
默认使用UML的务实理由保留原书以工具支持、读者基础及跨模型使用能力选择UML的考虑。这些是原书历史论证;当前选型应核对团队真正使用的工具和表达需求,不能把书中的最大群体之说当作本次市场调查。
9.9 小结
本章把设计模型分成边界和内部,并用视图、封装和嵌套控制信息量;把不同问题按模块、运行时、部署及跨类型视图组织,再用场景和权衡建立联系。接口承诺、领域对应和质量目标都需要内部设计支持。这里是前述机制的收束,不另重复生卡;信用卡协议等只作信息种类举例,没有具体资金错误情节。
9.10 延伸阅读
本节说明功能建模受催化法的细化思想影响,质量建模受SEI方法影响;Acme和Acme Studio把风格形式化,其他著作比较建模语言。它们是进一步学习的入口,不等于本次已验证这些工具的当前能力。功能与质量的联系、约束与风格的作用已在本章卡片和讲解保留,未展开的资料按引用登记。
第10章 代码模型
代码既是交付物,也是表达解决方案的媒介。架构模型需要与代码关联,才能指导构建和演化;但结构、约束和设计意图未必都能逐项映射。本章先解释差距,再讨论同步模型和代码的方法,最后展示怎样让代码留下架构线索。
10.1 模型-代码差异
模型与代码在词汇、抽象、设计承诺和规则表达上不同。模块与包可能只是命名差异;一个组件也可能聚合多个类;架构可以先承诺质量要求,而代码还须决定具体算法。外延式表达枚举系统有哪些元素,内涵式表达跨元素成立的规则,见内涵式与外延式元素的映射差异。
图10.1与表10.1—10.2已实际查看。结构较容易细化成代码,风格、不变量等意图未必显式出现;这解释了差距,不能推广为所有语言与工具都不可能检查通用规则。模型代码差异不必消除只能管理说明生成工具和人为控制都可以帮助管理,原书对MDE成熟度的评价属于历史背景。
10.2 一致性管理
模型和代码各自演化,会产生程度不同的分歧。处理方式包括允许并说明旧图偏差、需要时临时建模、只维护概要模型、在里程碑同步、在问题出现时同步以及持续或定期维护。六种管理模型代码分歧的策略保留这些选择。表10.3—10.4已实际查看,选择要看工具支持、模型细节量和允许偏离的程度;安全分析所依赖的规则若已失真,不能因“概要还像”就继续使用。原书对策略常见程度的描述不是本次团队调查。
原书依据 · 1 处
10.3 架构明显的编码风格
架构明显编码是让源代码中的结构、名称和约定提示其架构模型,帮助读者理解与演化。代码能跑是最低要求;让维护者知道职责和理由,通常需要额外表达。模型嵌入代码原理与技术债可以联系理解其目的。线索能够减轻文档压力,却不能自动取代所有外部说明和模型核对。
10.4 在代码中表达设计意图
解决方案显示走通的一条路,未必说明为何没选其他路。意图命名解释为何执行操作用highlightText()保存高亮目的,而不是只留下反转颜色的步骤。按合约隐藏实现细节则以调用前后条件及不变量把可依赖的行为明确化。
软机制与硬机制的区分区分人理解的名称、注释和机器可检查的约束。同一种表示是否真正受强制,要看实际检查机制;写了“禁止通信”的字句,并不自动意味着工具会验证它。
10.5 模型嵌入代码原理
模型嵌入代码原理主张:在代码中表达模型有助理解和演化。领域中的账号、地址等概念可以帮助组织类和职责;架构中的组件、连接器也能提供类似线索。模型嵌入代码原理与技术债说明代码模型与团队新理解之间的分歧怎样成为可见的修订对象。
原文也承认没有受控实验来证明该原则,其论据包括历史实践与便于推理的理由;不能写成普遍已证实的性能收益。它对DDD“反对纸上模型”的概括限定为原书解读,不据此把所有领域驱动设计实践都说成禁止建模文档。
10.6 表达什么
模块定义在代码里通常比较直接,运行时实例配置需要阅读创建与控制流程,部署则还要知道机器、网络和发布材料。三视图类型在代码中的可见度保存这种不均衡。代码结构并非对三类问题都同样有用,也不能由原书的语言能力评价推断当前所有模块系统的局限。
原书依据 · 1 处
10.7 在代码中表达设计意图的模式
在代码中表达架构,可以从具化开始:把隐含概念变成显式对象、命名约定、标记或注解,见具化把架构抽象做成可见代码元素。集中组件间通信的连接器,还能承担部分协议与并发职责,但必须检查组件是否绕过它,见显式连接器转移职责实现灵活替换。
显式端口集中表达协议说明提供/请求端口、状态检查、违规日志与人可读约定的作用。属性和风格需要可识别线索把属性、命名、注解和架构风格词汇联系起来;约束可见性不等于自动强制提醒API、断言与注释各有范围,模糊的“增量式”要求必须先澄清。表10.5已实际查看,其十组模式均有相应去向。
模块依赖与访问限制,可以由语言、工具或组件框架部分检查,也可以仅靠软约定提示。组件框架以清单声明依赖说明原书OSGi与.NET的例子;Java 7计划和平台能力都限定为原书时代。对齐模块组件并集中启动解释怎样让代码分组、创建和连接过程帮助读者重建结构。动态系统还需限定并说明可变化的操作。
最后,反面模式藏宝警示不要让方法名暗示取值,内部却偷偷产生重要副作用。即使有这些线索,跨对象约束和重大设计理由仍可能丢失,不能说架构已经完整自动编码。
10.8 电子邮件处理系统预演
邮件应答系统先清理文本,再标记内容并行提取特征,最后分类,自动回答或转人工。图10.2—10.3显示处理结构与包组织;基础设施、具体组件和交换数据的包分开,有助定位,但目录层级本身不表示所有依赖。
并发问题的架构级托举案例结合图10.4—10.6的真实Filter、Pipe和启动代码说明集中并发责任的意图,并给出实际类图。Filter实现Runnable,由run调用work;Pipe用阻塞队列组织消息。正文期待的“每过滤器独立线程、空时等待读、关闭后拒绝”等性质,不能仅凭类名确认。
实际图中,blockingRead()先见空就返回null,close只改布尔值;无参队列容量为Integer.MAX_VALUE,发送对象也未克隆;启动片段直接run(),并未显示创建新线程,而Filter异常时调用System.exit(1)。这些限制已根据图片及固定Java SE 17官方API核验,明确属于读者代码分析,没有运行例子。设计集中可以减少重复工作,但不能把线程安全队列直接提升为完整关闭协议、故障隔离或全局并发安全的证明。
原书依据 · 1 处
10.9 小结
本章把模型—代码的差距、管理分歧和留下设计意图联系起来:并非只在源码里增加架构词汇就结束,还要选择有用的表达、检查真正强制了什么,并在演化时继续核对模型。是否显式表示端口等元素应按其价值决定。本项收束前文,不另重复生卡。
第11章 封装和分割
分割决定软件怎样拆成小块,封装决定使用这些小块时需要知道什么。两者共同影响理解难度:分得很多但边界混乱,仍难以认清协作;只有操作签名,也未必足以说明怎样正确使用接口。本章从层级故事讨论分解,再用接口模型说明封装。
11.1 多层级故事
多层级故事让读者在某层只需理解一组目的明确、彼此协作的元素,再按需要深入子层。多层级故事的原则与经验法则保存四项建议:分级嵌套、限制同时观察的元素数量、每个元素目的明确、隐藏不必要细节。5到50是原书的启发式范围,并非必须满足的计数门槛。
其收益是降低认知负担、帮助理解更大系统,系统本身不会因为目录层级优雅就自动运行更快;维护这些边界也有成本,需要随设计演化调整。
原书依据 · 1 处
11.2 层级和分割
层级分割不保证所有相互作用都能藏在黑盒内。原书用服务器和航天器中的硬盘说明,同样的电力、热和力矩影响在不同环境中重要性不同,见层级分解并非总是可行。层级结构也不要求设计过程只从上往下进行,低层细节可以反过来改变高层选择。
一种组织方式总会把某个关注放在前面:书按尺寸摆容易找最厚的一本,按作者摆容易找某作者的作品。主分解的专横说明软件同样会让主关注容易处理、横切的其他关注较费力。
11.3 分解策略
系统可以按功能、典型领域类型、架构风格、质量属性、端口、跨领域抽象或既有组件来拆分,见七种分解策略总览。典型类型强调较独立的核心概念;端口分解强调访问与职责分组;拼图式设计则由现有可复用部件推动。没有一种选法自动满足所有质量要求,原文关于不用单一数据库即可轻松伸缩的表述不能当作充分条件。
ADD按质量驱动递归分解进一步展开图11.1:选择模块和架构驱动,选模式,创建子模块和接口,再用功能及质量场景验证并递归。它依赖质量与策略之间的对应,区别于仅挑一个风格名称。Ping/Echo、冗余、运行时注册、认证与入侵检测在本节只列为策略例子,未提供内部实施方法。
正交抽象借用其他领域的成熟抽象则把问题转成已有算法或知识能处理的对象,例如工作依赖图、矩阵变换。它需要找出真实的对应,不能只把名词换成图论就认为问题已解。表11.1和图11.1均已实际查看。
11.4 有效封装
有效封装让使用者依靠接口理解行为,而不必掌握内部机制;分组后暴露大量实现细节,未必减少复杂度。有效封装与低效封装的区别用工时表要求普通员工理解会计科目的例子说明:方便实现者的抽象,可能把负担转给使用者。这里没有具体账务并发或资金损失,不构造资金事故卡。
帕纳斯模块隐藏可能变化的秘密提出用不同内部方案实现同一API,检验是否真正隐藏了预期变化。单纯get/set内部数据,可能没有保留这种选择空间。接口设计也不是越预留越好,接口封装投入随误用风险调整把外部使用、误解后果和重构难度纳入投入判断。
11.5 创建封装接口
抽象数据类型用可理解的状态和操作描述行为,隐藏具体实现。栈ADT的三个核心思想解释栈的push、pop与peek,以及信息和行为一致、概念刚够使用、实现遵守约定三点。原文push示意的“非空”和“不在栈顶”与本节定义冲突;这里明确有界栈压入应未满,成功后新元素在顶部,不改动原始证据来掩盖差异。
把同样思路用于端口,先写签名与前后条件,再画操作前后快照,最后泛化类型。acceptInvitation参数虽只有邀请双方,模型仍需邀请这个概念;图11.2在接受前有Invite、接受后变成Contact,图11.3再用不变量排除同人、自有联系又邀请和重复关系等状态。两图已查看。可选择不同类型表示,只要对使用者承诺的行为一致,内部实现仍有自由。
原书依据 · 1 处
11.6 小结
分割选择主关注,封装控制使用者必须知道的东西,多层级故事把这些选择变成可理解的结构。描述接口需要签名、条件和必要类型,而不是写出内部算法。投入多少仍由风险与收益决定。本节收束前文,不重复成卡。
11.7 延伸阅读
本节交代ADT与组件接口建模的来源,并提醒ADT与对象有不同理论背景,本文为讲解暂不展开;不能把本章类比当成二者在理论上完全相同。关切分离的论文和自然系统层级组织的参考,提供进一步学习方向,没有在本节给出新的分解算法。
第12章 模型元素
本章细说构建设计模型的词汇,包括模块、组件、连接器、端口、角色、约束和场景。图书馆作为共同例子,既有馆员借还、增加和检索图书,也有借阅者查询记录。即使原书允许初读跳过本章,本轮完整升级仍把所有正文纳入阅读;名词在此前已有基础,这里会进一步比较它们的语义。
12.1 和部署相关的元素
部署元素把软件放进实际环境。模块或组件实例可以分配到服务器、PC或数据中心;环境元素之间还有通信通道,位置和网络会影响安全、可靠性及性能。部署元素承载软件环境约束说明环境嵌套、组织名称的简称以及硬件能力与软件要求的属性。不同作者可能称节点、主机或环境元素,阅读时要先确认语义,不能把部署网络通道与运行时连接器简单等同。
原书依据 · 1 处
12.2 组件
组件是运行时承担计算或存储的粗粒度单元,组件类型与实例需要分清。两个镜像数据库即使同代码同数据,仍是可分别交互的实例;模块则是实现制品分组,并非任何模块都应在运行时对应一个组件。组件模块不是类对象的类比保存这些区别。图12.1和表12.1已查看;正文对单实例和表格对多实例的措辞不能用来把数量定为分类规则。
组件可继续含子组件,但最终需落到类、函数等实现,层级由可理解性、复用及部署边界共同决定。文件或数据库也可以按系统中实际职责建模为组件,避免漏画访问;数据库类型宜说明用途,如库存或工资数据,而不只给产品名。CBD组件强调独立部署再区分可独立部署的组合单元与更宽泛的架构组件,不把历史组件市场评价当作当前事实。
12.3 组件装配
组件装配展示组件、端口与连接器的一种组织。系统上下文图把整个目标系统作为一个组件,再画相连外部系统;内部装配则细化同一个组件。例如图书馆分成馆员界面、借阅者界面、核心、库存库与借阅者库,外部端口绑定到兼容的内部端口。
组件细化的关闭语义规则说明保守细化要保持外部端口与可见约束,不能因画内部细节就悄悄增加一个从未说明的外部通道。若总览为清楚而省略日志或管理端口,应显式标注,让读者知道图不是完整枚举。
图12.2—12.4均已查看。一张实例图只是一种配置;装配多重性声明配置范围说明怎样用类型、多重性或旁注表达可存在多个馆员终端、浏览器及非共享端口。稳态也不是整个生命周期,启动或关闭的分析还需要相应状态的图。图只是设计入口,理解它还要知道类型职责、协议、质量要求和不变量。
12.4 连接器
连接器是两个或更多组件之间的运行时交互通道;角色是它连接端口的末端。连接器承担的实际工作常被低估解释转换、协议适配、协调、去重、加密与复制等实际职责。表12.2—12.4已查看:本地调用、RPC、管道、共享内存、事件等虽都实现通信,拓扑、行为协议、交换类型、交付保证和性能却不同。连接器选择牵动部署与质量把图书馆借还请求落实到这些取舍,角色检查连接两端兼容性说明连线还须满足两端契约。
连接器替换须保持交互契约把模型中独立的连接器与代码依赖联系起来:包装通信有助替换,但不同协议的次序、返回与错误语义仍须兼容。图12.5展示总线上的读、写和读写端口,总线连通不等于实际通信说明为何还需补充端到端关系。
目标连接器与微管理连接器比较“按指定步骤搬数据”与“负责维持热备同步”:后一目标促使开发者考虑丢消息、延迟、事务失败和恢复,不是宣称任何复制天然可靠。图12.6—12.7已查看,连接器细化保持外部角色说明复杂连接器可由内部组件实现,并维持源与接收角色的外部承诺。
领域连接器充当绝缘装置用监护例子说明把传感器事件映射成警报的跨领域知识集中到连接器,既保持两端专注,也促使发现传感器断开事件;这里是软件设计例子,不是临床处置建议。最后,图12.8把中介B和临时文件分别展示、隐藏进B或隐藏进连接器。连接器建模灵活性由问题决定说明这三种画法可描述同一设计:分析文件篡改要看见文件,分析抽象通信则可隐藏细节。文件存在本身也不自动证明掉电不丢数据。
12.5 设计决策
设计决策记录为什么选择当前方案,帮助读者识别哪些选择影响系统基础。关键决策记录选择与理由以原书语言选择示例说明,团队经验、可修改性优先级和性能取舍比单列语言名更有解释力。关键性意味着变更须重审相关约束,不应把原文“不能被改变”读成技术上永远不可改。
原书依据 · 1 处
12.6 功能场景
功能场景描述系统或模型沿一条行为路径怎样变化。图12.9的《白鲸》从入馆到借还、移除,使静态组件图有了时间顺序,但没回答丢书等其他路径。功能场景是一条状态路径和表12.5、图12.10一起说明目标模型、初始状态、活动者和步骤如何让故事可检查:每步引用模型中的活动和元素,结束状态衔接下一步。
外部用户活动与内部实现不能随意混在一个抽象层次。图12.11的两列把查书和加书分别映射到界面、核心与库存数据库,两级场景关联外部与内部解释这种关联。状态图、活动图和带循环注解的时序图可泛化路径,但建齐异常分支的成本更高;风险与用途决定是否值得追求完整协议模型。
12.7 不变量(约束)
不变量是对允许出现的结构和行为施加的约束,让设计可分析。禁止客户端绕过业务层直连数据库,就是缩小需要考虑的设计空间。静态不变量与动态不变量区分实例安排与运行行为;前者可写在多重性或UML注释中,后者还须表达授权、先后或因果要求。原文关于两类约束思考难度的末句解释矛盾,本笔记不从它推导普遍认知结论。
原书依据 · 1 处
12.8 模块
模块聚合代码、配置和模式定义等实现制品;接口可选择性暴露一小部分内容,模块属性还能记录语言、标准、评审及测试工具。模块嵌套不替代依赖说明结合图12.12区分包含、使用依赖和可见性。模块可按层组织,高层依赖低层是特定风格的约束;不能因为任何系统都有模块,就强画成分层系统。架构抽象与具体编程语言机制的对应仍需说明。
原书依据 · 1 处
12.9 端口
端口规定组件对外可用的操作、事件和协议,与操作系统网络端口不必一一对应。提供/依赖可标示服务关系,但不能替代发起方、数据方向或格式保证。多端口拆分的五个理由说明职责、协议、耦合、可理解性和兼容性;拆分可让馆员与Web用户只看各自所需操作。
图12.13—12.14已查看。端口实例隔离会话状态区分每客户端独立端口、共享端口及多路连接器,不把HTTP协议无状态误解为实现不会泄漏数据。端口可支持多个接口;端口协议规定操作次序结合图12.15购物篮状态机,说明接口方法列表之外仍有合法调用次序。
图12.16展示库存端口只透露Library、Copy和Book,端口类型模型限制认知范围解释封装怎样减少客户端必须理解的领域。图12.17中外部P1绑定到内部P2,内部P3经连接器连C;正文先写P1到P1的地方按图和后续P2说明理解。绑定映射嵌套组件的端口说明兼容承诺、封装映射与实际通信的差别,同时保留UML委派连接器的不同命名边界。
12.10 质量属性
质量属性描述在完成什么功能之外,系统要多快、多安全、多易修改。相同功能常有不同质量的实现空间,但两类需求并非绝对独立,不合理的组合仍可能不可实现。性能还须拆成吞吐、延迟、伸缩等可分析的方面;看运行路径可能比只看源文件更能发现慢处。表12.6已查看,区分运行时与非运行时关切;这些分类辅助选择视图,不是不同属性互斥的证明。
表12.7实际是下一节的六要素场景:利益相关者或开发者希望在设计时替换兼容PeopleDB,要求三天内完成且不改LibrarySystem代码。它说明“易修改”需要具体触发、制品、响应和测量,不能只靠形容词。 相关辨析见质量属性是自然产生的。
12.11 质量属性场景
质量属性场景把一个触发与可检验的响应相连,完整结构包括来源、触发、环境、制品、响应和响应测量。性能可规定每秒100查询时90%在1秒内且无超过5秒;这才比“快”更可验证。可修改性常需借具体变更案例衡量,少数场景也不能保证覆盖全部未来改变。
探寻时可先写草案请利益相关者修订,结合其他系统经验发现被习惯遮蔽的质量需要。架构驱动元素从重要且难实现的功能/质量场景中选取,通常分别由利益相关者和开发者评高、中、低。架构驱动元素与风险模型的关系说明其聚焦架构须支持什么,而风险驱动活动还回答做什么与何时停止;框架集成风险并不天然就是一个QA场景。 相关辨析见质量属性场景与架构驱动元素。
12.12 职责
职责可分配给模块、组件及部署环境,也可涉及功能或质量。职责由意图分配到元素用一秒查询预算说明如何把整体意图分到层与连接器,发现重要质量没有驱动依据时应回查需求。通用职责比列举约束更强区分普遍限定与有限例子;原书只在说明规则的约束力度,UI校验例子不能直接套作安全架构建议。
12.13 权衡
权衡揭示某个设计中提升一种性质需要付出的代价,可能存在于质量之间、功能与质量之间,或产品业务选择中。平台API可能使速度提升而增加移植成本,但并非任何提速都必然削弱可移植性。把权衡及其具体条件写下来,能帮助新成员理解设计空间和选择依据,衔接前述关键设计决策与职责分配。 相关辨析见权衡是领域中的洞察力金矿。
12.14 小结
本章把模型元素词汇连接成一套表达设计的工具:模块组织实现,组件承担运行职责,端口与连接器表达协作,场景与不变量描述允许行为,质量、职责和权衡解释为何这样选择。不要为炫技堆砌建模技巧提醒依问题选择工具,简单场景足够时无需把复杂连接器全用上;下一章继续处理这些元素之间的关系。
原书依据 · 1 处
第13章 模型关系
第12章给出模型元素,第13章解释元素和模型之间是什么关系,避免把所有箭头都当成一种“有关”。表13.1已查看,列出投影、分割、组合、分类、泛化、指定、细化、绑定与依赖;泛化行的“超类—超类”字样按本章13.5的超类型与子类型说明理解。房屋例子贯穿全章,使这些关系不依赖某种软件画图工具。
13.1 投影(视图)关系
投影或视图从一个特定角度选择、变换模型信息。投影视图不能添加新事实区分可从三维模型计算出的二维切面与凭空新增房间;图13.1—13.2分别展示楼面与成本表,说明视图并不只是一张结构图。地图投影在此用于说明选择与失真,不把原文地理措辞当作地图学精确定义。
图13.3中两层楼梯的位置不对应,视图冲突的三种解释说明先识别它们是需求约束、共同设计的投影,还是现实实体的表示,再定位冲突。主模型方法允许完整设计先存在头脑中,但不会免除一致性维护;人工维护多张视图时尤其需要核对。恰当视图还能让人看见排程冲突,或让算法计算税负。模块、运行时和部署等视图类型按关切组织,不应把一种物理结构图当成所有关切的完整模型。
13.2 分割关系
分割把整体交给更小且不重叠的部分。图13.4用前后院展示分割要求完整且互不重叠:完成全部部分才完成整体,而普通视图不承诺覆盖全部或互不重叠。
原书依据 · 1 处
13.3 组合关系
组合从已有小模型形成更大模型。组合可以汇合共享模型内容说明它不受同一原整体或互不重叠的限制,例如加入邻居院子或汇合前后端共享的数据类型;不能把它直接等同于本章的分割。
原书依据 · 1 处
13.4 分类关系
分类关系:类型与实例的区分解释分类把具体东西归入类别。本书允许一实例有多类型,例如螺丝钉既是紧固件又有磁性;要求“一且仅一类”的理想分类不是每个模型都适用。type是概念类别,class是编程机制,不能不加说明就混用。
原书依据 · 1 处
13.5 泛化关系
泛化关联类型之间的通用与特殊,分类关联类型与实例。图13.5已查看,房屋、简约房屋和更具体房屋构成层次。泛化关系与利斯科夫替代测试说明子类型对象应能用于超类型对象原可使用的地方,保持有关行为承诺;原书“子类型可以用超类型替换”的句子方向易误读,本次已用Liskov与Wing 1994摘要和引言核验。代码中的继承不自动证明这种行为关系。
类别也可能按目的产生横切,随用途变化而调整。元模型把模型元素再分类说明类型还能作为另一层分类的对象,帮助区分模型与描述模型的词汇层次。
13.6 指定关系
指定声明两个域中的东西彼此对应:纸上的房屋矩形与现实砖瓦房不同,却可以约定对应。窄桥原则指定尽可能少的内容说明只把必要原始对应作为基础,再由定义推出面积等信息,就像表格中原始数据与公式的区别。现实地址已变而系统仍记录旧地址,就是对应可能失效;不能把模型记录当成现实本身。
原书依据 · 1 处
13.7 细化关系
细化联系同一对象的高、低细节表示,创建顺序无关。细化映射关联同一对象结合图13.6、13.8说明元素对应、打开内部嵌套与放大API细节。抽象的承诺需要保持,不能照原文一句“详细模型所有结论在低细节也真”就宣称抽象模型必然写出了全部实现细节。
细化的开放语义与封闭语义结合图13.7说明哪些新项允许引入:封闭语义须明确禁止变化的项目类型,未列入者仍可能增加;图上“绝对不能添加新条目”的短句应结合正文对限定范围的说明理解。本书尤其建议组件细化不添未说明的新外部端口。
抽象简化的双刃剑解释省略无关细节能降低规模,但整数范围等会影响结论的条件应放回模型。原书Bloch例子的算法名与已核验2006原文不符,原文主题是二分查找及归并排序;保留抽象与实现边界的教训,不扩大历史论断。抽象架构图也不能自动作为完整API文档。
13.8 绑定关系
绑定关系:占位符绑定解释用模式占位符对应具体模型元素,并带入约束。车库与房屋绑定到“必须相邻”的模式后,新的设计仍保留源模型元素,却增加了相邻要求;这是第14章风格应用到具体设计的基础。它与第12章外内端口映射共享“建立对应”的思想,但当前绑定针对整个模式及其约束。
原书依据 · 1 处
13.9 依赖关系
依赖提示变更需要联动检查用材料价格与成本估算说明,一处变动会影响另一模型,不能仅凭箭头外形判断它是通信或包含。
原书依据 · 1 处
13.10 使用关系
图13.9已逐项查看:现实房屋通过指定对应模型;整体分为房屋与车库;车库绑定卷帘门风格;房屋细化成三维表示后再投影出楼面。R1是厨房实例,厨房是一种房间。指定、分割、细化、投影和分类各回答不同问题,没有一个泛称“关联”可以替代它们。若要研究车库细节或另一方向楼面,可继续细化或投影,不必推翻已有共同模型。
13.11 小结
模型关系使一组分散图能够组成可理解的整体。开放/封闭细化、主模型/需求视图仍是必须声明的选择;知道关系名称的用途是让承诺可检查,而不是为了给每条线附上更复杂标签。
13.12 延伸阅读
延伸阅读分别指向Jackson对多种关系的讨论、D’Souza与Wills以催化方法讨论细化,以及Moriconi等关于架构细化的形式化方法。这里只登记原文给出的阅读线索,不声称已经通读这些外部材料。
第14章 架构风格
模式提炼可复用方案,架构风格在组件、模块等架构元素层面规定可用类型及使用约束,如拓扑、依赖、数据方向和可见性。风格不是画图外观,关键是约束与质量结果之间的关系。它还可体现在行业规范及框架中;本章先解释使用理由,再比较目录中的具体风格。
14.1 优势
风格是把双刃剑的预制约束集解释复用约束如何帮助一致性、沟通、设计重用与分析,同时带来不贴合需求及迁移的成本。跨平台插件若随意引用单一平台路径,就不能只靠“可扩展”名称得到可移植性;把约束托举到实现有助于维持边界。相同风格和消息格式只是集成分析的部分条件,不保证所有协议与语义都兼容。
原书依据 · 1 处
14.2 柏拉图式风格对体验式风格
柏拉图式风格与体验式风格区分目录理想和实际系统。管道首尾与外部环境交互可能仍保留中段的可组合性;服务端推送是否引入客户端依赖则要看实现。偏离不是自动错误,但需要识别哪些质量性质原本依赖被打破的约束。
原书依据 · 1 处
14.3 约束和以架构为中心的设计
以架构为中心的设计有意识地依靠结构和约束实现目标,可自行设计,也可采用已有风格;托举可强制关键约束。仅用风格作灵感也可以,但若一边打破支撑某性质的条件,一边把该性质当作保证,风险就被掩盖了。
14.4 模式对风格
架构模式与架构风格的区别说明主导整体的风格与局部模式的尺度差异,同时承认系统嵌套时边界会变化。原书的目录查询示例说明局部模式的用途;这里不把REST的含义缩减为某种消息格式。
原书依据 · 1 处
14.5 风格目录
表14.1已完整查看,按视图类型、元素关系、约束和质量整理目录。模块风格组织代码依赖,运行时风格组织组件协作,部署风格组织硬件资源;N-tier与MapReduce还跨越运行时和部署。后续各节逐项展开这些联系,不能仅凭总表就替代详细条件。
14.6 分层风格
分层按使用依赖组织模块说明严格相邻调用、允许越层和共享库的区别。图14.1显示第3层可访问第2及第1层,是放宽相邻规则的画法,不能同时读成“只允许下一层”的证明。接口隔离可支持替换、模拟与移植,但性能成本取决于实现。
回调让低层安全通信高层解释核心定义回调接口、UI实现并注册,运行时通知向上却不要求核心代码依赖UI实现。代码依赖与调用方向必须分开;此处“安全”也不是线程安全保证。
14.7 大泥球风格
大泥球的更坏即更好与自我稳定描述随意共享、全局状态和应急补丁如何积累技术债,以及短期收益、既有代码存续与组织激励怎样使混乱持续。它可提醒设计投入应合乎用途,却不意味着结构差必然带来更好的工程结果。
原书依据 · 1 处
14.8 管道-过滤器风格
管道过滤器靠独立性组合说明过滤器做转换、管道只传数据,过滤器不依赖上下游身份也不共享隐蔽状态。图14.2显示分叉与汇合而非只限线性,配套文字仍强调按方向处理、通常避免环。增量输出可提供并发机会,但不会凭模型自动创建线程。
管道网络需约定终止信号处理输入结束、令牌和管道关闭;实际缓冲与跨机通信会影响性能。过滤器编写者专注局部契约,组装者掌握全局目标,二者分工才支持重新配置与重用。示例命令仅解释文本流组合,本次没有执行。
14.9 批量顺序处理风格
批量顺序处理等待阶段完成与前节对比:线性作业各阶段先完整处理再交给下一阶段,输入输出常用文件,所以逻辑较简单,却少了同作业内流水并发。原文提及图14.3,但当前EPUB该项无内嵌图,不冒称已看到。开头“增量式”的措辞按后文与表14.1的整批阶段说明理解;分支图和多个作业仍可能并行。
原书依据 · 1 处
14.10 以模型为中心的风格
中心模型解耦视图与控制器结合图14.4说明统一模型、更新端口与变更通知怎样把IDE视图连接起来。可添加独立视图、集中管理状态是收益,所有组件仍共同依赖模型。直接视图控制器通信是明确偏离;本书把MVC等作为相关模式,不应把任何MVC实现都判为严格中心模型风格。并发是机会,不是无须同步的保证。
原书依据 · 1 处
14.11 分发-订阅风格
发布订阅解耦生产消费结合图14.5说明组件依赖事件而非特定对方,发布者不等待某个消费者回应。用总线模拟调用回复仍可实现,但偏离此处发过即忘的理想约束。
事件总线保证需要逐项声明保留持久化、批量、优先级、动态注册等变体及延迟代价;能发事件不等于获得任何条件下不丢消息的承诺。实际业务的生产消费关系仍须在文档展示,不可让全连总线图掩盖设计意图。不同文献对publish-subscribe的命名也可能不同,应以元素和约束判断。
14.12 客户端-服务器风格和多层
客户端服务器约束发起角色结合图14.6说明请求方与服务方不对称、同步/异步及有无会话的变体。首次连接后的更新是另有约定的行为。集中维护服务器规则可少改客户端,但不能忽略接口兼容性。
图14.7把多个客户端服务端关系串成三层,多层服务不等于代码分层明确tier的功能分组、运行时调用与硬件分配要分别解释,两个tier可以同机。客户端服务端风格也不禁止所有客户端间通信;中心模型风格对各视图控制器间的限制更强。
14.13 对等风格
对等角色对称不要求全连接说明节点可同时请求与服务,连接到节点子集就能构成网络。副本与替代路径可提供弹性,但分区孤岛、入口节点和实际资源分布仍会改变故障影响。原书当时的BitTorrent/Skype规模属于历史说明,本次未核验当前服务规模。
原书依据 · 1 处
14.14 map-reduce风格
MapReduce托举任务调度结合图14.8说明Master、Map/Reduce Worker、本地及全局文件系统的分工。框架封装调度与失败重安排,应用仍须满足处理函数和状态的契约。
数据划分与局部性制约伸缩说明任务划分不均和跨机数据传输如何妨碍伸缩。图示中Map各自产生中间输出,Reduce读取多处本地结果后写全局存储;本节不是任意计算都可直接分拆的证明。多个作业可以按批量阶段组合,把更大问题分步表达。
14.15 镜像、支架和农场风格
镜像风格的可靠性与可用性悖论更正故障对象混淆:至少一台坏与整个服务不可用不同,在独立理想时点模型下分别是2p−p²和p²;不能由设备事件增多推出系统可靠性变差,更不能当成实测可用率。切换与共同故障等条件仍需单独分析。
机架拓扑影响通信成本说明设备密度、机架内网络与上行链路;服务器农场共享同类资源说明同类机器如何作为部署资源,应用状态和其他瓶颈影响能否扩容。部署风格因此关系到性能与故障边界,而不只是机房摆放。
14.16 小结
风格把元素与约束组织成可复用方案。模块、运行时和部署视图各有不同风格,实际系统常组合使用或偏离理想。选择时要能从约束解释预期性质,再检查实现维持了什么条件;名称帮助沟通,却不能代替这一推理。
14.17 延伸阅读
延伸阅读指向早期风格研究、Boxology分类、按视图类型组织的风格文档,以及架构与企业模式资料。它们提供继续比较的线索,本次仅根据当前书实际文字登记,不声称已通读外部著作。
第15章 使用架构模型
前几章给出模型语言,这一章转向用它改进工程判断。会区分模块和组件、会写场景并非终点;精度选择、视图一致性、分析、集成假设与现存系统建模,最终都服务于更可靠的系统设计。
15.1 理想的模型特性
草图与蓝图:按问题选精度说明模型是否足够精确由问题决定,既不能用酷炫草图伪装确定性,也不应先造昂贵模型再为它找问题。完整性不是无条件目标。可证伪性与幻灯片架构把与现实对应、内部不矛盾、引用存在和结论可检查区分开;仅有一张清晰图不保证这些性质。
预测性模型提前暴露风险说明模型应支持判断死锁、适配或可构建性。表达还要适合读者:删去无关细节、突出问题关切、使用可理解符号,并以多级故事组织边界与内部。原文关于对象比函数更容易理解只是推测,不作为已验证的人类认知事实。
细节一致性级别的三种歧义说明局部过细或省略的原因要标明;单主题视图与经济性建模强调一致展示有关属性,并用最低足够成本降低风险。单主题并非只能显示一种数据,吞吐和可靠性可以共同服务一个分析问题。
15.2 和视图一起工作
盲人摸象与标准视图集说明分而治之之后仍须重建整体,跨关切的权衡可用混合视图承接。主模型或投影绘制错误都可能造成不一致,一处设计变更还要回到其他受影响视图。视图反模式:宠物视图与万能图提醒视图要匹配问题,不能因熟悉就强套分层,也不能把代码组织、通信和硬件挤进一张无法分辨线条语义的图。
15.3 改善视图质量
功能场景像线一样把同一模型的多个视图串联。场景步骤须有模型依据从活动者、活动、引用与目标状态逐项核对,避免模型中没有的状态被故事悄悄借用;跨视图仍应有共同目标模型。
让场景动起来核验模型进一步逐步想象通信、前后状态和边界变体,检查启动、关闭、空集及异常,而不把想象等同于执行测试。活动规范:前置后置条件串联视图用check_out_copy说明前后置条件如何要求副本、借阅者、借阅记录、日期与状态事先定义。精确规范可限制必要模型范围,但全面使用昂贵;本次只解释原书规范,没有运行借书程序。
15.4 提高图的质量
图例价值与箭头语义歧义结合图15.1说明图例应解释具体抽象、端口与通信语义。连接发起方向、服务关系和主要数据流可以不同,因此一个无说明箭头不足以承载全部属性。可以用类型、阴影和文字分开表达;如果保留箭头,就明确其含义,不把本书选择误读成所有图都禁止箭头。
原书依据 · 1 处
15.5 测试和证明
模型测试不等于一般证明说明测试要从具体案例扩展到更广的真实数据,反例可推翻候选模型,有限通过则不保证无缺陷。若需要更一般性质,须建立适合证明的解析表示;无论测试或证明,现实映射与假设都不能被省去。
原书依据 · 1 处
15.6 分析架构模型
人是最好的架构分析工具强调合适信息形式可让人看出源代码中难找的风险,例如部署图暴露唯一负载均衡节点。标准视图有通用价值,领域特定视图仍可加强分析;这不是说工具分析没有用途。非正式架构分析技术四件套区分设计前的质量场景征集、已知风险检查、外部视角评审,以及既有方案的质量权衡分析。
工具分析需完成双向映射按简化、映射词汇、表达模型、设计断言、检查及解释结果说明正式分析的工作。抽象反例须核查约束遗漏强调假反例与性质保留的限制:删掉约束可能放入现实不可达的路径,不能把工具输出直接叫作生产故障。
安全可从数据流和已知攻击假设分析,可靠性可检查单点、退化和安全模式;本节对DFD“查找病毒”的措辞不当作检测任意恶意软件的能力保证。性能路径估算须回到测量解释路径分段与测量的联系,排队论和模拟是按问题进一步选择的方法。Spin、Alloy与LTSA只是原书举出的工具线索,本次没有执行或核验其当前版本、也未产生任何系统证明。
15.7 架构不匹配
架构不匹配的四类隐含假设结合图15.2的主事件循环控制、CSV输入和已初始化输出假设,说明技术表面兼容之外仍可能发生控制权、协议、拓扑与初始化顺序冲突。把假设放在图旁更易被检查,发现不匹配可换部件或改设计,而不是等集成后用补丁掩盖。
原书依据 · 1 处
15.8 选择你的抽象级别
API模型具体但维护昂贵说明代码可对照和可测试的收益,与规模、易过期及遮蔽架构的成本。具体API并非完全无法表达端口或风格,而是细节容易使这些关切难以看见;保持抽象级别由要回答的性能、安全或适配问题决定。
原书依据 · 1 处
15.9 规划用户界面
界面能力需要后端配合用撤销、多元素操作和自动完成说明后端能力会限制用户体验;原型与交互同步设计还能暴露API遗漏,不能把UI视为最终才补上的装饰。
原书依据 · 1 处
15.10 指定性模型对描述性模型
指定性模型与描述性模型区分“应当怎样”和“实际怎样”。同一架构词汇可用于表达目标或描述现状,使用时必须声明意图;把理想封装直接画成现存系统,就会掩盖真正的依赖和通信。
原书依据 · 1 处
15.11 对现有系统进行建模
现有系统建模:按需限定结合已查看的表15.1说明,不同目的选择不同模型:理解现状可先用领域和边界;替代方案需选定内部细节;集成还须理解领域与连接器;采购也可能要查看数据语义。
模型不能凭空净化混乱的系统。应准备看到实际依赖、规则例外及风格偏离,再决定是否重构,而不是为描述图清爽而删去麻烦路径。
原书依据 · 1 处
15.12 小结
本章把有效建模归结为能回答问题、可检查、促进理解并合乎成本。视图拆分后由场景和活动规范重新联系;人和工具各有分析角色;集成要暴露假设,现存系统要按目的选择范围。停止点依问题和风险而定,目标始终是构建与改进系统。
15.13 延伸阅读
本章延伸阅读分别来自模型特性讲义与报告、场景贯穿视图及精确规范方法。这里保留可追踪的作者和年份线索,不把推荐阅读冒充本次全文阅读。
第16章 结论
结论把全书两个部分接上:先按失败风险决定架构投入,再掌握使模型可读、可用的抽象词汇。理解系统时不再只看代码,而要看质量、约束和托举机制怎样影响实现;最后也须承认建模方法的成本与边界。
16.1 挑战
架构抽象与编程语言对齐困境解释现存代码、框架和不同语言并不总按标准架构概念组织。无法经济地细分时可先以较大的模块或组件表示,再按问题补细节;对象适配器与独立组件适配器也不是自动同一个粒度。关于成书时期学术开放问题的说法保留历史范围,不当作今天的研究现状。
建模技术的隐藏维护成本归纳功能停止点、动态结构、多视图同步、横切关切和细化对应。把进程线程与组件对齐能简化解释,但不是任何系统都天然对齐。预言的脆弱性用实际请求增长超出假设的Web性能模型说明,选错或漏掉细节会破坏预测;详细模型本身也需要投入,仍要以风险衡量。
16.2 聚焦质量属性
架构尤其影响性能、安全、修改成本等质量,而相同功能常有多个实现方向。早期把重要质量要求写清,有助避免后期昂贵改造。领域已有的预制架构可减少重复选择,风险高时则需要明确检查结构与目标之间的联系,并考虑托举,而不是仅复用上一项目的名称。
16.3 解决问题,而不是仅仅对它们建模
模型不是系统,验证不可替代提醒模型推理之后仍须构建原型、演示或真实系统来核验。灭火笑话中只有算出方案却未行动的人没有解决问题;同样,编译通过或图画完整不能替代运行行为的证据。本轮笔记和实践计划交付也不代表这些工程实践已经执行。
原书依据 · 1 处
16.4 使用导轨一样的约束
引入约束的四步流程把导轨思想具体化:明确目标,追问失败路径、约束效果与代价,再决定采用何种限制。Rackspace、播放器进程隔离与邮件异步发送分别展示伸缩、故障隔离和响应时间的选择及成本。风险降低并非绝对无故障,托举后仍须验证实际边界。Android例子按历史语境理解,不当作当前权限操作指南。
原书依据 · 1 处
16.5 使用标准架构抽象
共享架构抽象是沟通的前提说明团队若只有对象和方法的共同语言,就难以讨论跨很多对象的组件、连接器与风格约束。共享词汇有助于把局部交互放回整体;它与状态机、类图等已有工具并存,目的在于提高解释与判断能力,不是强迫所有系统使用同一模板。
原书依据 · 1 处
术语表
术语表将全书词汇按英文名称组织,可作为回到相关章节的入口。它不是一套新增的独立理论,绝大多数定义已在前文有实质解释;本轮六个单元全部实际读取,不以“只是索引”为由排除。
第一组从活动规范、敏捷过程、部署、类比/解析模型、架构职责一直到大量预先设计,回扣第1—3、6、9、15章:模型是刻意选择的符号表示,分析瘫痪则是投入分析而不交付解决方案。第二组从二元连接器、绑定与边界模型到组件、契约、设计与领域,回扣第7—12章:域间对应、实现决策、接口承诺与内部实现不可混同。
第三组从主导分解到层,回顾动态配置、封装、架构角色与各种迭代方式;同一分解让一种关系易处理,也可能使另一种关系难表达。第四组从实例链接到细化,区分主模型、方法签名、模块、OCL、端口、推定/参考架构和可测试质量场景,继续把抽象与具体承诺联系起来。
第五组从职责驱动设计到UML,将风险、角色、运行时视图、系统边界、战术、技术和多级故事汇总。代码规模不同于负载伸缩专门澄清“scale”可能指代码体量,也可能指负载能力,不能拿代码行数直接衡量伸缩性。第六组用用例、视图、视点、瀑布等结尾,重申单条场景与多路径目标活动、投影与共同模型的区别。
译名存在变化,如动作规约/活动规范、架构提升/托举、质量特性/质量属性;按英文概念与上下文对照。术语表的“一实例只一类”、CBD市场、视点或软件过程等简写不能覆盖前文限定;有关历史工具、平台及标准的描述也不作为当前事实。这里没有重新认定全部外部标准或方法的现状。
原书依据 · 1 处
跨章综合
风险、模型与约束共同决定架构工作量。风险给出先处理什么,模型让团队把足够少而关键的细节放在一起思考,约束则排除会破坏重要性质的设计。三者都不能被名称替代:采用一个风格却打破其关键约束,或者画完模型却没有核验现实对应,都无法据此宣称风险已经消失。
多视图不是三张独立的正确图就结束了。源代码依赖、运行时协议和部署位置会互相影响,例如把本地调用换成远程连接器会改变失败和延迟条件。功能场景可以从输入、通信到状态变化逐步穿过视图,检查每个引用存在、每项数据可得和每条约束得到支持;活动规范进一步明确前后置承诺。它们建立联系,但一条成功路径仍不覆盖全部可能行为。
封装与连接器把变化限制在可理解的边界内。良好模块隐藏可能变化的设计秘密,组件端口让客户端只理解必要领域,连接器则集中通信、质量或跨领域转换逻辑。框架和架构明显的代码可让这些意图更容易维持;当代码无法精确表达全部规则时,仍须留出可维护的说明与验证,而不是期待读者从方法列表自动猜出设计。
抽象的收益与危险来自同一动作:省略。去掉桥梁外观有助于看清连通问题,忽略整数范围却会使中点计算推理失真。提高细节不能无限进行,需以要回答的问题决定;无法映射到真实路径的工具反例也不能直接认作实际缺陷。投入与证据必须相称,最重要的交付仍是可工作的系统。
发散与实践
以下为读者延伸与尚未执行的实践计划。第一张以Cardbox为应用问题、以固定版本Depguard为成熟实现深读对象,已准备源码与首轮机制映射,理解导入规则如何由配置落实到AST诊断。第二张运用引入约束的四步流程,规划是否采纳依赖检查的决策,当前不凭局部代码阅读给出接入结论。
- 用导入规则核验包依赖(
ideas/idea-001-cardbox内部包依赖图核验分层约束.md):优先读已固定的规则实现与入口,先弄清可检查范围。 - 决定是否增加依赖约束(
ideas/idea-002-用四步流程决定是否给cardbox加分层约束检查.md):再把实际包职责、现有机制和例外填入决策日志。
旧实践的八包依赖表、严格分层判定及“没有自动检查”的说法没有沿用为当前事实;历史副本留在工作目录。未采用全量架构测试框架或自制检查器,是因为现阶段阅读成熟实现和确定问题边界更有价值。没有运行源码、测试、实验或修改CI。