要可视化软件
团队善于用看板可视化流程,却常不会可视化正在构建的软件。发散:理解架构不等于能表达架构;没有有效图表,敏捷团队也会缺方向、共识和技术领导。
主题对照
比较用语境、容器、组件、类四层抽象描述软件架构的方法:草图的常见缺陷、分层视图的边界、图与代码的映射、图例与评审清单。
团队善于用看板可视化流程,却常不会可视化正在构建的软件。发散:理解架构不等于能表达架构;没有有效图表,敏捷团队也会缺方向、共识和技术领导。
草图不是艺术作品,也不是综合模型,而是在短时间内传达大局、建立共同愿景和支撑协作设计的工具。发散:语境、容器、组件图往往比厚重模型更适合让团队快速对齐。
只有框没有线、职责和交互的图,无法表达软件架构。发散:结构不仅是“有什么东西”,还包括它们如何协作;线条和标签不是装饰,而是理解系统行为的关键。
充满“业务逻辑”“处理器”等泛化词的图很难说明系统真正解决什么问题。发散:架构图应像代码结构一样喊出业务领域,让人一眼看出这是风险系统、银行系统还是内容平台。
C4 用不同抽象层次描述同一个软件系统。语境图先说明系统服务谁、与哪些外部系统交互;容器层打开系统,展示可运行软件单元或数据存储;组件层说明某个容器内部的职责分组;类层进一步解释组件如何由代码类型实现。
每层回答的范围不同,不能把所有细节堆成一张图。这里的容器是逻辑运行和部署抽象,不特指某个虚拟化产品;具体服务器、副本和故障切换需要部署视图补充。
结构图:
flowchart TD
S[系统语境 用户与外部系统] --> C[容器 运行单元与存储]
C --> P[组件 容器内部职责]
P --> T[类 组件的代码结构]
团队先共享系统、容器、组件、类等抽象,比强行统一 UML 标记更重要。发散:非正式图可以灵活,只要用图例和一致约定补上可理解性。
语境图回答系统是什么、谁使用它、它如何融入现有 IT 环境。发散:它不追求技术细节,而是先消除关于用户、外部系统和系统边界的隐含假设。
容器图打开系统盒子,展示可独立部署或运行的主要容器、技术选择、职责和通信方式。发散:它承接[[语境图定边界]],连接高层语境和细节组件,是开发、运维和支持都能读懂的技术大图。
组件图展示某个容器内的关键逻辑组件、职责和依赖,是[[容器图开盒子]]之后的放大层。发散:如果一个需求找不到承接它的组件,架构可能已经漏掉了重要职责。
架构图包含技术选择能消除歧义,让讨论从概念分解回到真实实现、通信和约束。发散:如果图上没有技术,人们很容易假设“随便什么都行”,直到非功能需求证明并非如此。
架构图应该反映将如何编码和部署,而不是画出不存在的概念物。发散:共享库就画在使用它的容器中,独立服务才画成独立运行单元;图和代码越能互相映射,沟通成本越低。
架构图谈组件,代码却按层散落,会形成“模范代码的差距”,也解释了[[图要照进代码]]的重要性。发散:当代码结构无法支持架构理解时,代码不是唯一真相,而是另一种需要修正的表达。
以组件组织代码能让包结构对应架构图中的业务能力,而不只是 UI、服务、数据访问等技术层。发散:整体系统也可以通过组件边界获得更清晰的所有权和可迁移性。
架构设计不依赖昂贵 UML 工具,白板、纸和便利贴常常更适合协作。发散:工具应在团队明白如何设计和沟通之后再提升流程,而不是替代思考。
非正式草图需要标题、标签、线条含义、颜色编码、边框和缩略语说明。发散:只要画图者必须口头解释箭头含义,就应该把这个解释放进图例里。
有效架构图应能展示抽象层次、大局、容器、组件职责、表示法、可追踪性、业务领域和实现策略。发散:评审图不是挑美观,而是检验它能否帮助团队做一致决策。
C4 常见问题的核心是保持抽象层次清晰:简单系统可合图,但一旦混乱就拆开,组件也要归属到实际容器。发散:画法应服务理解,不能为了省图而牺牲边界。
C4 图按关注范围逐层展开系统:上下文图说明外部参与者与系统的关系,容器图展示运行中的主要构件,组件图再解释容器内部的职责与交互。先给出共同的高层语境,再下钻到实现细节,可减少不同角色讨论同一系统时的误解;每层只保留该层决策需要的信息。
架构图从全局切到局部时,应先让读者看见局部与全局的关系,再放大细节。否则同一组组件在不同视图中突然出现,读者不知道它属于哪里。原书将这种跨视图保留关系的做法称为“表征一致性”;它既适用于图,也适用于演示。可以用“全系统拓扑→目标区域→区域内部结构”的顺序组织视图。
架构图层应承载不同语义,而非仅为装饰分组。底层先画容器、数据库、依赖和消息代理等拓扑,说明例如“同步通信”的架构关系;上层再加数据库类型、具体协议等实现细节。展示不同受众时隐藏或开启图层,可在不改拓扑的情况下补充领域边界或事务范围,避免一张图挤入全部信息。
C4用上下文(Context)、容器(Container)、组件(Component)和类(Class)四级视图组织系统图。上下文显示用户角色与外部依赖;容器显示系统内的部署或逻辑边界;组件显示容器内部的主要职责;类级借用UML类图表达细部。它让不同受众按所需层级深入,同时保持共同的结构语言;具体图例仍须明确标注。第四级名称按本书原文。
架构图中的标题、线、箭头、形状和标签都要帮助读者辨认“是什么、连向哪里、如何通信”。信息流要标方向;若实线表示同步、虚线表示异步,就在整套图里保持一致。对可能歧义的形状或线型附图例。不同团队可自定符号,但同一张图不能让读者猜含义。
颜色可帮助区分组件或分组,但不应是表达关键差异的唯一线索:色觉障碍者或黑白打印读者可能看不出区别。给关键类别同时加不同图标、形状、文字或线型,让图在失去颜色后仍可解读。原书以交通灯同时使用颜色与不同人形符号作类比;这里是架构图可访问性的设计规则。
组织采用统一图示标准能让团队共享读图语言,但若标准无法清楚表达当前设计,应允许有说明的例外。过重的建模工具可能迫使架构师加入当前讨论无用的细节,降低信噪比。先问图要回答什么问题,再保留所需元素;早期设计优先轻量草图,定稿时再统一可维护的符号。
JAR 等部署文件说明代码如何打包,却未必说明系统运行时有哪些进程。一个文件可能被不同运行单元使用,多个文件也可能在同一应用中运行。如果图把文件直接画成独立服务,读者就可能误判通信与故障边界。先确定图表达打包结构还是运行结构,再标明进程、容器及交互,避免混用抽象层次。
C4 容器视图说明软件由哪些可运行单元或数据存储组成,以及它们的职责、技术和通信。这里的容器是架构抽象,不特指 Docker 容器,也不要求每个容器独占操作系统进程。它通常不表达负载均衡后的多个物理副本;副本位于哪些机器、怎样切换,需要另用部署视图说明。
组件封装把实现一个业务能力的接口和内部实现放在同一组件边界内,外部通过公开接口使用它。书中的 tweet 组件公开 TweetComponent,TweetComponentImpl 实现它,并使用 MongoDbTweetDao 访问存储。这样外部代码不必逐层接触实现细节。图保留原书的三个真实类型与关系;原文未列方法签名,因此不补造方法。
结构图:
classDiagram
class TweetComponent {
<<interface>>
}
class TweetComponentImpl
class MongoDbTweetDao
TweetComponent <|.. TweetComponentImpl : 实现
TweetComponentImpl --> MongoDbTweetDao : 使用
C4 的分层结构图说明系统由什么组成,却不能单独讲清一次请求如何执行。重要流程可以补充时序图或活动图,状态变化可以补充状态图;这些图回答交互次序、分支或状态转移等不同问题。先找读者尚不理解的行为,再选择表达方式,不必给每个组件机械配齐所有图。
单一系统的语境图把该系统与用户、外部系统联系起来;当读者需要了解多个系统怎样服务组织时,还可以在更高层画企业范围的系统地图。Simon Brown 在这里将这种补充称为 C5。它用于连接组织全景与某个系统的细节,是本书提出的扩展说法,不能据此当成正式统一的行业标准。
日志等公共设施可能被许多组件共同使用。若把每条重复依赖都画成箭头,图会被交叉线淹没。可把适用于全图的公共依赖写成醒目的注记,并说明范围;关键业务依赖仍须明确展示。这是在保留信息的前提下压缩重复表达,不是把实际存在的共享设施从设计中删掉。
点击箭头逐层展开,点击卡片标题查看详情。路径上下文仅用于连接层级,不计入主题卡片数。
来源书籍
软件架构方法论类
书籍类型:经典原理
清单覆盖 7/7
358 张卡片
来源书籍
系统架构类。
书籍类型:未标注
类别清单尚未核对
180 张卡片
来源书籍
软件架构方法论类
书籍类型:经典原理
清单覆盖 7/7
128 张卡片
与 1 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;来自相同书籍;属于相同分类
与 1 张主题卡片存在结构化链接;来自相同书籍;属于相同分类