Retrofit2.0使用PC蛋蛋源码搭建姊妹篇——带进度下载文件

注意：对于大文件的操作一定要加@Streaming，否则会出现OOM

五、文件下载工具类准备
/**

• Description：下载文件工具类
• Created by kang on 2018/3/9.
  */

public class DownloadUtil {
private static final String TAG = "DownloadUtil";
private static final String PATH_CHALLENGE_VIDEO = Environment.getExternalStorageDirectory() + "/DownloadFile";
//视频下载相关
protected ApiInterface mApi;
private Call<ResponseBody> mCall;
private File mFile;
private Thread mThread;
private String mVideoPath; //下载到本地的视频路径

public DownloadUtil() {
    if (mApi == null) {
    //初始化网络请求接口
        mApi = ApiHelper.getInstance().buildRetrofit("https://sapi.daishumovie.com/")
                .createService(ApiInterface.class);
    }
}

public void downloadFile(String url, final DownloadListener downloadListener) {
    String name = url;
    //通过Url得到文件并创建本地文件
    if (FileUtils.createOrExistsDir(PATH_CHALLENGE_VIDEO)) {
        int i = name.lastIndexOf(‘/‘);//一定是找最后一个‘/‘出现的位置
        if (i != -1) {
            name = name.substring(i);
            mVideoPath = PATH_CHALLENGE_VIDEO +
                    name;
        }
    }
    if (TextUtils.isEmpty(mVideoPath)) {
        Log.e(TAG, "downloadVideo: 存储路径为空了");
        return;
    }
    //建立一个文件
    mFile = new File(mVideoPath);
    if (!FileUtils.isFileExists(mFile) && FileUtils.createOrExistsFile(mFile)) {
        if (mApi == null) {
            Log.e(TAG, "downloadVideo: 下载接口为空了");
            return;
        }
        mCall = mApi.downloadFile(url);
        mCall.enqueue(new Callback<ResponseBody>() {
            @Override
            public void onResponse(@NonNull Call<ResponseBody> call, @NonNull final Response<ResponseBody> response) {
                //下载文件放在子线程
                mThread = new Thread() {
                    @Override
                    public void run() {
                        super.run();
                        //保存到本地
                        writeFile2Disk(response, mFile, downloadListener);
                    }
                };
                mThread.start();
            }

            @Override
            public void onFailure(Call<ResponseBody> call, Throwable t) {
                downloadListener.onFailure(); //下载失败
            }
        });
    } else {
        downloadListener.onFinish(mVideoPath); //下载完成
    }
}
//将下载的文件写入本地存储
private void writeFile2Disk(Response<ResponseBody> response, File file, DownloadListener downloadListener) {
    downloadListener.onStart();
    long currentLength = 0;
    OutputStream os = null;

    InputStream is = response.body().byteStream(); //获取下载输入流
    long totalLength = response.body().contentLength();

    try {
        os = new FileOutputStream(file); //输出流
        int len;
        byte[] buff = new byte[1024];
        while ((len = is.read(buff)) != -1) {
            os.write(buff, 0, len);
            currentLength += len;
            Log.e(TAG, "当前进度: " + currentLength);
            //计算当前下载百分比，并经由回调传出
            downloadListener.onProgress((int) (100 * currentLength / totalLength));
            //当百分比为100时下载结束，调用结束回调，并传出下载后的本地路径
            if ((int) (100 * currentLength / totalLength) == 100) {
                downloadListener.onFinish(mVideoPath); //下载完成
            }
        }
    } catch (FileNotFoundException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    } finally {
        if (os != null) {
            try {
                os.close(); //关闭输出流
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
        if (is != null) {
            try {
                is.close(); //关闭输入流
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

}

这一段时我们下载文件的核心代码，我们来简单分析一下。首先我在DownloadUtil这个类的构造函数中初始化了网络请求接口，然后提供了两个方法，downloadFile和writeFile2Disk，顾名思义第一个是下载文件的方法，第二个是将文件写入SDCard的方法。

方法一：downloadFile(String url, final DownloadListener downloadListener)

两个参数：url和downloadListener
url是我们要下载的地址，downloadListener是第三步我们设计的下载回调

先截取url最后一个’/’之后的内容，得到我们将要存储到本地的文件名，然后创建该文件，通过网络请求得到Response对象，接着开启子线程，调用writeFile2Disk方法。

方法二：writeFile2Disk(Response response, File file, DownloadListener downloadListener)

三个参数：Response对象，file和downloadListener
通过Response对象我们可以获取到InputStream输入流，file是之前创建好的本地文件夹，downloadListener是第三步我们设计的下载回调

ok！到此我们要开始计算下载百分比了！
通过InputStream is = response.body().byteStream()可以获取到下载的InputStream输入流，通过long totalLength = response.body().contentLength()获取到下载的总长度；再通过file创建输出流os = new FileOutputStream(file); 此时通过输入流的read(buff)方法每次读取固定大小的buff(一般1024即可),再调用输出流的write方法将buff写入文件，这是一个while循环，直到将输入流的字节全部读取完毕，而正好在每次循环里，我们可以将读取的字节数累加，得到当前已下载的字节长度currentLength，（100*currentLength/totalLength）就是当前下载百分比啦，这个时候我们用downloadListener.onProgress回调将进度传出即可；当进度达到100时，将本地文件地址通过downloadListener.onFinish回调传出！
最后别忘记在finally中关闭输入输出流！

到此，我的Retrofit带进度下载文件的核心代码已经介绍完毕了！有木有迫不及待的想要用用试试呢！

        }

        @Override
        public void onProgress(final int currentLength) {
            Log.e(TAG, "onLoading: " + currentLength);
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    circle_progress.setProgress(currentLength);
                }
            });

        }

        @Override
        public void onFinish(final String localPath) {
            Log.e(TAG, "onFinish: " + localPath);
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    fl_circle_progress.setVisibility(View.GONE);
                    Glide.with(mContext).load(localPath).into(iv_picture);
                }
            });
        }

        @Override
        public void onFailure() {
            Log.e(TAG, "onFailure: ");
            runOnUiThread(new Runnable() {
                @Override
                public void run() {
                    fl_circle_progress.setVisibility(View.GONE);
                }
            });
        }
    });
}

这里PC蛋蛋源码搭建 dsluntan.com 我放上的是下载图片的代码(视频、文件等都类似)，fl_circle_progress是进度条的父布局，circle_progress是环形进度条，在onStart中将fl_circle_progress显示，onProgress中给circle_progress设置进度，onFinish中将fl_circle_progress隐藏，并利用Glide将下载完成的图片显示在iv_picture中，iv_picture就是一个imageView，如果下载过程中出错那就在onFailure中将fl_circle_progress隐藏。因为对UI的处理需要在UI线程中进行，所以这些处理需要通过runOnUiThread切换线程！

原文地址：http://blog.51cto.com/13930863/2161867