← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 1938.a.1

代码癌症:不断长大的循环组

理解等级:中级

敌人是熵:开发复杂系统最大的敌人是结构侵蚀,终态是“大泥球”——本应正交的部分之间存在大量不该有的依赖,典型症状是改一处会破坏完全无关的另一处,以及出现大型循环组。

Cassandra 的数据:分析开源系统可以看到循环组一旦达到一定规模就会持续增长。Apache Cassandra 第 2 版已有约 450 个 Java 文件的循环组,第 3 版增长到 900 多个,第 4 版超过 1300 个;第 4 版中“肿瘤”还“转移”出两个新组(143 个和 31 个元素),约 75% 的元素都卷入大型循环组。包级别更糟:113 个包中有 102 个在一个大循环组里。作者把这种不断增长、吞噬代码库的大循环组称为“代码癌症”。由于包或命名空间最适合表示架构分组和意图,保持它们之间无循环更加重要。

为什么有害:无法独立测试各部分;随便选一个文件都直接或间接依赖几乎所有东西,新人很难理解;除非做风险大、耗时长的全局修改,否则无法隔离和替换某些功能——模块化成为不可能,架构图只能简化成一个写着“Cassandra”的方框。

所有循环都能打破:应用 Robert C. Martin 的依赖反转原则,引入接口反转循环中的依赖;把循环依赖提升到依赖循环双方的更高层类中;或降级到负责双方通信的更低层类;或在类之间移动功能。

用指标防止:度量最大源文件循环组的元素数,设阈值(如 5),达到 6 个就告警甚至让构建失败——此时元素还少,修复容易快速。单一包内的小循环危害不大,只要阻止它长大。作者长期经验:超过 10 万行代码的复杂系统有 80% 最终变成大泥球;限制循环组规模就能胜过其中多数,是新项目中很容易摘的“低垂果实”。Spring 框架就是结构良好、只有少量小循环组的例子。工具如免费的 Sonargraph-Explorer 可以按循环组规模让构建失败。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《软件架构指标:度量软件系统的性能和架构质量》第09章《第9章 使用软件度量指标来确保可维护性》9.1.1 熵对软件的危害;9.1.2 循环依赖的有害性;9.1.3 指标如何提供帮助(源文件:extracted/软件架构指标 度量软件系统的性能和架构质量/_epub-src/index_split_075.html,来源项目 book-sources) - 结论依据:第9章以Apache Cassandra循环组从约450个文件增长到1300多个、113个包中102个卷入循环为例说明“代码癌症”式的结构侵蚀,解释循环依赖妨碍独立测试、理解与替换,介绍依赖反转、提升、降级、移动功能等打破循环的方法,并建议设定循环组规模阈值(如5)让构建在超限时告警或失败。 - 原始内容:我喜欢称这些大型循环组为“代码癌症”:它们会不断增长并吞噬你的代码库中更大的部分。