使用Retrofit下载文件并实现进度监听

1.前言

最近要做一个带进度条下载文件的功能，网上看了一圈，发现好多都是基于OkHttpClient添加拦截器来实现的，个人觉得略显复杂，所以还是采用最简单的方法来实现：基于文件写入来进行进度的监听。

个人觉得不是很科学。只要存在以下两点问题：

1. 在拦截器中添加进度监听没有真正做到对文件下载的监听，此时，数据在拦截器中应该还只是位于内存中，并没有写到文件中。
2. 由于是在拦截器中监听，所以有可能出现已经监听到下载完成了，但实际文件写入还没完成，从而导致出现多线程并发问题。
   如有错误，欢迎指正哈~
   所以，决定还是自己撸一下代码，主要还是基于文件写入来进行进度的监听。

2.实现步骤

2.1 设计监听接口

根据需求设计一下接口：

public interface DownloadListener {
   
    void onStart();//下载开始

    void onProgress(int progress);//下载进度

    void onFinish(String path);//下载完成

    void onFail(String errorInfo);//下载失败
}

如果还需下载速度等等，可以自行设计接口和参数。

2.2 编写网络接口Service

public interface DownloadService {
   

    @Streaming
    @GET
    Call<ResponseBody> download(@Url String url);
}

跟正常接口写法基本一致，需要注意的是要添加@Streaming注解。

默认情况下，Retrofit在处理结果前会将服务器端的Response全部读进内存。如果服务器端返回的是一个非常大的文件，则容易发生oom。使用@Streaming的主要作用就是把实时下载的字节就立马写入磁盘，而不用把整个文件读入内存。

2.3 开始网络请求

public class DownloadUtil {
   

    public static void download(String url, final String path, final DownloadListener downloadListener) {
   

        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl("http://www.xxx.com")
                //通过线程池获取一个线程，指定callback在子线程中运行。
                .callbackExecutor(Executors.newSingleThreadExecutor())
                .