Flutter 下载篇 - 贰 | 当下载器遇上切换网络库
需求背景
继上篇《Flutter 下载篇 - 壹 | flutter_download_manager 源码解析》中详细介绍了 flutter_download_manager 用法和原理。在优缺点中提到,该库纯 Dart 实现,支持下载管理,暂停,恢复,取消和断点续传。其中有个缺点是网络库与 dio 强耦合,不支持自定义网络库扩展。
有人会说: dio 这么牛逼,直接用不就好了,为啥还要支持别的网络库,没事别瞎折腾。
我想说:
- 世界不只有一种声音,那不然多无趣。
- 第三方库对应用本身来说是黑盒,开发者一般疏于关注其功能改动对应用影响除非产生重大事故,这种不可控的情况应谨慎。
- 设计上遵循 DIP 原则,抽象不要依赖具体实现细节,具体细节依赖抽象,我们需要抽象网络层来给项目依赖而非直接依赖 dio。
- 快速切换到其他网路库。
本文将从现状出发,一步步带你解耦 flutter_download_manager 中的网络库。
现状说明
从类图上整体了解 flutter_download_manager 类设计过程中对 dio 强耦合概括,然后通过代码具体讲解。
类图体现
代码体现
耦合点一:dio.CancelToken
每个下载任务请求中都会使用到 dio:CancelToken 通过 dio 网络库间接实现任务的取消功能。
耦合点二:dio.download
cancelToken.cancel() 算依赖 CancelToken
如上简写代码中调用链关系,最终调用链及对 dio 依赖关系总结:
下载库对 dio 的依赖在于: CancelToken 和 download 方法。
如何定制网络库
通过上述对现状分析总结,结合设计基本原则:封装变化将不变从变化中隔离出来。其中变化的就是网络库的下载,CancelToken 和取消功能。只用封装这部分变化,将网络库下载和 Token 抽象出来进行封装。
1. 网络层设计
目的:让 flutter_download_manager 与 dio.download 解耦。
思路:将网络相关操作抽象成接口,依赖注入到 downloadManager 对象中。
实施步骤:
- 抽象网络层接口
考虑到 download 返回 Future 中对象问题,因为会用到 response.statusCode,这里直接用 dynamic 来,具体可以细化成封装成 DownloadResponse,其中包含 statusCode 属性。
- customhttpclient 通过依赖注入传入 DownloadManager,让其不依赖具体实现而依赖抽象,依赖注入实现对象之间的组合关系提高扩展性。
2. CancelToken 设计
目的:让 flutter_download_manager 与 dio.CancelToken 解耦。
思路:CancelToken 与取消息息相关,而且必须提供一个 cancel 方法来供 downloadmanager 中暂停等方法使用。考虑到每个 custom_http_client 的 CancelToken 结构体存在不一样,而 cancel 方法命名多样性原则,这里设计一个统一的 DownloadCancelToken 接口,提供 cancel 方法,将其中实现代理给具体网络库的 CancelToken 对象。
实施步骤:
- 抽象一个 Token 对象并提供 cancel 方法,并实现一个默认代理其他网络库的 Proxy 类。
小技巧: 用 Function.apply 是因为它本身支持位置参数和可选参数传入。
- custom_http_client 中抽象一个 DownloadCancelToken 抽象接口供外部使用
3. 下载器设计
目的:下载器与具体实现 downloadmanager 解耦
思路:downloadmanager 中提供了 addDownload 等下载通用方法及下载管理逻辑抽象。这块存在变化可以有多种实现,也抽象下。
实施步骤:
- 下载器抽象成接口
- downloadManager 依赖 IDownloader
至此,可定制网络库改造已全部完成,接下来就可以隔离 dio 网络实现了。
网络库隔离效果
通过依赖注入到 DownloadManager 中即可。
如此就完成了对 flutter_download_manager 的网络库扩展改造,实现了一个可定制化的网络框架的下载库。
总结
做开闭原则前,最重要的是以最小实现模型为基础捋清楚代码中的变与不变。
太棒了!鼓励自己坚持到底。我希望我为你投入的时间增加了一些价值。
如果觉得文章对你有帮助,点赞、收藏、关注、评论,一键四连支持,你的支持就是我创作最大的动力。
❤️ 本文由 听蝉 原创,欢迎关注公众号:编程黑板报 原创技术文章第一时间推送。 ❤️