美文网首页
Flutter 下载篇 - 贰 | 当下载器遇上切换网络库

Flutter 下载篇 - 贰 | 当下载器遇上切换网络库

作者: 睡觉谁叫 | 来源:发表于2023-03-03 09:32 被阅读0次

    需求背景

    继上篇《Flutter 下载篇 - 壹 | flutter_download_manager 源码解析》中详细介绍了 flutter_download_manager 用法和原理。在优缺点中提到,该库纯 Dart 实现,支持下载管理,暂停,恢复,取消和断点续传。其中有个缺点是网络库与 dio 强耦合,不支持自定义网络库扩展。

    有人会说: dio 这么牛逼,直接用不就好了,为啥还要支持别的网络库,没事别瞎折腾。

    我想说:

    1. 世界不只有一种声音,那不然多无趣。
    2. 第三方库对应用本身来说是黑盒,开发者一般疏于关注其功能改动对应用影响除非产生重大事故,这种不可控的情况应谨慎。
    3. 设计上遵循 DIP 原则,抽象不要依赖具体实现细节,具体细节依赖抽象,我们需要抽象网络层来给项目依赖而非直接依赖 dio。
    4. 快速切换到其他网路库。

    本文将从现状出发,一步步带你解耦 flutter_download_manager 中的网络库。

    现状说明

    从类图上整体了解 flutter_download_manager 类设计过程中对 dio 强耦合概括,然后通过代码具体讲解。

    类图体现

    Untitled.png

    代码体现

    耦合点一:dio.CancelToken

    Untitled 1.png

    每个下载任务请求中都会使用到 dio:CancelToken 通过 dio 网络库间接实现任务的取消功能。

    耦合点二:dio.download

    cancelToken.cancel() 算依赖 CancelToken

    Untitled 2.png

    如上简写代码中调用链关系,最终调用链及对 dio 依赖关系总结:

    下载库对 dio 的依赖在于: CancelToken 和 download 方法

    Untitled 3.png

    如何定制网络库

    通过上述对现状分析总结,结合设计基本原则:封装变化将不变从变化中隔离出来。其中变化的就是网络库的下载,CancelToken 和取消功能。只用封装这部分变化,将网络库下载和 Token 抽象出来进行封装。

    1. 网络层设计

    目的:让 flutter_download_manager 与 dio.download 解耦。

    思路:将网络相关操作抽象成接口,依赖注入到 downloadManager 对象中。

    实施步骤

    1. 抽象网络层接口

    考虑到 download 返回 Future 中对象问题,因为会用到 response.statusCode,这里直接用 dynamic 来,具体可以细化成封装成 DownloadResponse,其中包含 statusCode 属性。

    Untitled 4.png
    1. customhttpclient 通过依赖注入传入 DownloadManager,让其不依赖具体实现而依赖抽象,依赖注入实现对象之间的组合关系提高扩展性。
    Untitled 5.png

    2. CancelToken 设计

    目的:让 flutter_download_manager 与 dio.CancelToken 解耦。

    思路:CancelToken 与取消息息相关,而且必须提供一个 cancel 方法来供 downloadmanager 中暂停等方法使用。考虑到每个 custom_http_client 的 CancelToken 结构体存在不一样,而 cancel 方法命名多样性原则,这里设计一个统一的 DownloadCancelToken 接口,提供 cancel 方法,将其中实现代理给具体网络库的 CancelToken 对象。

    实施步骤

    1. 抽象一个 Token 对象并提供 cancel 方法,并实现一个默认代理其他网络库的 Proxy 类。

    小技巧: 用 Function.apply 是因为它本身支持位置参数和可选参数传入。

    Untitled 6.png
    1. custom_http_client 中抽象一个 DownloadCancelToken 抽象接口供外部使用
    Untitled 7.png

    3. 下载器设计

    目的:下载器与具体实现 downloadmanager 解耦

    思路:downloadmanager 中提供了 addDownload 等下载通用方法及下载管理逻辑抽象。这块存在变化可以有多种实现,也抽象下。

    实施步骤:

    1. 下载器抽象成接口
    Untitled 8.png
    1. downloadManager 依赖 IDownloader
    Untitled 9.png

    至此,可定制网络库改造已全部完成,接下来就可以隔离 dio 网络实现了。

    网络库隔离效果

    Untitled 10.png

    通过依赖注入到 DownloadManager 中即可。

    Untitled 11.png

    如此就完成了对 flutter_download_manager 的网络库扩展改造,实现了一个可定制化的网络框架的下载库。

    完整源码传送门

    总结

    做开闭原则前,最重要的是以最小实现模型为基础捋清楚代码中的变与不变。

    ❤️本文由 编程黑板报 原创,欢迎关注同名公众号,原创技术文章第一时间推送❤️

    相关文章

      网友评论

          本文标题:Flutter 下载篇 - 贰 | 当下载器遇上切换网络库

          本文链接:https://www.haomeiwen.com/subject/jwvsldtx.html