知识卡片
遗留豁免集中后再删除
迁移大量接受裸字符串的遗留 API 时,可把“任意字符串→安全类型”的临时豁免集中到一个转换函数,先让调用点改用受类型约束的新 API。集中入口便于审查和统计剩余依赖,但它本身不证明输入安全;存量迁完后必须删除该入口,才能真正关闭绕过路径。这补充了[[给不安全API判类型实现渐进式退场]]的收尾步骤。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- · 查看原书依据
将所有加白机制汇总进一处函数,这样阅读源代码时会更清晰可见。例如,可以创建一个函数,参数是任意字符串,返回值是一个安全类型。通过该函数,你可以将所有调用字符串类型的 API 替换成更为精确的类型调用 API。
参考来源
- 位置:《Google系统架构解密:构建安全可靠的系统》第12章《编写代码》12.3节“切换遗留代码”(源文件:`../OREILY动物书合辑 图灵新版/_epub-src/text/part0014_split_100.html`)
- 结论依据:原文提出将加白机制汇总到单个函数,由任意字符串产生安全类型,以便批量替换旧 API 调用;最终只需删除这个遗留转换函数。集中函数仍需审查,是根据其绕过安全类型构造边界作出的风险判断。
- 原始内容:将所有加白机制汇总进一处函数,这样阅读源代码时会更清晰可见。例如,可以创建一个函数,参数是任意字符串,返回值是一个安全类型。通过该函数,你可以将所有调用字符串类型的 API 替换成更为精确的类型调用 API。……而只需删除每个类型的单个遗留转换函数。