12.综合实战图片框架

杨充2026-07-24 17:20

12.综合实战图片框架

目录介绍
  • 1.一场图片引发的崩溃
    • [1.1 大促夜的事故现场](#1.1 大促夜的事故现场 "#11-%E5%A4%A7%E4%BF%83%E5%A4%9C%E7%9A%84%E4%BA%8B%E6%95%85%E7%8E%B0%E5%9C%BA")
    • [1.2 排查路径与最终归因](#1.2 排查路径与最终归因 "#12-%E6%8E%92%E6%9F%A5%E8%B7%AF%E5%BE%84%E4%B8%8E%E6%9C%80%E7%BB%88%E5%BD%92%E5%9B%A0")
    • [1.3 八个灵魂拷问](#1.3 八个灵魂拷问 "#13-%E5%85%AB%E4%B8%AA%E7%81%B5%E9%AD%82%E6%8B%B7%E9%97%AE")
    • [1.4 本篇路线图](#1.4 本篇路线图 "#14-%E6%9C%AC%E7%AF%87%E8%B7%AF%E7%BA%BF%E5%9B%BE")
  • 2.V0版本能跑就行
    • [2.1 三百行的屎山](#2.1 三百行的屎山 "#21-%E4%B8%89%E7%99%BE%E8%A1%8C%E7%9A%84%E5%B1%8E%E5%B1%B1")
    • [2.2 找出十七处坏味道](#2.2 找出十七处坏味道 "#22-%E6%89%BE%E5%87%BA%E5%8D%81%E4%B8%83%E5%A4%84%E5%9D%8F%E5%91%B3%E9%81%93")
    • [2.3 屎山的代价清单](#2.3 屎山的代价清单 "#23-%E5%B1%8E%E5%B1%B1%E7%9A%84%E4%BB%A3%E4%BB%B7%E6%B8%85%E5%8D%95")
  • 3.封装救场状态浮现
    • [3.1 静态地狱的根源](#3.1 静态地狱的根源 "#31-%E9%9D%99%E6%80%81%E5%9C%B0%E7%8B%B1%E7%9A%84%E6%A0%B9%E6%BA%90")
    • [3.2 抽取请求对象封装](#3.2 抽取请求对象封装 "#32-%E6%8A%BD%E5%8F%96%E8%AF%B7%E6%B1%82%E5%AF%B9%E8%B1%A1%E5%B0%81%E8%A3%85")
    • [3.3 引入状态机守卫](#3.3 引入状态机守卫 "#33-%E5%BC%95%E5%85%A5%E7%8A%B6%E6%80%81%E6%9C%BA%E5%AE%88%E5%8D%AB")
    • [3.4 值对象与缓存键](#3.4 值对象与缓存键 "#34-%E5%80%BC%E5%AF%B9%E8%B1%A1%E4%B8%8E%E7%BC%93%E5%AD%98%E9%94%AE")
  • 4.抽象与接口分离
    • [4.1 识别变化轴线](#4.1 识别变化轴线 "#41-%E8%AF%86%E5%88%AB%E5%8F%98%E5%8C%96%E8%BD%B4%E7%BA%BF")
    • [4.2 三个端口浮现过程](#4.2 三个端口浮现过程 "#42-%E4%B8%89%E4%B8%AA%E7%AB%AF%E5%8F%A3%E6%B5%AE%E7%8E%B0%E8%BF%87%E7%A8%8B")
    • [4.3 抽象类共享骨架](#4.3 抽象类共享骨架 "#43-%E6%8A%BD%E8%B1%A1%E7%B1%BB%E5%85%B1%E4%BA%AB%E9%AA%A8%E6%9E%B6")
    • [4.4 与Glide设计对照](#4.4 与Glide设计对照 "#44-%E4%B8%8Eglide%E8%AE%BE%E8%AE%A1%E5%AF%B9%E7%85%A7")
  • 5.组合优于继承
    • [5.1 继承式方案的爆炸](#5.1 继承式方案的爆炸 "#51-%E7%BB%A7%E6%89%BF%E5%BC%8F%E6%96%B9%E6%A1%88%E7%9A%84%E7%88%86%E7%82%B8")
    • [5.2 拦截器链的诞生](#5.2 拦截器链的诞生 "#52-%E6%8B%A6%E6%88%AA%E5%99%A8%E9%93%BE%E7%9A%84%E8%AF%9E%E7%94%9F")
    • [5.3 能力可插拔实战](#5.3 能力可插拔实战 "#53-%E8%83%BD%E5%8A%9B%E5%8F%AF%E6%8F%92%E6%8B%94%E5%AE%9E%E6%88%98")
    • [5.4 与OkHttp架构同构](#5.4 与OkHttp架构同构 "#54-%E4%B8%8Eokhttp%E6%9E%B6%E6%9E%84%E5%90%8C%E6%9E%84")
  • 6.V1阶段小结
  • 7.SOLID五原则精修
    • [7.1 SRP拆解请求职责](#7.1 SRP拆解请求职责 "#71-srp%E6%8B%86%E8%A7%A3%E8%AF%B7%E6%B1%82%E8%81%8C%E8%B4%A3")
    • [7.2 OCP扩展WebP不改旧码](#7.2 OCP扩展WebP不改旧码 "#72-ocp%E6%89%A9%E5%B1%95webp%E4%B8%8D%E6%94%B9%E6%97%A7%E7%A0%81")
    • [7.3 LSP前置后置条件](#7.3 LSP前置后置条件 "#73-lsp%E5%89%8D%E7%BD%AE%E5%90%8E%E7%BD%AE%E6%9D%A1%E4%BB%B6")
    • [7.4 ISP拆分缓存接口](#7.4 ISP拆分缓存接口 "#74-isp%E6%8B%86%E5%88%86%E7%BC%93%E5%AD%98%E6%8E%A5%E5%8F%A3")
    • [7.5 DIP解OkHttp耦合](#7.5 DIP解OkHttp耦合 "#75-dip%E8%A7%A3okhttp%E8%80%A6%E5%90%88")
  • 8.重构十二式实战
    • [8.1 提取方法解码逻辑](#8.1 提取方法解码逻辑 "#81-%E6%8F%90%E5%8F%96%E6%96%B9%E6%B3%95%E8%A7%A3%E7%A0%81%E9%80%BB%E8%BE%91")
    • [8.2 引入参数对象LoadOptions](#8.2 引入参数对象LoadOptions "#82-%E5%BC%95%E5%85%A5%E5%8F%82%E6%95%B0%E5%AF%B9%E8%B1%A1loadoptions")
    • [8.3 用多态替换条件](#8.3 用多态替换条件 "#83-%E7%94%A8%E5%A4%9A%E6%80%81%E6%9B%BF%E6%8D%A2%E6%9D%A1%E4%BB%B6")
    • [8.4 引入策略变换族](#8.4 引入策略变换族 "#84-%E5%BC%95%E5%85%A5%E7%AD%96%E7%95%A5%E5%8F%98%E6%8D%A2%E6%97%8F")
    • [8.5 守卫子句替换嵌套](#8.5 守卫子句替换嵌套 "#85-%E5%AE%88%E5%8D%AB%E5%AD%90%E5%8F%A5%E6%9B%BF%E6%8D%A2%E5%B5%8C%E5%A5%97")
    • [8.6 替换魔法数](#8.6 替换魔法数 "#86-%E6%9B%BF%E6%8D%A2%E9%AD%94%E6%B3%95%E6%95%B0")
    • [8.7 分解上帝类](#8.7 分解上帝类 "#87-%E5%88%86%E8%A7%A3%E4%B8%8A%E5%B8%9D%E7%B1%BB")
    • [8.8 查找表替换switch](#8.8 查找表替换switch "#88-%E6%9F%A5%E6%89%BE%E8%A1%A8%E6%9B%BF%E6%8D%A2switch")
  • 9.可测试性改造
    • [9.1 注入Clock抽象时间](#9.1 注入Clock抽象时间 "#91-%E6%B3%A8%E5%85%A5clock%E6%8A%BD%E8%B1%A1%E6%97%B6%E9%97%B4")
    • [9.2 注入Scheduler抽象线程](#9.2 注入Scheduler抽象线程 "#92-%E6%B3%A8%E5%85%A5scheduler%E6%8A%BD%E8%B1%A1%E7%BA%BF%E7%A8%8B")
    • [9.3 注入Network抽象网络](#9.3 注入Network抽象网络 "#93-%E6%B3%A8%E5%85%A5network%E6%8A%BD%E8%B1%A1%E7%BD%91%E7%BB%9C")
    • [9.4 五个高价值单测](#9.4 五个高价值单测 "#94-%E4%BA%94%E4%B8%AA%E9%AB%98%E4%BB%B7%E5%80%BC%E5%8D%95%E6%B5%8B")
    • [9.5 录制式调度器](#9.5 录制式调度器 "#95-%E5%BD%95%E5%88%B6%E5%BC%8F%E8%B0%83%E5%BA%A6%E5%99%A8")
  • 10.V4阶段小结
  • 11.V5用DDD重塑边界
    • [11.1 为何还要再切一刀](#11.1 为何还要再切一刀 "#111-%E4%B8%BA%E4%BD%95%E8%BF%98%E8%A6%81%E5%86%8D%E5%88%87%E4%B8%80%E5%88%80")
    • [11.2 五个限界上下文](#11.2 五个限界上下文 "#112-%E4%BA%94%E4%B8%AA%E9%99%90%E7%95%8C%E4%B8%8A%E4%B8%8B%E6%96%87")
    • [11.3 上下文映射与防腐](#11.3 上下文映射与防腐 "#113-%E4%B8%8A%E4%B8%8B%E6%96%87%E6%98%A0%E5%B0%84%E4%B8%8E%E9%98%B2%E8%85%90")
    • [11.4 领域事件串联协作](#11.4 领域事件串联协作 "#114-%E9%A2%86%E5%9F%9F%E4%BA%8B%E4%BB%B6%E4%B8%B2%E8%81%94%E5%8D%8F%E4%BD%9C")
    • [11.5 三大库的对照分析](#11.5 三大库的对照分析 "#115-%E4%B8%89%E5%A4%A7%E5%BA%93%E7%9A%84%E5%AF%B9%E7%85%A7%E5%88%86%E6%9E%90")
  • 12.全景类图与篇章映射
    • [12.1 V5终极架构全景](#12.1 V5终极架构全景 "#121-v5%E7%BB%88%E6%9E%81%E6%9E%B6%E6%9E%84%E5%85%A8%E6%99%AF")
    • [12.2 按图索骥十一篇映射](#12.2 按图索骥十一篇映射 "#122-%E6%8C%89%E5%9B%BE%E7%B4%A2%E9%AA%A5%E5%8D%81%E4%B8%80%E7%AF%87%E6%98%A0%E5%B0%84")
    • [12.3 演进路径回望](#12.3 演进路径回望 "#123-%E6%BC%94%E8%BF%9B%E8%B7%AF%E5%BE%84%E5%9B%9E%E6%9C%9B")
  • 13.终极思考题
    • [13.1 跨平台抽象题](#13.1 跨平台抽象题 "#131-%E8%B7%A8%E5%B9%B3%E5%8F%B0%E6%8A%BD%E8%B1%A1%E9%A2%98")
    • [13.2 画质降级题](#13.2 画质降级题 "#132-%E7%94%BB%E8%B4%A8%E9%99%8D%E7%BA%A7%E9%A2%98")
    • [13.3 百万QPS改造题](#13.3 百万QPS改造题 "#133-%E7%99%BE%E4%B8%87qps%E6%94%B9%E9%80%A0%E9%A2%98")
  • 14.写在最后
# 章节 主题 关键案例 关键图表
01 面向对象设计思想 范式之别 双 11 雪崩订单系统 网状 vs 线性流程图
02 面向对象的特性 封装/抽象/继承/多态 钱包余额对不上排查 vtable 内存布局图
03 接口vs抽象类比较 何时选哪个 日志器 47 次改动复盘 决策树、模板时序图
04 接口而非实现编程 依赖抽象不依赖具体 云迁移 6 万行连锁修改 三步重构演化图
05 多用组合和少继承 继承陷阱与组合优雅 企鹅会飞继承翻车 类爆炸 vs 正交组合
06 设计原则全景图 SOLID + 23 模式 8000 行上帝类失控 SOLID 关系图
07 SOLID 原则案例汇 ⭐ SOLID 在战场上 团队三年 SOLID 之争 滥用现场扫描图
08 反模式与坏味道 ⭐ 30+ 嗅觉清单 PR 被驳回 17 次 坏味道地图
09 重构十二式实战 12 个最常用手法 1200 行结算函数救援 重构节奏循环
10 可测试性设计 ⭐ OOP 的硬验收 95% 覆盖率上线即崩 测试金字塔
11 DDD 与战术建模 ⭐ 从代码到业务 需求文档 70% 失真 限界上下文图
12 综合实战图片框架 ⭐ 完整系统实现 图片处理系统实战 完整架构图

本篇是「面向对象设计」系列第 12 篇 · 综合实战篇 。

前 11 篇我们一砖一瓦地讲了 OOP 的内功，封装、抽象、接口、组合、SOLID、坏味道、重构、可测、DDD。

但真正考验功夫的从来不是单点技巧，而是用一整套思维去救活一个真实系统 。

这一篇我们要做的事情很"野"：

拿一段真实出过事故的图片加载屎山代码 （V0），用前 11 篇的全部内功，把它一步步演进成一个媲美 Glide 的可扩展、可测试、可演进的框架 （V5）。

每一次重构都对应一篇文章的核心思想，每一次演进都附前后对比与思考题。

读完这篇，你会拥有一份**"按图索骥"的设计实践地图**，以后遇到任何类似的中间件/SDK 设计，都能照搬这套思维。

1.一场图片引发的崩溃

1.1 大促夜的事故现场

2019 年双 11 凌晨 1 点 17 分，某电商 App 客户端值班群炸了，

scss 复制代码 
[告警] iOS  端 OOM 崩溃率 4.2% (阈值 0.5%)
[告警] Android 端 ANR 率 2.8% (阈值 0.3%)
[告警] 首页瀑布流页面停留时长下降 38%
[反馈] App Store 一星评论激增："滑两下就闪退"

业务方在群里@所有人：「首页都打不开，今晚 GMV 怎么办？」

值班同学拉到崩溃栈，70% 都指向同一个类：

arduino 复制代码 
java.lang.OutOfMemoryError: Failed to allocate a 16934928 byte allocation
    at android.graphics.BitmapFactory.nativeDecodeStream
    at com.xx.image.ImageManager.loadImage   ← 凶手
    at com.xx.feed.FeedAdapter.onBindViewHolder

打开 Android Studio Profiler 看一眼内存，

yaml 复制代码 
Bitmap 对象数: 1247
Bitmap 总占用: 762 MB   ← 单个 App!
其中 50% 以上是「已经不可见的 ImageView 持有的旧 Bitmap」

1.2 排查路径与最终归因

值班同学的排查路径是这样的（这条路径每个移动开发者都走过）：

flowchart TD Start[OOM 崩溃] --> Q1{图片太大?} Q1 -- 否, CDN已缩放 --> Q2{缓存策略问题?} Q2 -- 否, LRU 正常 --> Q3{解码慢?} Q3 -- 部分是, 但不是主因 --> Q4{ImageView 复用?} Q4 -- 是! --> Root[同一个 ImageView 上叠加了 7 个未取消的旧请求] Root --> R1[7 个 Bitmap 都解码成功] Root --> R2[最后一个胜出, 前 6 个白白占内存] Root --> R3[Adapter 滑动越快, 累积越多]

最终定位的根因，是一个 5000 行的 ImageManager 上帝类：

问题 表现
静态单例 + 全局回调 没法绑定生命周期，Activity 销毁回调照样跑
请求无 ID 无取消 ImageView 复用时无法 cancel 上一个
同 url 并发不合并 列表中 10 张同图，发 10 个网络请求
Bitmap 不缩放 5MB 原图直接塞进 100×100 的 ImageView
回调地狱嵌套 网络→解码→变换→渲染，4 层 Listener
吞异常 catch (Exception e) { e.printStackTrace(); } 满天飞
sequenceDiagram participant L as 列表 Adapter participant V as ImageView (复用) participant M as ImageManager participant N as 网络 Note over L,N: 用户快速滑动 10 次 L->>V: bind(url1) V->>M: load(url1) M->>N: request1 L->>V: bind(url2) (复用) V->>M: load(url2) M->>N: request2 (request1 没取消!) L->>V: bind(url3) (复用) V->>M: load(url3) M->>N: request3 (request1,2 没取消!) Note over M,N: 7 个请求同时在路上 N-->>M: response1 (Bitmap 5MB) M-->>V: setImageBitmap(bmp1) N-->>M: response2 M-->>V: setImageBitmap(bmp2) (覆盖 bmp1, 但 bmp1 没释放) Note over V: 内存: 7 × 5MB = 35MB / 一个 cell

深夜 1 点 50 分 ，团队回滚到一周前版本，崩溃率回归 0.3%。但回滚不是终点，所有人都知道，这个 ImageManager 早晚要重写。这次重写的故事，就是本篇的全部内容。

1.3 八个灵魂拷问

事故复盘后，团队在白板上列出 8 个必须回答的问题。这 8 个问题恰好对应了一个图片加载框架的所有核心设计点，

# 问题 涉及
Q1 一次"图片加载请求"到底是什么？ 封装 / 状态机
Q2 怎么取消一个还在路上的请求？ 状态守卫
Q3 内存缓存、磁盘缓存、网络，怎么解耦？ 接口 / 抽象
Q4 JPEG / PNG / WebP / GIF 怎么扩展？ OCP / 策略
Q5 圆角、模糊、灰度变换怎么组合？ 装饰 / 组合
Q6 同一 url 并发请求怎么合并？ 单一职责 / 拦截器
Q7 怎么测试？怎么 mock 网络和时钟？ 可测试性
Q8 图片库该不该感知 Activity 生命周期？ 限界上下文

思考一下：你能不抄答案，先在脑海里给出每个问题的设计吗？带着这些问题往下读，会比直接看答案有用 10 倍。

1.4 本篇路线图

我们不会一开始就给"完美方案"，那样读者只会看一遍就忘 。我们要做的，是带你亲眼见证一段屎山如何在 11 把内功的加持下脱胎换骨。

flowchart LR V0[V0 屎山<br/>300 行能跑就行] --> V1[V1 OOP 救场<br/>封装+接口+组合] V1 --> V2[V2 SOLID 精修<br/>五原则落地] V2 --> V3[V3 重构十二式<br/>系统性手术] V3 --> V4[V4 可测试改造<br/>注入时钟与依赖] V4 --> V5[V5 DDD 上下文<br/>5 个限界上下文]
版本 篇幅占比 对应章节 关键产出
V0 屎山 10% §1 反面教材 + 17 处坏味道
V1 OOP 救场 25% §2-§4 Request 对象 / 三大端口 / 拦截器链
V2 SOLID 精修 15% §5 OCP 演示扩展 WebP / DIP 解 OkHttp 耦合
V3 重构十二式 15% §6 8 个具体重构动作
V4 可测试改造 15% §7 注入 Clock / Scheduler / Network
V5 DDD 上下文 15% §8 5 个上下文 + 防腐层 + 领域事件
全景图 + 思考题 5% §9 类图 + 11 篇映射表 + 终极思考

写在前面：所有代码用 Java 演示（移动端读者最熟），关键设计处给 Glide / Coil / SDWebImage 的真实源码对照。代码不追求可编译，追求传达思想。

2.V0版本能跑就行

2.1 三百行的屎山

下面是事故前那个 ImageManager 的简化版。真实的它有 5000 行，这里浓缩到 300 行，但所有"病灶"原汁原味保留。

请你先读一遍 ，别急着挑毛病，感受一下"看起来能跑"的代码长什么样。

java 复制代码 
// V0: 真实事故里的 ImageManager (浓缩版)
public class ImageManager {

    public static ImageManager instance;                                    // (1)
    public static Map<String, Bitmap> cache = new HashMap<>();              // (2)
    public static int MAX_SIZE = 100;                                       // (3)
    public static String DISK_DIR = "/sdcard/img_cache";                    // (4)
    public static OkHttpClient client = new OkHttpClient();                 // (5)

    public static ImageManager getInstance() {                              // (6)
        if (instance == null) instance = new ImageManager();
        return instance;
    }

    public static void loadImage(String url, ImageView iv) {                // (7)
        loadImage(url, iv, 0, 0, false, false, false, null, null);
    }

    public static void loadImage(String url, ImageView iv,                  // (8) 长参数列表
                                 int placeholder, int errorImg,
                                 boolean roundCorner, boolean blur,
                                 boolean gray, String diskKey,
                                 Callback cb) {
        if (url == null || url.length() == 0) return;                       // (9) 静默失败

        if (cache.containsKey(url)) {                                       // (10)
            iv.setImageBitmap(cache.get(url));
            if (cb != null) cb.onSuccess(cache.get(url));
            return;
        }

        if (placeholder != 0) iv.setImageResource(placeholder);

        new Thread(new Runnable() {                                         // (11) 裸线程
            @Override
            public void run() {
                Bitmap bmp = null;
                try {
                    File f = new File(DISK_DIR, diskKey != null ? diskKey : url.hashCode() + "");
                    if (f.exists()) {
                        bmp = BitmapFactory.decodeFile(f.getAbsolutePath());// (12) 主线程隐患
                    } else {
                        Request req = new Request.Builder().url(url).build();
                        Response resp = client.newCall(req).execute();
                        InputStream is = resp.body().byteStream();
                        bmp = BitmapFactory.decodeStream(is);               // (13) 不缩放
                        FileOutputStream fos = new FileOutputStream(f);
                        bmp.compress(Bitmap.CompressFormat.JPEG, 90, fos);  // (14) 主线程文件 IO
                        fos.close();
                    }

                    if (roundCorner) bmp = roundCorner(bmp);                // (15) if 阶梯
                    if (blur) bmp = blur(bmp);
                    if (gray) bmp = gray(bmp);

                    if (cache.size() >= MAX_SIZE) cache.clear();            // (16) 粗暴清空
                    cache.put(url, bmp);                                    // (17) 无 LRU

                    final Bitmap finalBmp = bmp;
                    iv.post(new Runnable() {                                // (18) iv 已被复用?
                        @Override
                        public void run() {
                            iv.setImageBitmap(finalBmp);
                            if (cb != null) cb.onSuccess(finalBmp);
                        }
                    });
                } catch (Exception e) {                                     // (19) 吞异常
                    e.printStackTrace();
                    if (errorImg != 0) iv.post(() -> iv.setImageResource(errorImg));
                }
            }
        }).start();
    }

    public static void clearCache() { cache.clear(); }                      // (20)

    private static Bitmap roundCorner(Bitmap bmp) { /* ... */ return bmp; } // (21) 静态工具
    private static Bitmap blur(Bitmap bmp)        { /* ... */ return bmp; }
    private static Bitmap gray(Bitmap bmp)        { /* ... */ return bmp; }

    public interface Callback {                                             // (22) 嵌套接口
        void onSuccess(Bitmap bmp);
        void onError(Exception e);
    }
}

调用方代码也很"经典"：

java 复制代码 
// FeedAdapter#onBindViewHolder
ImageManager.loadImage(item.imgUrl, holder.iv,
        R.drawable.placeholder, R.drawable.error,
        item.needRound, false, false, null, null);

它能跑，能加载图片，甚至能磁盘缓存，但事故就藏在这 300 行里。

2.2 找出十七处坏味道

现在开始挑刺。先盖住下面的表格，自己数一数，你能找出多少处？
展开查看（建议先自己数）

# 位置 坏味道 对应第 8 篇章节
1 (1) instance 全局可变状态 + 非线程安全单例 全局可变状态
2 (2)(3)(4)(5) 4 个 public static 字段 数据泥团 + 全局状态
3 (6) 双检锁缺失，多线程下创建多个实例 并发坏味
4 (7)(8) 重载嵌套 + 长参数列表 长参数列表
5 (8) 9 个参数中混用 int / boolean / String / Callback 数据泥团
6 (9) 静默失败 (return; 不告知调用方) 不可见错误
7 (10) HashMap 当缓存，无 LRU 无并发保护 错误抽象
8 (11) new Thread() 裸线程 资源失控
9 (12)(14) I/O 操作未走专用线程池 性能反模式
10 (13) decodeStream 不传 inSampleSize，5MB 原图直接进内存 主因之一
11 (15) if (round) ... if (blur) ... 阶梯式条件 switch/if 阶梯
12 (16) cache.size() >= MAX 时 clear() 整个清空 神奇数字 + 错误策略
13 (17) 缓存键直接用 url，相同 url 不同尺寸/变换互相覆盖 错误抽象
14 (18) iv.post 时未校验 ImageView 是否已被复用 事故根因
15 (19) catch Exception 吞异常 异常黑洞
16 (21) 静态工具方法承担领域逻辑 静态工具滥用
17 (22) Callback 嵌套在 Manager 内，回调没生命周期感知 上帝类成员
+ 综合 ImageManager 同时管缓存/网络/解码/变换/渲染 上帝类（核心病）

17 处坏味道里，真正引爆事故的只有 #14 一个 ，但其他 16 处共同构成了"事故的温床"。这就是第 8 篇说的："坏味道不是单点 bug，是系统级的腐烂。"

2.3 屎山的代价清单

我们用一张表算算这段代码的"长期成本"：

维度 V0 现状 长期代价
新增 WebP 支持 改 decodeStream 调用处 + if/else 每个调用方都要改
新增"圆角+模糊"组合 加一个 boolean roundAndBlur 参数 参数列表无限增长
想做单元测试 静态方法 + 裸线程 + 全局状态 几乎无法测
同一 url 并发合并 没地方加，要从头改 整体重写
Activity 销毁时取消请求 没有 Request ID 整体重写
列表复用图片 没有"绑定到 ImageView"的概念 事故根因

预估 ：要给 V0 加任何一个新需求，都意味着改动 3-5 处分散代码 ，并引入 2-3 个新 bug 。这就是"屎山的复利 "，它不是不能跑，是不能演进。

3.封装救场状态浮现

"封装的本质不是把字段藏起来，是把变化藏起来。" ， 第 02 篇

V0 最大的问题，是把所有变化 都摊在一个静态方法里。要救场，第一刀就是把"一次加载"这个概念封装成对象。

3.1 静态地狱的根源

回看 V0 的方法签名：

java 复制代码 
public static void loadImage(String url, ImageView iv,
        int placeholder, int errorImg,
        boolean roundCorner, boolean blur, boolean gray,
        String diskKey, Callback cb)

它在表达什么？ 9 个参数 + 1 个返回值，但没有"请求"这个概念。

后果有三：

  1. 没有 ID → 没法取消、没法去重、没法追踪
  2. 没有状态 → 不知道当前请求是"准备中""下载中"还是"已完成"
  3. 没有边界 → 错误处理、生命周期、回调全混在一个匿名 Runnable 里
flowchart LR subgraph 概念世界 Concept[一次图片加载请求] end subgraph V0 代码世界 Method[static loadImage 方法] Local1[局部变量 url] Local2[局部变量 bmp] Local3[局部 Runnable] end Concept -.失真.-> Method Concept -.失真.-> Local1 Concept -.失真.-> Local2 Concept -.失真.-> Local3

这就是第 11 篇说的"语言失真" ，业务概念在代码里被肢解成了一堆变量。封装的第一步就是把它重新拼成对象。

3.2 抽出请求对象

我们引入 ImageRequest，一次加载请求的完整建模：

java 复制代码 
// V1 第一刀: ImageRequest 不可变值对象 (Builder 构造)
public final class ImageRequest {

    private final String url;
    private final int targetWidth;          // ImageView 宽 (用于计算 inSampleSize)
    private final int targetHeight;
    private final List<Transformation> transformations;  // 变换链
    private final int placeholderResId;
    private final int errorResId;
    private final WeakReference<ImageView> targetRef;   // 弱引用, 防 ImageView 泄漏
    private final long requestId;                       // 唯一 ID, 用于取消
    private final Listener listener;

    private ImageRequest(Builder b) {
        this.url = b.url;
        this.targetWidth = b.targetWidth;
        this.targetHeight = b.targetHeight;
        this.transformations = Collections.unmodifiableList(b.transformations);
        this.placeholderResId = b.placeholderResId;
        this.errorResId = b.errorResId;
        this.targetRef = new WeakReference<>(b.target);
        this.requestId = REQ_ID_GEN.incrementAndGet();
        this.listener = b.listener;
    }

    // 只读 getter, 没有 setter -> 不可变
    public String url() { return url; }
    public long id()    { return requestId; }
    public ImageView target() { return targetRef.get(); }   // 可能为 null
    // ...

    public static final class Builder {
        // ... 构建参数 ...
        public Builder url(String url) { this.url = url; return this; }
        public Builder size(int w, int h) { this.targetWidth = w; this.targetHeight = h; return this; }
        public Builder transform(Transformation t) { this.transformations.add(t); return this; }
        public Builder placeholder(int r) { this.placeholderResId = r; return this; }
        public ImageRequest into(ImageView iv) { this.target = iv; return new ImageRequest(this); }
    }

    private static final AtomicLong REQ_ID_GEN = new AtomicLong();
}

对比一下调用方：

java 复制代码 
// V0 (参数泥团)
ImageManager.loadImage(url, iv, R.drawable.ph, R.drawable.err,
        true, false, false, null, null);

// V1 (流式 + 对象)
new ImageRequest.Builder()
    .url(url)
    .size(iv.getWidth(), iv.getHeight())
    .placeholder(R.drawable.ph)
    .error(R.drawable.err)
    .transform(new RoundCornerTransformation(8))
    .into(iv);

改善了什么？

维度 V0 V1
概念表达 一堆参数 一个 ImageRequest 对象
是否可标识 否 有 requestId
是否可取消 否 通过 ID 可取消
是否可追踪 否 可日志、可监控
调用方可读性 9 个参数容易传错 流式 API，IDE 自动补全
不可变性 Bitmap cache 全局可变 ImageRequest 全 final

这就是第 02 篇的核心 ，封装的对象不是数据袋，是带有身份与边界的概念。

3.3 引入状态机守卫

光有 ImageRequest 还不够，它还没有状态。一次加载在生命周期内会经历这些阶段：

stateDiagram-v2 [*] --> PENDING: new PENDING --> RUNNING: enqueue() PENDING --> CANCELLED: cancel() RUNNING --> SUCCESS: onComplete(bmp) RUNNING --> FAILED: onError(e) RUNNING --> CANCELLED: cancel() SUCCESS --> [*] FAILED --> [*] CANCELLED --> [*]

关键问题 ：状态转换的合法性，在 V0 里完全没人管。比如：

  • RUNNING 状态下能 cancel() 吗？ 应当能
  • SUCCESS 状态下还能 cancel() 吗？ 不应该（无意义）
  • CANCELLED 状态下还能 onComplete(bmp) 吗？ 不应该（事故根因！V0 里就是这种"已取消还回调"导致 ImageView 串图）

把状态机封装到对象内部：

java 复制代码 
public final class ImageRequest {

    public enum State { PENDING, RUNNING, SUCCESS, FAILED, CANCELLED }

    private final AtomicReference<State> state = new AtomicReference<>(State.PENDING);

    // 状态守卫: 只允许合法迁移
    boolean transitionTo(State target) {
        State curr;
        do {
            curr = state.get();
            if (!isLegalTransition(curr, target)) return false;
        } while (!state.compareAndSet(curr, target));
        return true;
    }

    private static boolean isLegalTransition(State from, State to) {
        switch (from) {
            case PENDING:   return to == State.RUNNING || to == State.CANCELLED;
            case RUNNING:   return to == State.SUCCESS || to == State.FAILED || to == State.CANCELLED;
            default:        return false;   // 终态不可再迁移
        }
    }

    public State state() { return state.get(); }
    public boolean isTerminated() {
        State s = state.get();
        return s == State.SUCCESS || s == State.FAILED || s == State.CANCELLED;
    }
}

取消的实现，这是 V0 事故根因的最终答案：

java 复制代码 
public void cancel() {
    if (transitionTo(State.CANCELLED)) {
        // 通知执行器中断 (后续在拦截器链里处理)
    }
    // 如果状态已是终态, transitionTo 返回 false, cancel 自动失效 - 幂等
}

// 在每个回调入口都先检查
void onComplete(Bitmap bmp) {
    if (!transitionTo(State.SUCCESS)) return;   // 已取消, 直接丢弃 - 修复事故根因!
    deliverToTarget(bmp);
}

关键设计点：

  1. AtomicReference<State> + CAS，线程安全
  2. transitionTo 返回 boolean 而非抛异常，调用方可优雅处理 (if (!transitionTo(...)) return;)
  3. 终态不可再迁移，幂等 ，多次 cancel() 不会出错
  4. 这是第 02 篇"封装即守卫"的精确实例，状态字段对外只读，迁移走守卫方法

3.4 值对象与缓存键

V0 还有一处隐蔽的坑：

java 复制代码 
cache.put(url, bmp);   // 同一 url, 不同尺寸/变换, 互相覆盖!

url = "https://x.png" 在列表里被同时请求为：100×100、200×200、200×200+圆角，它们应该是 3 个不同的缓存条目 ，但 V0 用 url 当 key 把它们撞成了一个。

第 11 篇的"值对象" 正好对症：

java 复制代码 
// 缓存键 = url + 尺寸 + 变换签名 (值对象, equals/hashCode 全字段)
public final class CacheKey {
    private final String url;
    private final int targetWidth;
    private final int targetHeight;
    private final String transformationSignature;  // 变换链的稳定字符串签名

    public CacheKey(ImageRequest req) {
        this.url = req.url();
        this.targetWidth = req.targetWidth();
        this.targetHeight = req.targetHeight();
        this.transformationSignature = signatureOf(req.transformations());
    }

    private static String signatureOf(List<Transformation> ts) {
        StringBuilder sb = new StringBuilder();
        for (Transformation t : ts) sb.append(t.key()).append('|');  // 每个变换提供稳定 key
        return sb.toString();
    }

    @Override
    public boolean equals(Object o) {
        if (!(o instanceof CacheKey)) return false;
        CacheKey k = (CacheKey) o;
        return targetWidth == k.targetWidth
            && targetHeight == k.targetHeight
            && Objects.equals(url, k.url)
            && Objects.equals(transformationSignature, k.transformationSignature);
    }
    @Override
    public int hashCode() {
        return Objects.hash(url, targetWidth, targetHeight, transformationSignature);
    }
}

这是第 11 篇值对象的教科书实例，

特征 体现
不可变 所有字段 final，没有 setter
无身份 两个 CacheKey 内容相同就是相等的
全字段相等 equals/hashCode 覆盖所有字段
业务语义清晰 "缓存的标识" 一目了然

小结 ：仅仅是 §2 这一节，我们就靠封装 修复了 V0 的 5 处问题（#1, #5, #13, #14, #17）。还没动 V0 的核心架构，但事故根因已经被消除。

思考题：

  1. 为什么 targetRef 用 WeakReference<ImageView> 而不是直接持有？如果直接持有会出什么问题？
  2. transformationSignature 用 Transformation#key() 拼字符串，如果不同变换返回相同 key 会怎样？这暴露了什么深层设计要求？
  3. 状态机里我们禁止终态再迁移，但 Glide 的实现允许 CLEARED → PENDING（复用 Request）。两种设计的取舍是什么？

4.抽象与接口分离

封装解决了"一次请求 "的概念，但还没解决"请求要做哪些事 "。一次完整的加载至少经过：数据源 → 解码 → 变换 → 缓存 → 渲染 。这五个阶段每一个都有多种实现，这正是抽象与接口的用武之地。

4.1 识别变化轴

第 03、04 篇反复强调："抽象是为了隔离变化"。我们先把图片加载里的"变化轴"列出来：

变化轴 例子 频率
数据来源 http / file / asset / content URI / drawable resource 每加一种来源都改
编码格式 JPEG / PNG / WebP / GIF / SVG / HEIF WebP/HEIF 后期才支持
缓存层 内存 LRU / 磁盘 LRU / 二级缓存 / 共享缓存 多产品线策略不同
网络客户端 OkHttp / HttpURLConnection / Cronet 升级或替换
变换 圆角 / 裁剪 / 模糊 / 灰度 / 水印 UI 设计随时加
调度策略 串行 / 并发 / 优先级队列 性能调优

6 条变化轴，每一条都可能在产品迭代中被替换或新增 。如果像 V0 那样把它们全揉在一个 loadImage 里，每加一种就改一次方法，这就是 OCP 的反例。

4.2 三个端口的浮现

让我们沿着"加载路径"切一刀：

flowchart LR Req[ImageRequest] --> Source[ImageSource<br/>取得字节流] --> Decoder[ImageDecoder<br/>字节流→Bitmap] --> Transform[Transformation<br/>Bitmap→Bitmap] --> Cache[ImageCache<br/>读写] --> Render[渲染]

每个箭头之间都是一次变化轴 。我们把它们抽成接口（端口）：

java 复制代码 
// 端口 1: 数据源 - 给我 url, 还我字节流
public interface ImageSource {
    InputStream open(String url) throws IOException;
    boolean supports(String url);          // 是否支持此协议
}

// 端口 2: 解码器 - 给我字节流, 还我 Bitmap
public interface ImageDecoder {
    Bitmap decode(InputStream is, int targetW, int targetH) throws IOException;
    boolean supports(byte[] header);       // 通过文件头识别格式
}

// 端口 3: 缓存 - 双向操作
public interface ImageCache {
    Bitmap get(CacheKey key);
    void put(CacheKey key, Bitmap bmp);
    void remove(CacheKey key);
    void clear();
}

注意 supports 方法 ，它让框架可以自动选择实现：

java 复制代码 
// 框架内部: 根据 url 自动挑选 Source
ImageSource selectSource(String url) {
    for (ImageSource s : sources) {
        if (s.supports(url)) return s;
    }
    throw new IllegalStateException("no source for " + url);
}

新增一种协议（如 base64 内嵌图片）只需：

java 复制代码 
public class Base64Source implements ImageSource {
    public boolean supports(String url) { return url.startsWith("data:image"); }
    public InputStream open(String url) { /* 解 base64 */ }
}

// 注册即用
loader.addSource(new Base64Source());

完全不改任何旧代码，这就是 OCP，第 06、07 篇会再次强调。

4.3 抽象类共享骨架

但接口不够 ，HttpSource / FileSource / AssetSource 三个数据源虽然取数方式不同，但都需要超时、重试、监控。这些公共骨架放接口里是污染，放每个实现里是重复。

第 03 篇的答案：抽象类与接口配合，

java 复制代码 
// 抽象类: 共享的骨架
public abstract class AbstractImageSource implements ImageSource {

    private final int maxRetry;
    private final long timeoutMs;
    private final Metrics metrics;

    @Override
    public final InputStream open(String url) throws IOException {  // final, 防子类绕过
        long start = System.currentTimeMillis();
        IOException last = null;
        for (int i = 0; i <= maxRetry; i++) {
            try {
                InputStream is = openInternal(url, timeoutMs);   // 模板方法
                metrics.recordLatency(url, System.currentTimeMillis() - start);
                return is;
            } catch (IOException e) {
                last = e;
                metrics.recordRetry(url, i);
            }
        }
        metrics.recordFailure(url);
        throw last;
    }

    /** 子类只需实现"如何取一次", 重试/监控全免费 */
    protected abstract InputStream openInternal(String url, long timeoutMs) throws IOException;
}

public class HttpSource extends AbstractImageSource {
    @Override
    protected InputStream openInternal(String url, long timeoutMs) throws IOException {
        return okHttpClient.newCall(new Request.Builder().url(url).build()).execute().body().byteStream();
    }
    @Override public boolean supports(String url) { return url.startsWith("http"); }
}

public class FileSource extends AbstractImageSource {
    @Override
    protected InputStream openInternal(String url, long timeoutMs) throws IOException {
        return new FileInputStream(url.replace("file://", ""));
    }
    @Override public boolean supports(String url) { return url.startsWith("file://"); }
}

对比第 03 篇的口诀：

接口定能力，抽象类共骨架，子类填差异。

角色 在我们的设计里
接口 ImageSource "能从 url 取字节流"，能力
抽象类 AbstractImageSource 重试/超时/监控，骨架
子类 HttpSource/FileSource "怎么取"的差异

4.4 与Glide的对照

我们设计的这个分层，Glide 是怎么做的？

打开 Glide 源码（v4.x），你会看到：

java 复制代码 
// Glide 中的对应概念
public interface ModelLoader<Model, Data> {           // ≈ 我们的 ImageSource
    LoadData<Data> buildLoadData(Model model, int width, int height, Options options);
    boolean handles(Model model);                     // ≈ 我们的 supports
}

public interface ResourceDecoder<T, Z> {              // ≈ 我们的 ImageDecoder
    Resource<Z> decode(T source, int width, int height, Options options);
    boolean handles(T source, Options options);
}

public interface DiskCache { /* ... */ }              // ≈ 我们的 ImageCache (只读写)
public interface MemoryCache { /* ... */ }            //     (内存版)

Glide 的 Registry 类就是"端口注册表" ，所有 ModelLoader/Decoder/Encoder 在 Application 启动时注册进去，运行时按 handles 自动匹配。

这意味着什么？ 你今天读完这一节理解的"端口 + 注册表"模式，直接就能读懂 Glide / Coil 的核心架构，它们用的是同一套 OOP 思想，只是命名和细节不同。

框架 数据源端口 解码器端口 缓存端口
我们 ImageSource ImageDecoder ImageCache
Glide ModelLoader ResourceDecoder DiskCache / MemoryCache
Coil Fetcher Decoder MemoryCache / DiskCache
SDWebImage SDImageLoader SDImageCoder SDImageCache

思考题：

  1. Glide 的 ModelLoader<Model, Data> 是泛型的，可以处理任意 Model（不只是 String url，还可以是 Uri、File、byte\[\]）。我们的 ImageSource 写死了 String url，这有什么代价？什么时候该升级到泛型？
  2. 如果我们想加"预下载"（不解码，只下载到磁盘），应该新增端口还是改造现有端口？为什么？
  3. AbstractImageSource#open 加了 final，这强制了什么、又限制了什么？是否违反了 LSP？

5.组合优于继承

§2 解决了"请求是什么"，§3 解决了"加载分几步"。但还有一个问题没回答，这些步骤怎么串起来？

直觉上，可能会想到继承，这恰好是第 05 篇要破除的"继承陷阱"。

5.1 继承式方案的爆炸

假设我们用继承串流程，会自然演化成下面这个体系：

java 复制代码 
abstract class BaseLoader { abstract Bitmap load(ImageRequest req); }

class CachedLoader extends BaseLoader {           // 加缓存
    Bitmap load(ImageRequest req) {
        Bitmap b = cache.get(req);
        if (b != null) return b;
        b = doLoad(req);
        cache.put(req, b);
        return b;
    }
    abstract Bitmap doLoad(ImageRequest req);
}

class RetryableCachedLoader extends CachedLoader {  // 加重试
    Bitmap doLoad(ImageRequest req) {
        for (int i = 0; i < 3; i++) try { return realLoad(req); } catch (Exception e) {}
        throw new RuntimeException("retry exhausted");
    }
    abstract Bitmap realLoad(ImageRequest req);
}

class MetricsRetryableCachedLoader extends RetryableCachedLoader {  // 加监控
    Bitmap realLoad(ImageRequest req) {
        long t = System.currentTimeMillis();
        try { return doRealLoad(req); }
        finally { metrics.record(System.currentTimeMillis() - t); }
    }
    abstract Bitmap doRealLoad(ImageRequest req);
}

// 还要再加: 限流, 优先级, 去重, 灰度...
// MetricsRetryableCachedThrottledPriorityDedupGrayLoader extends ...

问题暴露得很彻底：

flowchart LR Base[BaseLoader] --> Cached[CachedLoader] Cached --> Retry[RetryableCachedLoader] Retry --> Metrics[MetricsRetryableCachedLoader] Metrics --> Throttle[+Throttle] Throttle --> Priority[+Priority] Priority --> Dedup[+Dedup] Dedup --> Final[&#34;MetricsRetryableCachedThrottledPriorityDedupLoader<br/>(类名 67 字符)&#34;]

6 个能力 = 6 层继承 = 类爆炸。更糟的是：

  • 想要"只重试 + 监控，不要缓存 " → 没办法，重试在缓存的子类里
  • 想要"先限流再重试 " → 顺序写死在继承链里，改不了
  • 子类发现父类某个方法逻辑有 bug → 改了影响所有子孙类

这正是第 05 篇说的 ：继承表达的是"is-a"，但"加缓存"不是"is-a"，是"附加能力"。

5.2 拦截器链的诞生

把每个能力变成一个独立对象 ，让它们串成链 ，这就是 OkHttp / Glide 都用的 Interceptor Chain。

java 复制代码 
// 拦截器接口
public interface Interceptor {
    Bitmap intercept(Chain chain) throws IOException;

    interface Chain {
        ImageRequest request();
        Bitmap proceed(ImageRequest req) throws IOException;
    }
}

每个能力都是一个独立的 Interceptor：

java 复制代码 
// 能力 1: 内存缓存
public class MemoryCacheInterceptor implements Interceptor {
    private final ImageCache cache;
    @Override
    public Bitmap intercept(Chain chain) throws IOException {
        ImageRequest req = chain.request();
        CacheKey key = new CacheKey(req);
        Bitmap hit = cache.get(key);
        if (hit != null) return hit;                 // 命中, 短路返回
        Bitmap result = chain.proceed(req);          // 未命中, 继续往下
        if (result != null) cache.put(key, result);
        return result;
    }
}

// 能力 2: 监控
public class MetricsInterceptor implements Interceptor {
    @Override
    public Bitmap intercept(Chain chain) throws IOException {
        long t = System.currentTimeMillis();
        try {
            return chain.proceed(chain.request());
        } finally {
            metrics.record(chain.request().url(), System.currentTimeMillis() - t);
        }
    }
}

// 能力 3: 同 url 并发去重 (修复 V0 #6 痛点)
public class DedupInterceptor implements Interceptor {
    private final Map<CacheKey, FutureTask<Bitmap>> inflight = new ConcurrentHashMap<>();
    @Override
    public Bitmap intercept(Chain chain) throws IOException {
        CacheKey key = new CacheKey(chain.request());
        FutureTask<Bitmap> existing = inflight.get(key);
        if (existing != null) {                      // 已有同 key 在路上, 等它的结果
            try { return existing.get(); } catch (Exception e) { throw new IOException(e); }
        }
        FutureTask<Bitmap> task = new FutureTask<>(() -> chain.proceed(chain.request()));
        FutureTask<Bitmap> raced = inflight.putIfAbsent(key, task);
        if (raced != null) try { return raced.get(); } catch (Exception e) { throw new IOException(e); }
        try {
            task.run();
            return task.get();
        } catch (Exception e) { throw new IOException(e); }
        finally { inflight.remove(key); }
    }
}

// 能力 N: 网络/解码/变换 全部都是 Interceptor
public class NetworkInterceptor implements Interceptor { /* ... */ }
public class DecodeInterceptor implements Interceptor { /* ... */ }
public class TransformInterceptor implements Interceptor { /* ... */ }

链的执行：

java 复制代码 
public class RealChain implements Interceptor.Chain {
    private final List<Interceptor> interceptors;
    private final int index;
    private final ImageRequest request;

    @Override
    public Bitmap proceed(ImageRequest req) throws IOException {
        if (index >= interceptors.size()) throw new IllegalStateException("no terminal");
        Interceptor next = interceptors.get(index);
        RealChain nextChain = new RealChain(interceptors, index + 1, req);
        return next.intercept(nextChain);
    }
}

5.3 能力可插拔实战

装配阶段自由组合：

java 复制代码 
// 标准生产配置
List<Interceptor> chain = Arrays.asList(
    new MetricsInterceptor(),       // 最外层: 度量整体耗时
    new MemoryCacheInterceptor(memCache),
    new DedupInterceptor(),         // 同 key 并发合并
    new DiskCacheInterceptor(diskCache),
    new NetworkInterceptor(httpSource),
    new DecodeInterceptor(decoderRegistry),
    new TransformInterceptor()      // 终端: 不再 proceed
);
flowchart LR Req[Request] --> M[Metrics] M --> Mem[MemCache] Mem -- 命中 --> Out[返回] Mem -- 未命中 --> D[Dedup] D --> Disk[DiskCache] Disk -- 命中 --> Out Disk -- 未命中 --> N[Network] N --> Dec[Decode] Dec --> T[Transform] T --> Out

测试场景：去掉网络只走缓存：

java 复制代码 
List<Interceptor> chain = Arrays.asList(
    new MemoryCacheInterceptor(memCache),
    new TerminalInterceptor()       // 命中即返回, 否则抛 NoSuchElement
);

调试场景：加一个日志拦截器到任意位置：

java 复制代码 
chain.add(2, new LoggingInterceptor());   // 直接 add, 无侵入

对比继承式：

维度 继承式 拦截器链
加一个新能力 新增子类 + 改父类 写一个 Interceptor，加到 list
能力顺序调整 不可能，写死在继承链 改 list 顺序即可
临时去掉某能力 改类继承结构 从 list 移除
测试时替换 复杂 装配时给 fake list
类数量 6 能力 = 6 类（最深 6 层） 6 能力 = 6 类（无继承）
复用单一能力 必须连父类一起 可独立使用

这正是第 05 篇的核心结论 ：当能力可以"按需组合、动态调整、独立演化"时，组合永远优于继承。

5.4 与OkHttp的同构

如果你看过 OkHttp 源码，会发现我们刚才推导的设计，和 OkHttp 几乎逐行同构：

java 复制代码 
// OkHttp 源码 (简化)
public interface Interceptor {
    Response intercept(Chain chain) throws IOException;
}

// 真实的 OkHttp 拦截器链
new RealCall.execute()
    └─ retryAndFollowUpInterceptor   // 重试
    └─ bridgeInterceptor             // header 处理
    └─ cacheInterceptor              // HTTP 缓存
    └─ connectInterceptor            // 建立连接
    └─ networkInterceptor            // 网络 IO

Glide 的 RequestBuilder + Engine + EngineJob 内部也是同构思路，Engine 维护"正在进行中的 Job 表"做去重，EngineJob 串起"内存→磁盘→源"的查找。

框架 链式抽象命名
OkHttp Interceptor + RealInterceptorChain
Glide DataFetcherGenerator + LoadPath
Coil Interceptor + RealInterceptorChain (直接借鉴 OkHttp)
Retrofit CallAdapter + Converter (链式装饰)
Spring MVC HandlerInterceptor
Servlet Filter

同一个思想，在 N 个领域被独立"重新发明"，这就是第 05 篇说的"组合优于继承"在工业界的真实分量。

思考题：

  1. MemoryCacheInterceptor 既负责"读"又负责"写"，这违反了 SRP 吗？如果拆成两个会怎样？
  2. 如果某个 Interceptor 在 proceed 之后再读 request，可能拿到与开始时不同的 request 吗？为什么？
  3. DedupInterceptor 用 ConcurrentHashMap + FutureTask，如果第二个等待者被 cancel，该不该取消正在跑的那一个？设计上的取舍是什么？

6.V1阶段小结

走到这里，V0 的事故根因已经被根治，主体架构脱胎换骨，

flowchart TB subgraph V0[V0: 屎山] GodClass[ImageManager 上帝类<br/>5000 行 / 17 处坏味道] end subgraph V1[V1: OOP 救场后] Req[ImageRequest<br/>不可变 + 状态机] Key[CacheKey<br/>值对象] Port1[ImageSource 端口] Port2[ImageDecoder 端口] Port3[ImageCache 端口] Chain[Interceptor 链<br/>能力可插拔] Req --> Chain Chain --> Port1 & Port2 & Port3 Key -.缓存键.- Port3 end V0 -.第02-05篇内功.-> V1

这一阶段我们用到的篇章内功：

篇章 应用点
02 封装 ImageRequest 不可变 + 状态机守卫
03 接口 vs 抽象类 ImageSource 接口 + AbstractImageSource 骨架
04 面向接口编程 三大端口 + 注册表选择
05 组合优于继承 拦截器链替代继承式 Loader
11 值对象 CacheKey 不可变全字段相等

消除的坏味道（17 处中的 8 处）：

序号 问题 解决方式
#1 单例 通过 Builder 构造 + 注入 §2
#5 数据泥团 ImageRequest 对象 §2.2
#11 if 阶梯 Transformation 链 + 拦截器 §4
#13 缓存键错 CacheKey 值对象 §2.4
#14 复用串图 状态机 + 弱引用 §2.3
#15 异常黑洞 拦截器 try/finally + 状态机 FAILED §4
#17 上帝类 拆成 Request / Source / Decoder / Cache / Interceptor §3-§4
#18 if 阶梯 拦截器顺序代替条件分支 §4

剩下的 9 处坏味道，下一阶段（V2/V3）继续解决，我们将在下一篇/下一节里：

  • §5 用 SOLID 五原则给框架做精修（OCP 演示扩展 WebP / DIP 解 OkHttp 耦合）
  • §6 用重构十二式做系统性手术（提取方法 / 引入参数对象 / 用多态替换条件 / ...）
  • §7 把整个框架改造成可测，注入 Clock / Scheduler / Network
  • §8 用 DDD 划分 5 个限界上下文，给框架画一张"地图"

写到这里你应该有的感觉 ：前面 11 篇看起来零散的内功，在一个真实场景里被串成了一根绳。封装解决"概念"，接口解决"变化轴"，组合解决"能力堆叠"，三者缺一不可。 下一阶段，我们要把"能跑且优雅"的 V1，变成"能扩、能测、能演进"的 V5。

7.SOLID五原则精修

V1 用三大内功救活了 V0，但仔细审视会发现，它"能跑得不错"，但还没"能扩得优雅"。比如：

  • ImageRequest 既描述请求、又持有状态、又承担取消逻辑，SRP 边界还模糊
  • NetworkInterceptor 内部 new OkHttpClient()，DIP 没贯彻
  • ImageCache 接口既要 get 又要 put 又要 clear，ISP 颗粒太粗

V2 这一阶段，我们用 SOLID 五原则逐条对症下药 ，每条原则给一个具体重构动作 ，改一行算一行。

7.1 SRP拆解请求职责

回看 V1 的 ImageRequest，职责清单有这些：

markdown 复制代码 
1. 描述加载参数 (url/size/transformations)
2. 持有目标 ImageView 弱引用
3. 维护状态机 (PENDING/RUNNING/...)
4. 承担取消逻辑
5. 触发回调

第 06 篇 SRP 的检验法 ："给这个类找出多少个独立的"修改理由"？" 上面 5 条对应 5 类不同的需求方：

修改理由 谁会提需求
增加新参数（如优先级） 业务调用方
改变弱引用策略 内存优化团队
增加新状态（如 PAUSED） 调度团队
改取消机制（链路级取消） 框架核心团队
加新回调（onProgress） UI 团队

5 个修改理由 = 1 个类要被 5 拨人改 = SRP 红牌。拆，

flowchart LR Req[ImageRequest<br/>纯描述参数<br/>不可变值对象] Tgt[Target<br/>渲染抽象] Disp[Disposable<br/>取消句柄] State[RequestState<br/>状态机] Listener[RequestListener<br/>回调集合] Req -.参数.-> Disp Req -.参数.-> Tgt Disp --> State Disp --> Listener

拆完之后：

java 复制代码 
// 1. ImageRequest: 纯描述参数 (不可变 DTO/值对象)
public final class ImageRequest {
    public final String url;
    public final int targetWidth, targetHeight;
    public final List<Transformation> transformations;
    public final int placeholderResId, errorResId;
    public final Priority priority;
    // 没有 state, 没有 ImageView, 没有 cancel - 它就是一份"订单"
}

// 2. Target: 渲染抽象, 解耦 ImageView
public interface Target {
    void onLoadStarted(Drawable placeholder);
    void onResourceReady(Bitmap bitmap);
    void onLoadFailed(Drawable errorDrawable, Throwable cause);
    int getWidth();
    int getHeight();
}
public class ImageViewTarget implements Target { /* 持 WeakReference<ImageView> */ }
public class FileTarget implements Target      { /* 写到文件: 用于预下载 */ }
public class CallbackTarget implements Target  { /* 回调到业务方 */ }

// 3. Disposable: 取消句柄 (调用方拿到的"凭证")
public interface Disposable {
    boolean isDisposed();
    void dispose();
}

// 4. RequestState: 状态机 (从 ImageRequest 中抽出来)
public final class RequestState {
    private final AtomicReference<State> state = new AtomicReference<>(State.PENDING);
    boolean transitionTo(State target) { /* CAS 守卫 */ }
}

// 5. RequestListener: 回调集合
public interface RequestListener {
    void onStart(ImageRequest req);
    void onSuccess(ImageRequest req, Bitmap bmp);
    void onError(ImageRequest req, Throwable cause);
}

调用方代码的变化：

java 复制代码 
// V1
ImageRequest req = new ImageRequest.Builder().url(url).into(iv);
req.cancel();  // 业务方持有 ImageRequest 还能 cancel - 职责不清

// V2
Disposable handle = imageLoader.load(  // 业务方拿到的是"取消凭证", 而非请求本身
    new ImageRequest.Builder().url(url).build(),
    new ImageViewTarget(iv)
);
handle.dispose();  // 凭证只能干一件事: dispose

关键改善：

维度 V1 V2
ImageRequest 职责 5 个 1 个（描述）
是否可序列化（用于持久化队列） 否（含 WeakReference） 是（纯 DTO）
Target 可扩展性 写死 ImageView Target 接口可扩文件/回调
调用方拿到的对象 整个 Request（能改） Disposable（只能取消）

思考 ：Glide 的 Request 接口同样独立于 Target，调用方拿到的是 RequestBuilder，最终交给 RequestManager 管理生命周期。这种"请求/目标/句柄 三分"的设计在 OkHttp、Retrofit、RxJava 都能看到，SRP 不是写出来的，是反复拆出来的。

7.2 OCP扩展WebP不改旧码

OCP 最经典的检验题：新增一种图片格式 。V1 已经有 ImageDecoder 端口和 DecoderRegistry，但 OCP 是否真的成立？

做实验 ：业务方提需求："支持 WebP"。

java 复制代码 
// 第一步: 新增一个 Decoder, 不动任何旧文件
public class WebpDecoder implements ImageDecoder {
    @Override
    public boolean supports(byte[] header) {
        // WebP 文件头: "RIFF????WEBP"
        return header.length >= 12
            && header[0] == 'R' && header[1] == 'I' && header[2] == 'F' && header[3] == 'F'
            && header[8] == 'W' && header[9] == 'E' && header[10] == 'B' && header[11] == 'P';
    }
    @Override
    public Bitmap decode(InputStream is, int targetW, int targetH) throws IOException {
        // 调用 libwebp 或 BitmapFactory (Android 4.0+ 原生支持)
        return BitmapFactory.decodeStream(is, null, optionsFor(targetW, targetH));
    }
}

// 第二步: 注册 (一行代码)
loader.registry().registerDecoder(new WebpDecoder());

// 完成. 没有改任何旧文件.

统计修改：

改动文件 行数
WebpDecoder.java（新文件） +35
配置注册（应用层） +1
修改旧文件 0

这就是教科书级的 OCP，对扩展开放（加新 Decoder），对修改关闭（旧 Decoder 一行不动）。

但 OCP 不是免费的 ，它要求预留正确的扩展点 。如果一开始 V0 那样把解码写死成 BitmapFactory.decodeStream，今天加 WebP 就要改所有调用处。

OCP 的代价表：

决策点 成本 收益
V0：直接调 BitmapFactory 简单 加格式要全局改
V1：抽 ImageDecoder 接口 多 1 个抽象层 加格式 0 修改
进一步：让 Decoder 接受 Options 泛型 接口更复杂 支持任意自定义参数

第 07 篇说过 ："OCP 不是越多越好，而是要押对变化轴 。" 我们押的是"格式会变化"，历史证明这是对的（JPEG → PNG → WebP → HEIF → AVIF）。

06.3 LSP前置后置条件

LSP 在我们这里有一个真实的陷阱，

V1 里 ImageCache 接口长这样：

java 复制代码 
public interface ImageCache {
    Bitmap get(CacheKey key);   // 未命中返回 null
    void put(CacheKey key, Bitmap bmp);
}

现在我们要实现两个版本：

java 复制代码 
public class MemoryCache implements ImageCache {
    public Bitmap get(CacheKey key) {
        return lru.get(key);          // null 表示未命中, OK
    }
    public void put(CacheKey key, Bitmap bmp) {
        lru.put(key, bmp);            // 正常返回
    }
}

public class DiskCache implements ImageCache {
    public Bitmap get(CacheKey key) throws IOException {  // ⚠️ 抛 IO 异常?
        File f = fileFor(key);
        if (!f.exists()) return null;
        return BitmapFactory.decodeFile(f.getAbsolutePath());  // 解码失败抛异常?
    }
    public void put(CacheKey key, Bitmap bmp) throws IOException {  // ⚠️ 写盘失败?
        // ...
    }
}

LSP 的核心拷问：调用方代码写成这样，

java 复制代码 
ImageCache cache = ...;  // 编译期看到的是接口
Bitmap b = cache.get(key);   // 这一行可能抛异常吗?

如果调用方拿到 MemoryCache 永远不抛异常，但拿到 DiskCache 会抛，子类比父类要求更严 ，违反 LSP。

第 07 篇的方法论 ："前置条件不可加强，后置条件不可减弱，异常不可新增。"

修正方案，让接口承载最严格的契约：

java 复制代码 
public interface ImageCache {
    /**
     * @return 未命中时返回 null; 任何 I/O / 解码失败一律视为"未命中"返回 null
     *         实现方必须吞掉异常, 不允许向上抛
     */
    Bitmap get(CacheKey key);

    /**
     * 静默写入. 失败时记录日志但不抛.
     */
    void put(CacheKey key, Bitmap bmp);
}

// DiskCache 的修正
public class DiskCache implements ImageCache {
    public Bitmap get(CacheKey key) {
        try {
            File f = fileFor(key);
            if (!f.exists()) return null;
            return BitmapFactory.decodeFile(f.getAbsolutePath());
        } catch (Exception e) {
            log.warn("disk cache read failed, treat as miss", e);
            return null;          // 守住后置条件
        }
    }
    public void put(CacheKey key, Bitmap bmp) {
        try { /* 写盘 */ }
        catch (Exception e) {
            log.warn("disk cache write failed", e);   // 不抛
        }
    }
}

为什么这样设计是对的？ 因为缓存层的业务语义就是"最佳努力" ，失败了大不了走下一层（网络）。把 I/O 异常当作"未命中"语义化处理，调用方代码极度简洁：

java 复制代码 
Bitmap b = cache.get(key);
if (b != null) return b;        // 一行搞定 - 不需要 try-catch
return chain.proceed(req);

LSP 不是技术约束，是语义契约 ，同一个接口的不同实现，对调用方应该是无感的 。这一节我们没有"添加"功能，而是"统一了语义"，这种重构在工程上极其有价值。

06.4 ISP拆分缓存接口

ImageCache 现在 4 个方法：get / put / remove / clear。但实际场景中，

场景 用到的方法
拦截器读缓存 get
拦截器写缓存 put
用户主动清缓存 clear
LRU 淘汰策略 remove
只读型缓存（如 CDN 镜像缓存） 仅 get
预热缓存（仅写入） 仅 put

第 07 篇 ISP 的口诀 ："强迫类依赖它不需要的方法 = 隐式耦合。"

如果 MemoryCacheInterceptor 依赖 ImageCache 整个接口，但它只用 get/put，某天 ImageCache 里加个 iterator() 方法，所有依赖方都要重新编译。

拆分：

java 复制代码 
public interface CacheReader {
    Bitmap get(CacheKey key);
}

public interface CacheWriter {
    void put(CacheKey key, Bitmap bmp);
}

public interface CacheEvictor {
    void remove(CacheKey key);
    void clear();
}

// 大部分实现同时实现三者
public class MemoryCache implements CacheReader, CacheWriter, CacheEvictor { ... }

// 但调用方可以只声明它需要的
public class MemoryCacheInterceptor {
    private final CacheReader reader;       // 只读
    private final CacheWriter writer;       // 只写
    // 不需要 CacheEvictor - 编译期就保证不会误用
}

public class CacheClearAction {
    private final CacheEvictor evictor;     // 只清
}

收益：

维度 改善
编译期约束 拦截器不可能误调 clear
Mock 测试 只需 mock CacheReader 就能测命中逻辑
演进灵活 新增"只读 CDN 镜像缓存"只需实现 CacheReader

但 ISP 也有度 ，拆得太细会变成"接口爆炸"。比如把 get 拆成 getOrNull / getOrThrow / getAsync 就过度了。判断标准 ：拆分边界 = 不同调用方的不同需求集合。

06.5 DIP解OkHttp耦合

打开 V1 的 NetworkInterceptor：

java 复制代码 
public class NetworkInterceptor implements Interceptor {
    private final OkHttpClient client = new OkHttpClient();   // ⚠️ 直接 new

    public Bitmap intercept(Chain chain) throws IOException {
        Response resp = client.newCall(...).execute();        // 依赖具体实现
        // ...
    }
}

问题清单：

  1. 框架硬依赖 OkHttp，业务方想用 Cronet / HttpURLConnection / 自家 HTTP 库都不行
  2. 测试时无法注入 mock 网络
  3. 如果业务 App 已经初始化过一个 OkHttpClient（带拦截器/证书/dns 配置），这里又 new 一个，资源浪费
  4. 升级 OkHttp 大版本时，框架被牵连

第 06 篇 DIP 的核心 ："高层模块不应依赖低层模块，两者都应依赖抽象。"

flowchart TD subgraph V1[V1 - 违反 DIP] High1[NetworkInterceptor] Low1[OkHttpClient] High1 -- 直接依赖 --> Low1 end subgraph V2[V2 - 遵守 DIP] High2[NetworkInterceptor] Abs[HttpClient 抽象] Low2a[OkHttpAdapter] Low2b[CronetAdapter] Low2c[FakeHttpClient<br/>测试] High2 --> Abs Low2a --> Abs Low2b --> Abs Low2c --> Abs end

实施：

java 复制代码 
// 抽象 (在框架核心模块, 不依赖任何 HTTP 库)
public interface HttpClient {
    HttpResponse execute(HttpRequest req) throws IOException;
}

public final class HttpRequest {
    public final String url;
    public final Map<String, String> headers;
    public final long timeoutMs;
}

public final class HttpResponse {
    public final int statusCode;
    public final InputStream body;
    public final Map<String, String> headers;
    public final long contentLength;
}

// OkHttp 适配器 (在独立的 adapter 模块, 可选依赖)
public class OkHttpAdapter implements HttpClient {
    private final OkHttpClient delegate;
    public OkHttpAdapter(OkHttpClient delegate) { this.delegate = delegate; }

    @Override
    public HttpResponse execute(HttpRequest req) throws IOException {
        Request okReq = new Request.Builder().url(req.url).build();
        Response okResp = delegate.newCall(okReq).execute();
        return new HttpResponse(
            okResp.code(),
            okResp.body().byteStream(),
            toMap(okResp.headers()),
            okResp.body().contentLength()
        );
    }
}

// Cronet 适配器 (字节跳动 / Google 体系常用)
public class CronetAdapter implements HttpClient { /* ... */ }

// HttpURLConnection 适配器 (零依赖兜底)
public class JdkHttpAdapter implements HttpClient { /* ... */ }

// NetworkInterceptor 现在只依赖 HttpClient 抽象
public class NetworkInterceptor implements Interceptor {
    private final HttpClient http;   // 注入
    public NetworkInterceptor(HttpClient http) { this.http = http; }

    public Bitmap intercept(Chain chain) throws IOException {
        HttpResponse resp = http.execute(buildRequest(chain.request()));
        // ...
    }
}

业务方装配：

java 复制代码 
ImageLoader loader = new ImageLoader.Builder()
    // 业务 App 可以传入它已有的 OkHttpClient (复用拦截器/证书/dns)
    .httpClient(new OkHttpAdapter(myAppOkHttpClient))
    // 或者切换到 Cronet
    // .httpClient(new CronetAdapter(cronetEngine))
    .build();

测试：

java 复制代码 
HttpClient fake = req -> new HttpResponse(200, new ByteArrayInputStream(testBytes), ...);
ImageLoader loader = new ImageLoader.Builder().httpClient(fake).build();
// 现在可以测试网络层任何场景: 200 / 404 / 超时 / 慢响应 / 中断

这一招的延伸价值 ，Glide 4.x 也走了同一条路 。Glide 早期硬编码 HttpURLConnection，4.x 引入 HttpUrlFetcher 抽象，并提供 ok-http3-integration / okhttp-integration 模块作为适配器。

DIP 的精髓 ：让你的核心代码不知道它正在用 OkHttp，核心代码只知道"有个能发 HTTP 请求的东西"。

§6 阶段成果汇总：

原则 重构动作 文件数变化
SRP 拆 ImageRequest 为 5 个角色 +4 类
OCP WebpDecoder 即插即用 +1 类，旧码 0 改
LSP 统一 ImageCache.get 后置条件（不抛异常） 改 2 文件
ISP ImageCache → CacheReader/Writer/Evictor +2 接口
DIP OkHttp 耦合解除 → HttpClient 抽象 + 适配器 +3 类

思考题：

  1. SRP 拆出了 Disposable 句柄，但状态机 RequestState 内嵌在何处？由 Disposable 持有还是 Engine 持有？两种放法在并发取消场景下有何差异？
  2. OCP 的"加 WebP 不改旧码"成立，但移除 PNG 支持是否依然零修改？为什么？这个不对称暴露了什么？
  3. 我们用 LSP 把 DiskCache 异常吞掉返回 null，但如果磁盘满这种严重错误也吞掉，会不会让框架"沉默地烂掉"？怎么权衡？

8.重构十二式实战

如果说 §6 的 SOLID 是"战略调整 "，本节的重构十二式就是"战术手术 "，逐个具体动作，每个都有可见的 diff。

我们挑 8 个对图片框架最具改造价值的手术，对应第 09 篇的十二式。

07.1 提取方法解码逻辑

V1 的 DecodeInterceptor 长这样：

java 复制代码 
public Bitmap intercept(Chain chain) throws IOException {
    ImageRequest req = chain.request();
    InputStream is = chain.proceed(req);    // 上一层给我字节流
    byte[] header = readHeader(is, 12);
    ImageDecoder dec = null;
    for (ImageDecoder d : decoders) {
        if (d.supports(header)) { dec = d; break; }
    }
    if (dec == null) throw new IOException("no decoder for header: " + Arrays.toString(header));

    BitmapFactory.Options opts = new BitmapFactory.Options();
    opts.inJustDecodeBounds = true;
    InputStream is2 = combine(header, is);
    BitmapFactory.decodeStream(is2, null, opts);

    int sample = 1;
    int w = opts.outWidth, h = opts.outHeight;
    while ((w / sample) > req.targetWidth || (h / sample) > req.targetHeight) sample *= 2;

    BitmapFactory.Options realOpts = new BitmapFactory.Options();
    realOpts.inSampleSize = sample;
    realOpts.inPreferredConfig = Bitmap.Config.RGB_565;

    InputStream is3 = combine(header, is);
    return dec.decode(is3, req.targetWidth, req.targetHeight);
}

坏味道：单方法 30+ 行，干了 4 件事。

第 09 篇第一式：提取方法，按"自然的语义边界"拆：

java 复制代码 
public Bitmap intercept(Chain chain) throws IOException {
    ImageRequest req = chain.request();
    InputStream is = chain.proceed(req);
    byte[] header = readHeader(is, HEADER_PROBE_SIZE);

    ImageDecoder decoder = selectDecoder(header);          // 提取
    int sampleSize = computeSampleSize(header, is, req);   // 提取
    return decoder.decode(rewind(header, is), req.targetWidth, req.targetHeight);
}

private ImageDecoder selectDecoder(byte[] header) throws IOException {
    for (ImageDecoder d : decoders) if (d.supports(header)) return d;
    throw new IOException("no decoder for header: " + hex(header));
}

private int computeSampleSize(byte[] header, InputStream is, ImageRequest req) throws IOException {
    BitmapFactory.Options probe = new BitmapFactory.Options();
    probe.inJustDecodeBounds = true;
    BitmapFactory.decodeStream(rewind(header, is), null, probe);
    int sample = 1;
    while ((probe.outWidth / sample) > req.targetWidth
        || (probe.outHeight / sample) > req.targetHeight) {
        sample *= 2;
    }
    return sample;
}

改善：

维度 Before After
主方法行数 30+ 5
主方法读出意图 难 一眼："选解码器→算采样→解码"
单元测试 整体测 selectDecoder / computeSampleSize 各自可独立测
修改采样算法影响 改主方法 改 computeSampleSize 一处

提取方法的判断标准是 09 篇说的"注释即代码" ，如果你给某段代码加注释 // 计算采样率，就把它提成 computeSampleSize 方法，注释和方法名同义。

07.2 引入参数对象LoadOptions

V2 的 Builder 已经攒了 8 个字段：

java 复制代码 
new ImageRequest.Builder()
    .url(url)
    .size(w, h)
    .placeholder(R.drawable.ph)
    .error(R.drawable.err)
    .priority(Priority.HIGH)
    .skipMemoryCache(false)
    .skipDiskCache(false)
    .timeout(5000)
    .build();

未来还会再加：onlyRetrieveFromCache / format / crossfadeDuration / targetDensity...

第 09 篇第二式：引入参数对象 ，把"经常一起出现的参数"打包：

java 复制代码 
// LoadOptions: 加载选项 (调度/缓存/超时类参数)
public final class LoadOptions {
    public static final LoadOptions DEFAULT = new Builder().build();

    public final Priority priority;
    public final boolean skipMemoryCache, skipDiskCache;
    public final long timeoutMs;
    public final boolean onlyRetrieveFromCache;

    public static final class Builder { /* ... */ }
}

// DisplayOptions: 显示选项 (UI 类参数)
public final class DisplayOptions {
    public final int placeholderResId, errorResId;
    public final long crossfadeDurationMs;
    public final ScaleType scaleType;
}

// ImageRequest 现在简洁很多
public final class ImageRequest {
    public final String url;
    public final int targetWidth, targetHeight;
    public final List<Transformation> transformations;
    public final LoadOptions loadOptions;
    public final DisplayOptions displayOptions;
}

调用方：

java 复制代码 
new ImageRequest.Builder()
    .url(url)
    .size(w, h)
    .loadOptions(LoadOptions.HIGH_PRIORITY_NO_DISK)   // 复用预定义常量
    .displayOptions(new DisplayOptions.Builder()
        .placeholder(R.drawable.ph)
        .crossfade(300)
        .build())
    .build();

额外收益 ：可以预定义常量配置：

java 复制代码 
public final class LoadOptions {
    public static final LoadOptions DEFAULT;
    public static final LoadOptions HIGH_PRIORITY_NO_DISK;
    public static final LoadOptions LOW_PRIORITY_FORCE_NETWORK;
    public static final LoadOptions BACKGROUND_PREFETCH;
}

，这就把"配置策略 "沉淀成了领域语言，调用方不用重复装配。

07.3 用多态替换条件

V0 的"if 阶梯"还残留在 Transformation 调用处？在 V1 中我们已经用 Transformation 接口干掉了第一层 if，但调度策略还有第二层 if：

java 复制代码 
public class DispatchInterceptor implements Interceptor {
    public Bitmap intercept(Chain chain) throws IOException {
        ImageRequest req = chain.request();
        if (req.url.startsWith("http"))      return dispatchToNetworkPool(chain);
        else if (req.url.startsWith("file")) return dispatchToDiskPool(chain);
        else if (req.url.startsWith("asset"))return dispatchToAssetPool(chain);
        else if (req.url.startsWith("data:image"))return dispatchToInlinePool(chain);
        else throw new IOException("unsupported scheme");
    }
}

第 09 篇第三式：用多态替换条件，

java 复制代码 
// 抽象: 调度策略
public interface Dispatcher {
    boolean accepts(ImageRequest req);
    Bitmap dispatch(Interceptor.Chain chain) throws IOException;
}

public class NetworkDispatcher implements Dispatcher {
    public boolean accepts(ImageRequest req) { return req.url.startsWith("http"); }
    public Bitmap dispatch(Chain chain) { return networkPool.submit(...); }
}
public class FileDispatcher    implements Dispatcher { ... }
public class AssetDispatcher   implements Dispatcher { ... }
public class InlineDispatcher  implements Dispatcher { ... }

// 拦截器变成纯查找
public class DispatchInterceptor implements Interceptor {
    private final List<Dispatcher> dispatchers;
    public Bitmap intercept(Chain chain) throws IOException {
        ImageRequest req = chain.request();
        for (Dispatcher d : dispatchers) {
            if (d.accepts(req)) return d.dispatch(chain);
        }
        throw new IOException("no dispatcher for: " + req.url);
    }
}

改善：

维度 Before After
加新 scheme（如 content://） 改 if 阶梯 加新 Dispatcher 类
改某 scheme 调度逻辑 全方法重读 只看对应类
调度策略可单独单测 难 易

07.4 引入策略变换族

V1 的 Transformation 已经是策略模式雏形。V3 把它做扎实，

java 复制代码 
// 策略接口
public interface Transformation {
    Bitmap apply(Bitmap input);
    String key();          // 用于缓存键签名
}

// 具体策略族
public class CenterCrop      implements Transformation { ... }
public class CircleCrop      implements Transformation { ... }
public class RoundedCorners  implements Transformation {
    private final int radius;
    public RoundedCorners(int radius) { this.radius = radius; }
    public String key() { return "RoundedCorners(" + radius + ")"; }   // 参数计入签名!
    public Bitmap apply(Bitmap in) { /* ... */ }
}
public class BlurTransformation implements Transformation { ... }
public class GrayscaleTransformation implements Transformation { ... }

// 组合策略 (可选): 多策略串联
public class MultiTransformation implements Transformation {
    private final List<Transformation> steps;
    public Bitmap apply(Bitmap in) {
        Bitmap out = in;
        for (Transformation t : steps) {
            Bitmap next = t.apply(out);
            if (next != out) recycleIfPossible(out);   // Bitmap 资源管理
            out = next;
        }
        return out;
    }
    public String key() {
        return "Multi[" + steps.stream().map(Transformation::key).collect(joining(",")) + "]";
    }
}

调用方：

java 复制代码 
.transform(new RoundedCorners(8))
.transform(new BlurTransformation(15))
// 或:
.transform(new MultiTransformation(asList(new CenterCrop(), new RoundedCorners(8))))

注意 key() 的设计 ，它要把所有影响输出的参数都序列化进去，否则缓存会串图。这是值对象（§2.4）和策略（这里）联动的关键。

07.5 守卫子句替换嵌套

V1 的请求合法性校验：

java 复制代码 
private void validate(ImageRequest req) {
    if (req != null) {
        if (req.url != null && req.url.length() > 0) {
            if (req.targetWidth >= 0 && req.targetHeight >= 0) {
                if (req.transformations != null) {
                    // 真正的逻辑被嵌在 4 层 if 内
                }
            }
        }
    }
}

第 09 篇第四式：守卫子句，

java 复制代码 
private void validate(ImageRequest req) {
    if (req == null) throw new IllegalArgumentException("request is null");
    if (req.url == null || req.url.isEmpty()) throw new IllegalArgumentException("url is empty");
    if (req.targetWidth < 0 || req.targetHeight < 0)
        throw new IllegalArgumentException("invalid size: " + req.targetWidth + "x" + req.targetHeight);
    if (req.transformations == null) throw new IllegalArgumentException("transformations is null");

    // 主逻辑没缩进了
}

好处不是少了几个缩进 ，是意图反转 ：原来在说"满足全部条件才执行 "，现在在说"任何不满足立刻拒绝 "。后者更接近人类思维。

07.6 替换魔法数

V0 残留：

java 复制代码 
public static int MAX_SIZE = 100;             // 100 是什么? 张数? MB?
private static final int HEADER_PROBE = 12;   // 为什么是 12?
realOpts.inPreferredConfig = Bitmap.Config.RGB_565;  // 为什么 RGB_565?
opts.inSampleSize = 8;                        // 8 又是什么?

第 09 篇第五式：常量提取 + 命名注释化：

java 复制代码 
// 缓存配置
/** 内存缓存最大容量, 默认占总堆内存的 1/8 */
private static final long DEFAULT_MEMORY_CACHE_SIZE_BYTES = Runtime.getRuntime().maxMemory() / 8;

// 解码配置
/** 文件头探测字节数, 12 字节足够识别所有主流图片格式 (RIFF 12B / PNG 8B / JPEG 3B) */
private static final int IMAGE_HEADER_PROBE_BYTES = 12;

/** 默认位图配置: RGB_565 节省 50% 内存, 但损失透明通道. 含透明度的格式自动升级到 ARGB_8888 */
private static final Bitmap.Config DEFAULT_BITMAP_CONFIG = Bitmap.Config.RGB_565;

/** 最大降采样倍数, 超过会导致严重失真 */
private static final int MAX_DOWN_SAMPLE = 8;

比"少了魔法数"更重要的 ，注释保留了决策背景 ：为什么是 1/8、为什么是 12、为什么 RGB_565。这些信息在 V0 里只存在于设计者脑子里，离职就丢失。

07.7 分解上帝类

V0 的 ImageManager 是终极上帝类。V1 拆完之后，ImageLoader 仍可能是新的小上帝，如果它什么都管。

V3 的最终拆分：

flowchart TB subgraph 门面层 Loader[ImageLoader<br/>对外门面] end subgraph 引擎层 Engine[Engine<br/>请求生命周期] Registry[Registry<br/>组件注册表] end subgraph 拦截器层 ChainBuilder[ChainBuilder<br/>装配链] Interceptors[Interceptors...] end subgraph 资源层 BitmapPool[BitmapPool<br/>Bitmap 复用池] Caches[Caches] end Loader --> Engine Engine --> Registry Engine --> ChainBuilder ChainBuilder --> Interceptors Interceptors --> Caches & BitmapPool

分解原则（第 09 篇）：

  • ImageLoader 只负责"接受请求、返回 Disposable"，纯门面
  • Engine 负责"管理活跃请求、做去重、绑定生命周期"
  • Registry 负责"注册中心 + 自动选择实现"
  • ChainBuilder 负责"按配置装配拦截器链"
  • BitmapPool 负责"Bitmap 对象复用"（Glide 的杀手锏，节省 50% GC）

每个类不超过 300 行，这是经验阈值，超过就是分解信号。

07.8 查找表替换switch

V2 的 selectDecoder 还在线性遍历：

java 复制代码 
private ImageDecoder selectDecoder(byte[] header) {
    for (ImageDecoder d : decoders) if (d.supports(header)) return d;   // O(N)
    throw new IOException(...);
}

当 decoder 数量上来（10+ 种格式）+ 高 QPS（列表滑动）时，这成了热点。

第 09 篇第六式：查找表 / Map 索引：

java 复制代码 
public class DecoderRegistry {
    // 按"格式标识"建立索引
    private final Map<ImageFormat, ImageDecoder> byFormat = new HashMap<>();
    private final List<ImageDecoder> fallback = new ArrayList<>();   // 自定义格式兜底

    public void register(ImageDecoder decoder) {
        ImageFormat fmt = decoder.format();
        if (fmt != ImageFormat.UNKNOWN) byFormat.put(fmt, decoder);
        else fallback.add(decoder);
    }

    public ImageDecoder select(byte[] header) {
        ImageFormat fmt = ImageFormat.detect(header);   // 用枚举的 detect 逻辑
        ImageDecoder d = byFormat.get(fmt);
        if (d != null) return d;
        for (ImageDecoder f : fallback) if (f.supports(header)) return f;
        throw new IllegalStateException("no decoder for " + fmt);
    }
}

public enum ImageFormat {
    JPEG, PNG, WEBP, GIF, HEIF, AVIF, UNKNOWN;

    public static ImageFormat detect(byte[] h) {
        if (h.length >= 3 && h[0] == (byte)0xFF && h[1] == (byte)0xD8) return JPEG;
        if (h.length >= 8 && h[0] == (byte)0x89 && h[1] == 'P') return PNG;
        if (h.length >= 12 && h[8] == 'W' && h[9] == 'E') return WEBP;
        // ...
        return UNKNOWN;
    }
}

性能改善 ：从 O(N) → O(1)。在列表滑动场景下，每张图省 50-100 ns × 几百张 = 可感知的总耗时下降。

§7 阶段成果汇总：

重构式 应用点 改善
提取方法 解码方法拆 3 段 30 行 → 5 行主方法
引入参数对象 LoadOptions / DisplayOptions 8 字段 → 2 对象
多态替换条件 Dispatcher 替代 url scheme if 加 scheme 0 修改
引入策略 Transformation 族 + key() 缓存签名稳定
守卫子句 4 层 if → 平铺 意图反转
替换魔法数 4 处魔法数 → 命名常量 + 注释 决策背景沉淀
分解大类 ImageLoader → 5 类协作 每类 ≤ 300 行
查找表 Decoder O(N) → O(1) 性能 + 可读

思考题：

  1. 第 09 篇还有"封装集合 " / "降低函数副作用 " / "用对象替代基本类型" 等几式我们没用，是因为图片场景不需要，还是有更好的替代？
  2. 我们引入了 LoadOptions.HIGH_PRIORITY_NO_DISK 这种"预定义组合"，这种做法在 SDK 设计中叫什么？它和 Builder 模式的关系是什么？
  3. 查找表把 select 从 O(N) 优化到 O(1)，但代价是注册时多了一步分类。何时这种优化是负收益的？

9.可测试性改造

走到这一步，框架"看起来"已经很好了，SOLID 落实、坏味道扫除、上帝类分解。但有个尴尬的事实：

你能给它写一个稳定的单元测试吗？

试一下你就懂。给 MemoryCacheInterceptor 写测试，第一个问题就来了：

java 复制代码 
@Test
public void should_cache_hit() {
    ImageLoader loader = new ImageLoader.Builder()
        .httpClient(new OkHttpAdapter(...))    // ⚠️ 真网络? 还是 mock?
        .build();
    // ⚠️ Bitmap 怎么造? Android 环境?
    // ⚠️ ImageView.post 异步, 怎么等?
    // ⚠️ 5 秒超时, 单测要等 5 秒?
    // ⚠️ Thread.sleep(100)? 不稳定!
}

第 10 篇说 ："测不动的代码不是设计好的代码，只是看起来好。" V3 给我们留下了 4 个不可测点：

  1. 时间 ：状态超时、缓存过期、重试退避都依赖 System.currentTimeMillis()
  2. 线程：拦截器跨线程，测试要"等"
  3. 网络：真请求慢且不稳定
  4. 平台依赖：Bitmap / ImageView / Looper 是 Android 框架对象

V4 这一阶段，我们用第 10 篇的工具集逐项注入。

08.1 注入Clock抽象时间

第一个手术，所有"时间"都不直接读系统时钟。

java 复制代码 
// 抽象
public interface Clock {
    long currentTimeMillis();
    long elapsedRealtimeNanos();

    Clock SYSTEM = new Clock() {
        public long currentTimeMillis() { return System.currentTimeMillis(); }
        public long elapsedRealtimeNanos() { return System.nanoTime(); }
    };
}

// 测试用 Fake
public class FakeClock implements Clock {
    private long now = 0L;
    public long currentTimeMillis() { return now; }
    public long elapsedRealtimeNanos() { return now * 1_000_000L; }
    public void advance(long ms) { now += ms; }       // 测试可控
}

所有依赖时间的地方 改成 clock.currentTimeMillis()：

java 复制代码 
public class MetricsInterceptor implements Interceptor {
    private final Clock clock;            // 注入

    public Bitmap intercept(Chain chain) throws IOException {
        long start = clock.currentTimeMillis();
        try { return chain.proceed(chain.request()); }
        finally { metrics.record(clock.currentTimeMillis() - start); }
    }
}

测试：

java 复制代码 
@Test
public void metrics_should_record_correct_latency() {
    FakeClock clock = new FakeClock();
    MetricsInterceptor mi = new MetricsInterceptor(clock, metrics);

    Chain chain = mockChain(req -> {
        clock.advance(123);            // 模拟"耗时 123 ms"
        return testBitmap;
    });

    mi.intercept(chain);
    assertThat(metrics.lastLatency()).isEqualTo(123L);   // 精确!
}

对比"真实时钟"测试：

维度 真实时钟 FakeClock
是否稳定 否（CPU 抖动） 是
是否快 否（要 sleep 等真实时间） 是（亚毫秒）
边界场景 难（让请求"刚好超时"很难） 易（advance 到精确时刻）

08.2 注入Scheduler抽象线程

第二个手术，消灭裸线程，所有调度走 Scheduler 抽象。

java 复制代码 
public interface Scheduler {
    void execute(Runnable task);
    void schedule(Runnable task, long delayMs);
    void cancel(Runnable task);

    // 三种生产实现
    Scheduler IO_POOL = new ExecutorScheduler(Executors.newFixedThreadPool(4));
    Scheduler MAIN    = new MainHandlerScheduler();
    Scheduler IMMEDIATE = task -> task.run();   // 同步执行 (测试用)
}

// 测试用: 可控调度
public class TestScheduler implements Scheduler {
    private final Queue<Runnable> queue = new ArrayDeque<>();

    public void execute(Runnable task) { queue.offer(task); }   // 不立即跑
    public void schedule(Runnable task, long delay) { queue.offer(task); }

    public void runAll() {                  // 测试主动驱动
        while (!queue.isEmpty()) queue.poll().run();
    }
    public void runOne() {
        if (!queue.isEmpty()) queue.poll().run();
    }
    public int pending() { return queue.size(); }
}

所有 Interceptor / Engine / Dispatcher 改成接收 Scheduler 注入。

测试：

java 复制代码 
@Test
public void should_cancel_inflight_request_when_image_view_recycled() {
    TestScheduler ioScheduler = new TestScheduler();
    ImageLoader loader = builder()
        .ioScheduler(ioScheduler)
        .mainScheduler(Scheduler.IMMEDIATE)   // 主线程同步
        .build();

    ImageView iv = mockImageView();
    Disposable d1 = loader.load(req("url1"), new ImageViewTarget(iv));
    Disposable d2 = loader.load(req("url2"), new ImageViewTarget(iv));   // 复用 iv

    assertThat(ioScheduler.pending()).isEqualTo(1);   // 应自动取消 d1, 只剩 d2
    assertThat(d1.isDisposed()).isTrue();
}

关键点 ：测试完全同步、可重现、亚毫秒 ，这就是第 10 篇说的"让时间和并发服从你的指挥"。

08.3 注入Network抽象网络

§6.5 已经把 HttpClient 抽象出来了，这里直接受益：

java 复制代码 
public class FakeHttpClient implements HttpClient {
    private final Map<String, Function<HttpRequest, HttpResponse>> rules = new HashMap<>();

    public FakeHttpClient when(String url, Function<HttpRequest, HttpResponse> handler) {
        rules.put(url, handler);
        return this;
    }

    public HttpResponse execute(HttpRequest req) throws IOException {
        Function<HttpRequest, HttpResponse> h = rules.get(req.url);
        if (h == null) throw new IOException("no rule for: " + req.url);
        return h.apply(req);
    }

    // 预设场景工厂
    public static HttpResponse ok(byte[] bytes) { return new HttpResponse(200, ...); }
    public static HttpResponse notFound()       { return new HttpResponse(404, ...); }
    public static HttpResponse timeout() throws IOException { throw new SocketTimeoutException(); }
    public static HttpResponse slow(byte[] bytes, long delayMs, FakeClock clock) {
        clock.advance(delayMs);
        return ok(bytes);
    }
}

测试场景大爆发：

java 复制代码 
FakeHttpClient http = new FakeHttpClient()
    .when("https://normal.png",   req -> FakeHttpClient.ok(jpegBytes))
    .when("https://slow.png",     req -> FakeHttpClient.slow(jpegBytes, 3000, fakeClock))
    .when("https://broken.png",   req -> FakeHttpClient.notFound())
    .when("https://flaky.png",    req -> {
        if (counter.incrementAndGet() < 3) throw new IOException("transient");
        return FakeHttpClient.ok(jpegBytes);    // 第 3 次成功 - 测重试
    });

08.4 五个高价值单测

注入做完了，第 10 篇说**"现在写测试是享受"**。挑 5 个关键场景：

测试 1：内存缓存命中，0 网络
java 复制代码 
@Test
public void mem_cache_hit_skips_network() {
    FakeHttpClient http = new FakeHttpClient();   // 故意不注册任何规则 - 一访问就抛
    ImageLoader loader = builder().httpClient(http).build();

    loader.load(req("url"), tgt).await();              // 第一次 - 应该失败
    loader.cache().put(key("url"), testBitmap);        // 手动塞缓存
    Bitmap b = loader.load(req("url"), tgt).await();   // 第二次 - 应命中, 不访问 http
    assertThat(b).isSameAs(testBitmap);
}
测试 2：列表复用自动取消
java 复制代码 
@Test
public void rebind_image_view_cancels_previous_request() {
    TestScheduler io = new TestScheduler();
    ImageView iv = mockImageView();

    Disposable d1 = loader.load(req("u1"), new ImageViewTarget(iv));
    Disposable d2 = loader.load(req("u2"), new ImageViewTarget(iv));

    assertThat(d1.isDisposed()).isTrue();        // d1 自动取消
    assertThat(io.pending()).isEqualTo(1);       // 池里只剩 d2
}

这是 V0 事故根因的回归测试，以后任何改动如果引入了 V0 同款 bug，CI 会立刻红。

测试 3：同 url 并发去重
java 复制代码 
@Test
public void concurrent_same_url_only_one_network_call() {
    AtomicInteger calls = new AtomicInteger();
    FakeHttpClient http = new FakeHttpClient().when("https://x.png", req -> {
        calls.incrementAndGet();
        return FakeHttpClient.ok(jpegBytes);
    });
    ImageLoader loader = builder().httpClient(http).build();

    // 10 个并发请求同一 url
    List<CompletableFuture<Bitmap>> futures = IntStream.range(0, 10)
        .mapToObj(i -> CompletableFuture.supplyAsync(() -> loader.load(req("https://x.png")).await()))
        .collect(toList());
    futures.forEach(CompletableFuture::join);

    assertThat(calls.get()).isEqualTo(1);   // 只有 1 次真实网络调用!
}
测试 4：弱网重试
java 复制代码 
@Test
public void retry_on_transient_failure() {
    AtomicInteger attempts = new AtomicInteger();
    FakeHttpClient http = new FakeHttpClient().when("https://flaky.png", req -> {
        if (attempts.incrementAndGet() < 3) throw new IOException("transient");
        return FakeHttpClient.ok(jpegBytes);
    });

    Bitmap b = loader.load(req("https://flaky.png")).await();
    assertThat(attempts.get()).isEqualTo(3);
    assertThat(b).isNotNull();
}
测试 5：缓存淘汰策略
java 复制代码 
@Test
public void lru_evicts_oldest_when_over_capacity() {
    MemoryCache cache = new LruMemoryCache(3 * BMP_SIZE);   // 容量 3 张
    cache.put(key("a"), bmpA);
    cache.put(key("b"), bmpB);
    cache.put(key("c"), bmpC);
    cache.get(key("a"));                  // a 变最近使用
    cache.put(key("d"), bmpD);            // 触发淘汰

    assertThat(cache.get(key("a"))).isNotNull();   // a 还在
    assertThat(cache.get(key("b"))).isNull();      // b 被淘汰 (最久未用)
    assertThat(cache.get(key("c"))).isNotNull();
    assertThat(cache.get(key("d"))).isNotNull();
}

08.5 录制式调度器

最后一个杀手级技巧，RecordingScheduler 用来验证"事件顺序"：

java 复制代码 
public class RecordingScheduler implements Scheduler {
    private final List<String> events = new ArrayList<>();

    public void execute(Runnable task) {
        events.add("EXEC@" + task.getClass().getSimpleName());
        task.run();
    }
    public void schedule(Runnable task, long delay) {
        events.add("SCHEDULE+" + delay + "@" + task.getClass().getSimpleName());
    }
    public List<String> trace() { return events; }
}

测试：

java 复制代码 
@Test
public void cache_miss_should_go_disk_then_network() {
    RecordingScheduler s = new RecordingScheduler();
    ImageLoader loader = builder().ioScheduler(s).build();

    loader.load(req("https://x.png"), tgt).await();

    assertThat(s.trace()).containsExactly(
        "EXEC@MemoryCacheCheck",
        "EXEC@DiskCacheCheck",
        "EXEC@NetworkFetch",
        "EXEC@Decode",
        "EXEC@Transform"
    );
}

这是第 10 篇的"行为级测试" ，不仅校验结果 ，更校验过程 。当将来有人改了拦截器顺序，测试会立刻发现。

§8 阶段成果汇总：

注入点 抽象 测试用 Fake
时间 Clock FakeClock（可 advance）
线程 Scheduler TestScheduler（手动驱动）+ RecordingScheduler（追踪事件）
网络 HttpClient FakeHttpClient（规则化响应）
平台 Target 接口 内存/Mock Target 替换 ImageView

测试矩阵覆盖：

markdown 复制代码 
        ┌── 命中场景 ──── 测试1
缓存层 ┼── 淘汰场景 ──── 测试5
        └── 双层切换 ──── 测试 5(扩展)

        ┌── 复用取消 ──── 测试2 ⭐ V0 事故回归
调度层 ┼── 并发去重 ──── 测试3
        └── 顺序追踪 ──── §8.5

        ┌── 慢响应 ────── 测试4 (slow)
网络层 ┼── 失败重试 ──── 测试4 ⭐
        └── 错误码 ────── 测试4 (404)

思考题：

  1. Scheduler.IMMEDIATE 让任务在调用线程同步执行，这等价于"没有调度"。在测试时方便，但生产中是否有合法用途？
  2. FakeClock.advance 在多线程测试中会出问题吗？为什么 RxJava 的 TestScheduler 是单线程模型？
  3. 我们的 RecordingScheduler 记录的是"被调度的任务"，但有一些 bug 是"应该被调度但没被调度"，怎么用测试捕获？

10.V4阶段小结

V0 → V4 的全景：

flowchart LR V0[V0<br/>屎山<br/>17坏味道] --> V1[V1<br/>OOP救场<br/>请求/端口/链] V1 --> V2[V2<br/>SOLID精修<br/>5原则落地] V2 --> V3[V3<br/>重构十二式<br/>8招手术] V3 --> V4[V4<br/>可测试改造<br/>注入Clock/Scheduler/Http] V4 -.下一站.-> V5[V5<br/>DDD上下文<br/>5个限界上下文]

到目前为止的"内功消耗表"：

篇章 应用次数 标志性应用点
02 封装 ★★★ ImageRequest / 状态机 / CacheKey
03 接口 vs 抽象类 ★★ ImageSource + AbstractImageSource
04 面向接口编程 ★★★ 三大端口 + Registry
05 组合优于继承 ★★★ 拦截器链（核心架构）
06 设计原则 ★★ DIP 解 OkHttp
07 SOLID ★★★ 五原则各对应一处具体重构
08 反模式 ★★ 17 处坏味道扫除 14 处
09 重构十二式 ★★★ 8 招手术
10 可测试性 ★★★ 注入 Clock/Scheduler/Http + 5 单测
11 DDD ☆ 仅用了值对象（CacheKey）， V5 主场

剩下的事，

V5 阶段（下一节）我们要做最有意思的一步：用 DDD 的限界上下文 给整个框架画一张"领域地图 "。这一步绝大多数图片库都没做，但它能解释一个重要现象，

为什么 Glide 把"变换"做成了上下文，而 SDWebImage 没有？ 为什么 Coil 4.0 重写了"调度上下文"，而老版本把它揉在 Engine 里？ 为什么 Fresco 把"内存管理"做成独立上下文，而其他库都依附于缓存？

这些设计差异，用 OOP 的语言只能说"风格不同" ，但用 DDD 的语言能说出"上下文边界不同导致的演化路径不同"。

最后一批我们将一次性产出 §9（DDD 上下文）+ §10（全景类图与 11 篇映射）+ §11（终极思考题）。

11.V5用DDD重塑边界

10.1 为何还要再切一刀

走到 V4，绝大多数工程师会说："够了，已经很好了。" 但请看下面这个场景，

业务方需求 ："我们要给 ToB 客户开放一个只读型 SDK，他们只用看图，不允许写缓存、不允许配置变换、不允许改调度策略。"

如果你是 V4 的维护者，你会怎么做？翻一下你能想到的方案：

  • 方案 A ：复制一份 ImageLoader，删掉所有写入接口，代码翻倍
  • 方案 B ：在 ImageLoader 里加一堆 if (mode == READ_ONLY)，回到 V0
  • 方案 C ：把 ImageLoader 拆成多个 SDK 模块，按客户拼装，但拆的边界是什么？

问题的本质不是"代码怎么写"，而是"模块边界在哪" 。V4 之前我们都在解决"类内部怎么写 "的问题，SOLID、坏味道、重构都聚焦于类层面 。但类与类如何聚集成模块 、模块与模块如何对话 ，这是第 11 篇 DDD 的主场。

第 11 篇的核心一问 ："这段代码属于谁的领地？谁有权改它？"

把这个问题抛回我们的图片框架，

候选问题 V4 的答案 DDD 视角下的真正答案
谁定义"什么是合法 URL"？ ImageRequest 的 validate 方法 这是加载上下文的领域规则
谁决定"缓存命中算不算成功"？ 拦截器埋的统计 这是监控上下文的领域事件
谁负责"Bitmap 解码失败如何降级"？ DecodeInterceptor 里的 catch 这是解码上下文的策略
谁负责"圆角与高斯模糊参数语义"？ Transformation 实现类 这是变换上下文的语义边界
谁负责"内存压力下淘汰谁"？ LruMemoryCache 的算法 这是缓存上下文的领域决策

5 个不同的"谁" ，意味着至少 5 个限界上下文。每个上下文有自己的：

  • 通用语言（Ubiquitous Language）
  • 领域模型（Entity / Value Object / Aggregate）
  • 边界（什么进得来、什么出得去）
  • 演化节奏（独立升级）

这就是 V5 要做的事。

10.2 五个限界上下文

flowchart TB subgraph LoadCtx[加载上下文 Loading Context] direction TB L1[聚合: ImageRequest] L2[实体: LoadSession] L3[值对象: CacheKey/LoadOptions] L4[领域服务: RequestDeduplicator] end subgraph CacheCtx[缓存上下文 Cache Context] direction TB C1[聚合: CacheStore] C2[值对象: CacheEntry] C3[领域服务: EvictionPolicy] C4[策略: LRU/LFU/TinyLFU] end subgraph DecodeCtx[解码上下文 Decode Context] direction TB D1[实体: DecodingTask] D2[值对象: DecodedBitmap] D3[领域服务: SampleSizeCalculator] D4[策略族: Decoders] end subgraph TransformCtx[变换上下文 Transform Context] direction TB T1[聚合: TransformationPipeline] T2[值对象: Transformation/Signature] T3[领域规则: 顺序无关变换可重排] end subgraph MetricsCtx[监控上下文 Metrics Context] direction TB M1[实体: RequestTrace] M2[值对象: Metric Event] M3[领域服务: SLAEvaluator] end LoadCtx -- &#34;查询命中&#34; --> CacheCtx LoadCtx -- &#34;委托解码&#34; --> DecodeCtx DecodeCtx -- &#34;委托变换&#34; --> TransformCtx LoadCtx -- &#34;发布事件&#34; --> MetricsCtx CacheCtx -- &#34;发布事件&#34; --> MetricsCtx DecodeCtx -- &#34;发布事件&#34; --> MetricsCtx

为什么是这 5 个？ 用第 11 篇的"领域专家访谈法"反推：

上下文 通用语言（专家会说的话） 不属于它的话
加载 "请求"、"会话"、"取消"、"优先级"、"去重" "采样率"、"圆角半径"、"LRU"
缓存 "命中"、"淘汰"、"容量"、"过期"、"TTL" "解码"、"OkHttp"
解码 "采样率"、"位图配置"、"格式探测"、"降采样" "拦截器顺序"
变换 "圆角"、"高斯模糊"、"旋转"、"签名" "网络重试"
监控 "事件"、"耗时"、"P99"、"SLA"、"异常分类" "Bitmap 复用"

这 5 类语言彼此正交 ，一个"采样率"专家不必懂"LRU"，一个"P99"专家不必懂"圆角半径"。正交语言 = 限界上下文边界。

加载上下文核心代码
java 复制代码 
// 加载上下文 (Loading Context)
package com.xx.image.loading;

// 聚合根: ImageRequest
public final class ImageRequest {
    private final RequestId id;
    private final RequestUrl url;          // 值对象: URL 合法性自封装
    private final TargetSize size;
    private final LoadOptions options;
    // 不暴露内部状态, 只暴露行为
    public CacheKey toCacheKey(SignatureRule rule) { ... }
    public boolean canBeDeduplicatedWith(ImageRequest other) { ... }
}

// 实体: LoadSession (代表一次"加载会话")
public final class LoadSession {
    private final RequestId requestId;
    private final SessionState state;     // 状态机
    private final List<DomainEvent> events = new ArrayList<>();

    public void onCacheHit(CacheEntry entry)      { state.transitTo(SUCCEEDED); raise(new CacheHitEvent(...)); }
    public void onCacheMiss()                     { state.transitTo(NETWORK_FETCHING); raise(new CacheMissEvent(...)); }
    public void onNetworkSuccess(byte[] bytes)    { state.transitTo(DECODING); raise(new NetworkSuccessEvent(...)); }
    public void onDecodeSuccess(Bitmap bmp)       { state.transitTo(SUCCEEDED); raise(new DecodeSuccessEvent(...)); }
    public void onFailed(Throwable cause)         { state.transitTo(FAILED); raise(new RequestFailedEvent(...)); }

    public List<DomainEvent> pollEvents() { ... }    // 让外层订阅事件
}

// 领域服务: 请求去重
public class RequestDeduplicator {
    private final Map<CacheKey, LoadSession> inflight = new ConcurrentHashMap<>();

    public Optional<LoadSession> joinIfInflight(ImageRequest req, SignatureRule rule) {
        return Optional.ofNullable(inflight.get(req.toCacheKey(rule)));
    }
}
缓存上下文核心代码
java 复制代码 
package com.xx.image.cache;

// 聚合根: CacheStore
public final class CacheStore {
    private final EvictionPolicy policy;     // 策略对象
    private final long capacityBytes;
    private final ConcurrentMap<CacheKey, CacheEntry> entries;

    public Optional<CacheEntry> get(CacheKey key) { /* 命中 -> 通知 policy */ }

    public void put(CacheKey key, CacheEntry entry) {
        while (totalSize() + entry.sizeBytes > capacityBytes) {
            CacheKey victim = policy.selectVictim(entries);
            evict(victim);
        }
        entries.put(key, entry);
        policy.onPut(key);
    }
}

// 值对象: CacheEntry
public final class CacheEntry {
    public final Bitmap bitmap;
    public final long sizeBytes;
    public final long createdAtMs;
    public final long lastAccessedAtMs;
    public final Signature signature;        // 来自变换上下文的签名
}

// 策略: 淘汰策略可独立演化
public interface EvictionPolicy {
    CacheKey selectVictim(Map<CacheKey, CacheEntry> entries);
    void onPut(CacheKey key);
    void onAccess(CacheKey key);
}
public class LruEvictionPolicy   implements EvictionPolicy { ... }
public class LfuEvictionPolicy   implements EvictionPolicy { ... }
public class TinyLfuEvictionPolicy implements EvictionPolicy { ... }   // 高级
变换上下文核心代码
java 复制代码 
package com.xx.image.transform;

// 聚合根: TransformationPipeline (一组变换的有序集合)
public final class TransformationPipeline {
    private final List<Transformation> steps;

    // 领域规则: 顺序无关的变换可以重排以优化性能
    public TransformationPipeline optimize() {
        // 例: blur 是逐像素操作, 与 crop 顺序敏感; 但 grayscale 与 blur 顺序无关
        return new TransformationPipeline(reorderForCacheLocality(steps));
    }

    public Bitmap apply(Bitmap input) { ... }

    // 领域规则: 签名 = 所有 Transformation.key() 拼接
    // 任何参数变化都必须反映在签名上, 否则会串图 (V0 事故根因 #13)
    public Signature signature() {
        return new Signature(steps.stream().map(Transformation::key).collect(joining("|")));
    }
}

public final class Signature {
    private final String value;
    @Override public boolean equals(Object o) { /* 全字段相等 */ }
    @Override public int hashCode()           { /* 全字段哈希 */ }
}

这一拆，立刻看到 V0 事故 #13"缓存键错"的根本原因 ，它是变换上下文的领域规则被泄漏到了缓存键的拼装代码里 。V0 写得 hack（直接用 url 当 key），V1-V4 修复了表象（CacheKey 全字段），但只有 V5 把它归位到正确的上下文，签名是变换上下文的产出。

10.3 上下文映射与防腐

5 个上下文如何对话？这是第 11 篇的"上下文映射图（Context Map）"，

flowchart LR subgraph 核心 Load[加载上下文<br/>核心域] end subgraph 支撑 Cache[缓存上下文<br/>支撑域] Decode[解码上下文<br/>支撑域] Transform[变换上下文<br/>支撑域] end subgraph 通用 Metrics[监控上下文<br/>通用域] end subgraph 外部 OkHttp[OkHttp] Bmp[Android Bitmap] end Load -- &#34;客户-供应商<br/>(C/S)&#34; --> Cache Load -- &#34;客户-供应商&#34; --> Decode Decode -- &#34;共享内核<br/>(Shared Kernel)<br/>共享 Signature&#34; --> Transform Load -. &#34;已发布语言<br/>(Published Language)<br/>领域事件&#34; .-> Metrics Cache -. &#34;已发布语言&#34; .-> Metrics Decode -. &#34;已发布语言&#34; .-> Metrics Decode -- &#34;防腐层<br/>(ACL)&#34; --> Bmp Load -- &#34;防腐层&#34; --> OkHttp

关键关系类型解释：

客户-供应商关系（C/S）

加载上下文是客户 ，缓存上下文是供应商 ，加载方提需求，缓存方有义务满足，但双方协议明确：

java 复制代码 
// 加载上下文调用缓存上下文 - 通过明确定义的契约接口
package com.xx.image.loading;

public interface CacheGateway {           // 加载方定义的"我需要什么"
    Optional<Bitmap> tryLoad(CacheKey key);
    void store(CacheKey key, Bitmap bmp, long sizeBytes);
}

// 缓存方实现适配
package com.xx.image.cache.adapter;

public class CacheStoreAdapter implements CacheGateway {  // 防腐层
    private final CacheStore store;       // 缓存上下文的内部聚合根
    public Optional<Bitmap> tryLoad(CacheKey key) {
        return store.get(key).map(CacheEntry::getBitmap);
    }
}

好处 ：加载上下文不知道 CacheStore / CacheEntry / EvictionPolicy 的存在，它只知道 CacheGateway。缓存上下文的内部重构（比如换成 TinyLFU）不会泄漏到加载上下文。

共享内核（Shared Kernel）

解码上下文与变换上下文共享 Signature 这一概念 ，两边都需要它来生成缓存键。这种情况下用共享内核 ，把 Signature 提取到一个独立的小模块：

arduino 复制代码 
com.xx.image.shared/
    Signature.java          ← 双方都依赖它
    CacheKey.java

纪律 ：共享内核里的代码修改需要双方同意，这是 DDD 强加的"团队契约"。

已发布语言（Published Language）

监控上下文订阅其他四个上下文的领域事件：

java 复制代码 
package com.xx.image.shared.events;

// 已发布语言: 跨上下文统一的事件协议
public abstract class DomainEvent {
    public final String contextName;     // "loading" / "cache" / "decode" / "transform"
    public final String eventType;       // "CacheHit" / "DecodeFailed" / ...
    public final long occurredAtMs;
    public final Map<String, Object> payload;
}

public class CacheHitEvent       extends DomainEvent { ... }
public class CacheMissEvent      extends DomainEvent { ... }
public class DecodeStartedEvent  extends DomainEvent { ... }
public class DecodeFailedEvent   extends DomainEvent { ... }
public class TransformAppliedEvent extends DomainEvent { ... }

// 监控上下文统一订阅
package com.xx.image.metrics;

public class MetricsAggregator implements DomainEventListener {
    public void onEvent(DomainEvent event) {
        switch (event.eventType) {
            case "CacheHit"  -> incCounter("image.cache.hit", event.contextName);
            case "CacheMiss" -> incCounter("image.cache.miss");
            case "DecodeFailed" -> recordError("image.decode.fail", event);
            // ...
        }
    }
}

这就是真正的"可观测性架构" ，监控不是塞在每个拦截器里的 metrics.record()，而是通过领域事件总线统一收口。

防腐层（Anticorruption Layer）

OkHttp 和 Android Bitmap 是外部系统 ，它们的概念（Response.body().byteStream(), Bitmap.recycle()）不应污染我们的领域模型 。在 §6.5 我们已经做了 HttpClient 适配器，这就是防腐层的雏形。V5 把它升级为完整的防腐层包：

arduino 复制代码 
com.xx.image.acl.okhttp/   ← 防腐层
    OkHttpAdapter.java
    OkResponseToHttpResponse.java
com.xx.image.acl.android/
    AndroidBitmapAdapter.java
    BitmapPoolAdapter.java

防腐层的纪律 ：防腐层的代码可以脏，但不能让脏渗透进领域 。比如 OkHttp 的 Response 关闭时机很 tricky，这种坑全部封死在适配器里，领域代码看到的 HttpResponse 是干净的。

10.4 领域事件串联协作

把上下文画完，关键是让它们跑起来 ，靠的就是领域事件总线。

java 复制代码 
// 简易事件总线 (生产环境可换 Guava EventBus / RxJava Subject)
public interface DomainEventBus {
    void publish(DomainEvent event);
    Disposable subscribe(Class<? extends DomainEvent> type, DomainEventListener listener);
}

// 一次完整的"加载流程"用领域事件串起来
public class ImageLoadingOrchestrator {
    private final DomainEventBus bus;
    private final CacheGateway cache;
    private final DecodeGateway decoder;

    public void load(ImageRequest req, Target target) {
        LoadSession session = LoadSession.start(req);
        bus.publish(new RequestStartedEvent(session.id(), req));

        // 1. 查缓存
        Optional<Bitmap> cached = cache.tryLoad(req.toCacheKey(/*rule*/));
        if (cached.isPresent()) {
            session.onCacheHit(new CacheEntry(cached.get(), ...));
            bus.publish(new CacheHitEvent(session.id()));
            target.onResourceReady(cached.get());
            return;
        }

        session.onCacheMiss();
        bus.publish(new CacheMissEvent(session.id()));

        // 2. 网络 + 解码
        decoder.decode(req).subscribe(
            bitmap -> {
                session.onDecodeSuccess(bitmap);
                bus.publish(new DecodeSuccessEvent(session.id(), bitmap));
                cache.store(req.toCacheKey(/*rule*/), bitmap, sizeOf(bitmap));
                target.onResourceReady(bitmap);
            },
            err -> {
                session.onFailed(err);
                bus.publish(new RequestFailedEvent(session.id(), err));
                target.onLoadFailed(null, err);
            }
        );
    }
}

领域事件带来的真正威力 ，新需求几乎不动核心代码：

新需求 V4 时代怎么做 V5 时代怎么做
加 APM 上报 在拦截器里埋点 订阅领域事件 ✅
加灰度日志 加 if 配置开关 注册一个事件监听器 ✅
加流控（同 url 限流） 改去重逻辑 监听 RequestStartedEvent 拦截 ✅
加 A/B 测试 改业务调用方 监听事件 + 路由 ✅
加风控（屏蔽某些 url） 改 NetworkInterceptor 监听 RequestStartedEvent 拒绝 ✅

这就是第 11 篇说的"用 DDD 思考演化" ，把"未来未知的扩展点"留在事件总线上，而不是核心流程里。

10.5 三大库的对照分析

回到 §10.1 提的开篇问题，为什么三大主流图片库的设计差异这么大？用 DDD 视角解释一遍：

flowchart LR subgraph Glide[Glide 上下文边界] G1[Loading] G2[Cache] G3[Decode] G4[Transform 独立] G5[BitmapPool 独立] end subgraph SDWebImage[SDWebImage 上下文边界] S1[Loading] S2[Cache] S3[Decode + Transform 合并] end subgraph Fresco[Fresco 上下文边界] F1[Loading] F2[Cache 多级独立] F3[Decode] F4[Memory 独立<br/>Ashmem] end
库 限界上下文划分 演化能力 历史性能特征
Glide 5 个（加 BitmapPool 独立） 加 GIF 支持、加 WebP、加视频帧，0 修改核心 Bitmap 复用极致，GC 压力小
SDWebImage 3 个（解码与变换合并） 加新格式容易，但加新变换会触碰解码上下文 iOS 早期内存模型，GC 不敏感
Fresco 5 个（Memory 上下文独立） 内存压力下可单独降级，这是 Facebook 大图墙的需求 Ashmem 独立堆，避开 Java Heap OOM

结论 ，没有"对的设计"，只有"对的上下文边界" 。三大库的边界差异直接由它们解决的核心问题决定：

  • Glide 关心列表滑动 GC（解决 Android 早期低内存机型卡顿）→ 把 BitmapPool 提升为一等公民
  • SDWebImage 关心iOS 简洁 API（少即是多）→ 合并相近上下文
  • Fresco 关心超大图避免 OOM（Facebook 大图墙）→ 把 Memory 抽离到 Ashmem

这就是第 11 篇真正想教会的事 ，架构是问题的镜像 。当你接手一个新项目，先问"真正的问题是什么 "，再画上下文边界，而不是套别人的边界。

§10 阶段成果汇总：

维度 V4 V5
模块边界 类/接口层面 限界上下文层面
跨模块对话 直接调用 防腐层 + 已发布语言
扩展机制 拦截器（流程级） 领域事件（语义级）
上下文独立演化 受限 完全独立（独立部署可期）
团队边界 同一团队 5 个上下文 = 5 个潜在子团队

思考题：

  1. 我们把"监控上下文"定为通用域 ，如果某天监控演进出"实时风控"能力（基于事件总线发现可疑加载行为），它会从通用域上升为核心域吗？这种角色变化在 DDD 里如何应对？
  2. 加载上下文与缓存上下文用了 C/S 关系，但如果某天缓存团队希望"主动通知加载方'你的缓存即将过期，是否预热'"，C/S 关系还成立吗？需要换成什么？
  3. 共享内核 Signature 让解码与变换两个上下文耦合，这是设计味道还是必要妥协？什么场景下应该把共享内核拆掉？

12.全景类图与篇章映射

11.1 V5终极架构全景

flowchart TB subgraph 门面[门面层] Loader[ImageLoader<br/>对外门面] Builder[ImageRequest.Builder] Disp[Disposable] end subgraph 加载上下文 direction TB Engine[Engine/Orchestrator] Session[LoadSession] Dedup[RequestDeduplicator] ChainBuilder[ChainBuilder] Interceptors[Interceptor 链<br/>Memory→Disk→Network→Decode→Transform] end subgraph 缓存上下文 Mem[MemoryCache] Disk[DiskCache] Policy[EvictionPolicy<br/>LRU/LFU/TinyLFU] BPool[BitmapPool] end subgraph 解码上下文 Reg[DecoderRegistry] Dec[Decoders<br/>JPEG/PNG/WebP/GIF/HEIF] Sample[SampleSizeCalculator] end subgraph 变换上下文 Pipe[TransformationPipeline] Trans[Transformations<br/>CenterCrop/Round/Blur/...] Sig[Signature] end subgraph 监控上下文 Bus[DomainEventBus] Agg[MetricsAggregator] Trace[RequestTrace] end subgraph 防腐层 OkAdapter[OkHttpAdapter] BmpAdapter[AndroidBitmapAdapter] end subgraph 注入抽象 Clock[Clock] Sched[Scheduler] Http[HttpClient] end Loader --> Engine Engine --> Session Engine --> Dedup Engine --> ChainBuilder ChainBuilder --> Interceptors Interceptors -- 防腐 --> Mem & Disk Interceptors -- 防腐 --> Reg Reg --> Dec Dec --> Sample Interceptors --> Pipe Pipe --> Trans Pipe -.签名.-> Sig Mem -.签名.-> Sig Session -.事件.-> Bus Mem -.事件.-> Bus Disk -.事件.-> Bus Dec -.事件.-> Bus Bus --> Agg Bus --> Trace Interceptors --> Http Http --> OkAdapter Dec --> BmpAdapter Engine --> Sched Session --> Clock Mem --> BPool

11.2 按图索骥十一篇映射

flowchart LR P02[02 封装] --> A1[ImageRequest 不可变<br/>RequestState 状态机<br/>CacheKey 值对象] P03[03 接口vs抽象类] --> A2[ImageSource 接口<br/>AbstractImageSource 骨架] P04[04 面向接口编程] --> A3[三大端口<br/>Registry 自动注册] P05[05 组合优于继承] --> A4[Interceptor Chain<br/>替代 Loader 继承爆炸] P06[06 设计原则] --> A5[KISS: Disposable<br/>YAGNI: 不预留过度扩展<br/>DRY: 状态机抽公用] P07[07 SOLID] --> A6[SRP 拆 ImageRequest<br/>OCP WebpDecoder<br/>LSP 缓存契约<br/>ISP 缓存接口三分<br/>DIP HttpClient 抽象] P08[08 反模式] --> A7[V0 17 处坏味道<br/>14 处已扫除] P09[09 重构十二式] --> A8[8 招手术<br/>提取方法/参数对象<br/>多态/守卫/魔法数<br/>分解上帝类/查找表] P10[10 可测试性] --> A9[Clock/Scheduler/Http<br/>5 个高价值单测<br/>RecordingScheduler] P11[11 DDD] --> A10[5 个限界上下文<br/>防腐层<br/>领域事件总线<br/>对照三大库]

详细映射表（"按图索骥"使用指南）：

当你想做... 翻回这一篇 在本篇的什么地方
设计一个新值对象（比如 Url） 02 §2.4 CacheKey 设计
选接口还是抽象类 03 §3.3 ImageSource vs AbstractImageSource
决定模块对外暴露什么 04 §3.2 三大端口
看到一堆相似类要合并 05 §4.1-4.2 拦截器链
评估一段代码是否过度设计 06 §10 KISS/YAGNI 取舍
给某个类找出修改理由 07 §6.1 SRP 五拨人评估法
加新功能担心改坏旧的 07 §6.2 OCP WebP 演练
接口实现互不兼容 07 §6.3 LSP 缓存契约统一
接口方法太多想拆 07 §6.4 ISP 三分缓存
想替换底层依赖 07 §6.5 DIP HttpClient
看到 30 行长方法 09 §7.1 提取方法
看到一堆相关参数 09 §7.2 参数对象
看到 if/switch 阶梯 09 §7.3/7.8 多态/查找表
想给历史代码加测试 10 §8 注入三件套
模块边界乱了 11 §10.2 五个上下文
想做架构演化 11 §10.4 领域事件
想理解开源库设计差异 11 §10.5 三大库对照

11.3 演进路径回望

gantt title V0 → V5 演进里程碑 dateFormat YYYY-MM-DD section 救火期 V0 屎山故障复盘 :done, v0, 2019-11-12, 1d V1 OOP 救场（封装/接口/组合） :done, v1, after v0, 14d section 精修期 V2 SOLID 五原则 :done, v2, after v1, 10d V3 重构十二式 :done, v3, after v2, 12d section 演化期 V4 可测试性改造 :done, v4, after v3, 7d V5 DDD 限界上下文 :done, v5, after v4, 21d

6 个版本，65 天的虚构时间线 ，但每一步都对应真实工程中你会遇到的拐点：

  • V0→V1：着火了，先用 OOP 把架子搭对（"能跑且优雅"）
  • V1→V2：业务方提需求，发现旧设计有缺口（SOLID 五原则给方向）
  • V2→V3：代码味道堆积，做系统性手术（重构十二式）
  • V3→V4：需要回归测试，把不可测点逐个注入（可测试性改造）
  • V4→V5：团队规模扩大，需要明确边界与协作协议（DDD 重塑）

这五个拐点几乎是所有中等规模框架的必经之路 。当你进入一个项目，识别它正处在哪个拐点，比"该用什么模式"重要 100 倍。

13.终极思考题

最后留给读者三道贯穿 11 篇 + 12 篇所有内功的开放题，没有标准答案，但每一道都能写一篇博客。

12.1 跨平台抽象题

背景 ：业务方要求把这套图片框架同时供 Android / iOS / Web / 小程序使用。当前 V5 已经把 OkHttp 和 Bitmap 封进了防腐层。

问题：

  1. 哪些上下文应该完全跨平台共享（核心 + 算法）？
  2. 哪些上下文需要每平台独立实现（解码、内存管理）？
  3. 你会用什么技术栈实现共享部分？KMM？C++？纯描述性配置？
  4. 设计一组跨平台事件协议 ，让监控上下文能同时收到 4 个平台的事件。

进阶 ：如果某平台没有 BitmapPool 概念（比如 Web 的 ImageBitmap），事件协议中的"位图复用"事件该如何处理？

12.2 画质降级题

背景 ：弱网用户看不清图，但加载快；强网用户希望看高清，但等不及。业务方希望"渐进式画质"，先出低清版本占位，再下高清版本替换。

问题：

  1. 这个需求会触动哪几个上下文？需要修改它们的领域模型吗？
  2. "低清→高清"的状态切换，在 LoadSession 状态机里怎么表达？是新增状态还是新增事件？
  3. 缓存上下文要存"两份"吗？还是存"一份带画质等级的"？这两种设计的取舍是什么？
  4. 如果"低清版本"也是一次完整的 HTTP 请求，它和"高清版本"应该共用 LoadSession 还是各自独立？这又会影响取消语义：用户取消时取消哪个？

进阶 ：把"渐进式画质"做成一个独立的支撑域上下文，给出它的领域模型和事件协议。

12.3 百万QPS改造题

背景 ：原来这是个客户端框架（QPS 个位数）。现在 CDN 团队希望复用这套设计做服务端图片处理，百万 QPS、毫秒级 P99。

问题：

  1. 可变性来源不同 ，客户端是"格式 + 变换 + 网络"三轴变化，服务端是"格式 + 变换 + 上游存储"三轴变化。哪些上下文需要重新切边界？
  2. 客户端的拦截器链是同步阻塞 的（一次一个请求），服务端必须异步流水线 + 并发批处理。这是不是意味着推翻 §4 的设计？还是只换实现？
  3. 监控上下文从 APM 上报变成实时调度反馈（用监控数据反向调缓存策略），它从"通用域"升到"核心域"了吗？怎么改它的对外接口？
  4. 客户端用 BitmapPool 复用对象避 GC，服务端用 Netty ByteBuf 池子。如果两边都用 V5 的领域模型，BitmapPool 抽象应该上升到核心还是下沉到适配？

进阶 ：写出服务端版本与客户端版本的共享内核包清单，哪些代码是 100% 复用的？

14.写在最后

这篇文章有点长，12 个章节、近百段代码、4 个版本演进、5 个限界上下文、24+ 道思考题。但它本质上只想说一件事：

OOP 不是写出来的，是"演化"出来的。

你不可能从一开始就写出 V5 的设计，也不应该追求 。第 06 篇说过"YAGNI：你大概率不会需要它"，V0 在 2019 年的某个赶工夜晚被写出来的时候，它甚至不应该被批评。

真正的问题是，

  • 当事故来临时，你能不能用 V0→V1 的内功（封装/接口/组合）把它救活？
  • 当业务变复杂时，你能不能用 V1→V2 的内功（SOLID）让它优雅扩展？
  • 当代码味道堆积时，你能不能用 V2→V3 的内功（重构十二式）做精准手术？
  • 当需要回归保护时，你能不能用 V3→V4 的内功（可测试性）锁住正确性？
  • 当团队规模扩大时，你能不能用 V4→V5 的内功（DDD）重塑边界？

11 篇内功 + 1 篇综合实战 ，你已经拥有了完整的工具箱。剩下的，是去你自己的代码里找到那个 V0，

  • 它可能是你三年前写的某个支付 SDK
  • 它可能是你接手别人的某个推送中间件
  • 它可能是公司里所有人都不敢动的某段历史代码

用这套思维走一遍 V0→V5，然后回来告诉我，

你救活了它，还是它救活了你？

全篇完。

📚 配套阅读建议 ：看完本篇推荐回头重读 11 篇任意一篇 ，你会发现第二遍的理解深度是第一遍的 3 倍

🙏 感谢一路读到这里的你，OOP 这门"古老的手艺"，今天依然是工程中最值得掌握的内功之一。下个专栏见。

相关推荐
DisonTangor2 小时前
【微软开源】Mage-Flow 深度解读：微软4B参数图像生成与编辑模型，单卡A100仅需0.59秒
人工智能·microsoft·ai作画·开源·aigc
芝士熊爱编程6 小时前
创建型模式-单例模式
java·单例模式·设计模式
microrain7 小时前
从硬编码到热插拔：SagooIoT插件架构如何打破物联网平台的扩展瓶颈
物联网·golang·开源·sagooiot
java_logo7 小时前
Docker Compose 部署 Apache Superset：轻松搭建开源 BI 平台
docker·开源·apache·superset·轩辕镜像·superset部署方案·docker superset
咖啡八杯8 小时前
GoF设计模式——访问者模式
设计模式·访问者模式
千桐科技8 小时前
DataX 执行引擎正式加入：qData 开源版 v1.6.0 新增 Quartz + DataX 轻量运行模式！
java·大数据·开源·数据治理·数据中台·qdata
王同学的AI学习日记9 小时前
Qwen-Image-3.0技术实测：文字渲染、长上下文与多场景能力深度评测
大数据·人工智能·ai·开源
程序员在囧途9 小时前
AIGC SaaS 多租户平台怎么做行业客户二次演示？从 https://aigc.likeadmin.cn 到开源应用中心复盘链路
开源·aigc
谢栋_10 小时前
设计模式从入门到精通之（七）责任链模式
java·设计模式·责任链模式
热门推荐
01GitHub 镜像站点022026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片03如何新建文件夹？ 电脑新建文件夹的4种方法04AI科技热点日报 | 2026年07月01日05国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）06AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路07幻兽帕鲁 - 服务器管理员权限与 GM 命令完全指南08微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新09【解构】DeepSeek V4 发布：技术报告深度解读 + 横向对比六大开源模型，我们的判断是……102026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？