Android 之基于Retrofit的网络框架Leopard,下载与断点续传深入分析

Leopard

《Android 之基于Retrofit的网络框架Leopard,下载与断点续传深入分析》
转载请注明来自 傻小孩b_移动开发http://www.jianshu.com/users/d388bcf9c4d3)喜欢的可以关注我,不定期总结文章!您的支持是我的动力哈!

前言

Leopard 意为猎豹,在所有猫科动物中。猎豹体型最小,速度快、最稳定。这也是笔者想用这个名字命名这个Kit的原因。希望这个Kit能对部分开发者对于网络框架封装的一些思路有所帮助,笔者也在奋斗路上坚持总结进步中,共勉!最后,有任何问题可以提issuse给我,或者直接联系本人(QQ:708854877 傻小孩b),喜欢可以为我点个star,你们的支持是我最大的动力~谢谢!

Leopard导读

Leopard 下载深入解读

一、基本原理

首先看下整个下载原理图,Leopard下载管理原理图如下:

《Android 之基于Retrofit的网络框架Leopard,下载与断点续传深入分析》 LeoPard Download.png

对于Leopard的下载管理,由于底层由RxJava本地线程安全管理。所有的网络操作都存在于IO线程,订阅方则依赖于主线程,用于Layout处理。在下载管理中,所有的下载的操作都依赖于每一个独立的DownLoadTask(这里指下载任务), 并且每个下载Task都依赖被DownLoadManager 所管理控制。其中每个下载的任务实时状态的存在一个model (DownloadInfo)中,依赖图如下:

《Android 之基于Retrofit的网络框架Leopard,下载与断点续传深入分析》 Leopard DwonLoad_2.png

二、下载进度监听解读分析

一般情况,比较常见的下载进度监听方法:在每次请求下载的时候,将流写入文件的时候,实时将写入的有效长度回调到UI界面,达到监听实时的下载变化。Retrofit底层由OKhttp3支持,比较坑爹没有想外抛出流写入的回调。这时候,我们应该巧妙去重写Okhttp3已经封装好的RsonpseBody,在这底层回调监听,看看Leopard怎么做的。关键代码如下:

**
 * Created by Yuan on 2016/8/25.
 * Detail 下载响应监听进度
 */
public class DownLoadResponseBody extends ResponseBody {
    ....

public BufferedSource source() {
    if (bufferedSource == null) {
        bufferedSource = Okio.buffer(source(mResponseBody.source()));
    }
    return bufferedSource;
}

public Source source(Source source) {
    return new ForwardingSource(source) {
        ....
        @Override
        public long read(Buffer sink, long byteCount) throws IOException {
          ....
            try {
                bytesRead = super.read(sink, byteCount);
            } catch (Exception e){
                e.printStackTrace();
            }
            if (bytesRead != -1) {

            } else {
                bytesRead = 0;
            }

            totalLength += bytesRead;
            downloadInfo.setProgress(downloadInfo.getProgress() + bytesRead);//实时更新downloadinfo的进度

            long progress = downloadInfo.getProgress();
            long total = downloadInfo.getFileLength();
            postMainThread(progress,total);//这里处理回调
            return bytesRead;
        }
    };
}

}

Okhttp3底层流的读写依赖于Okio,没有接触过的程序猿可以自行谷歌了解~在初始化构建RsponseBody的缓存源的时候调用了okio的buffer方法,这里构造的时候需要传入Source接口,这里由请求响应的ReponseBody提供。真正需要进行流的监听,其实就是对Source接口的read监听。这里ForwardingSource操作类,读者可以自行读下ForwardingSource源码,其实只是个委托操作类而已,真正的执行方,是实现了Source接口的ReponseBody。

三、断点续传解读分析

说到断点续传,我们必须先了解下HTTP协议怎么对断点续传进行处理。首先,不是所有的服务器都支持断点续传,这里可以在客户端通过服务器响应的头信息,例如”Accept-Ranges: none”表示不支持。当然,不是所有服务器在进行断点续传的时候都返回状态码200,有时候可以是206,这个读者自己注意下。

那么怎么指定断点续传位置?

断点续传需要做到三点:1、记录断点位置 2、缓存保存 3、服务器支持。
这里得继续说下HTTP协议,首先我们必须理解Ranges这个属性:表示在客户端请求的时候,指定下载范围,例如

Range: bytes=0-499 下载第0-499字节范围的内容
Range: bytes=500-999 下载第500-999字节范围的内容
Range: bytes=500-  下载第500-总大小字节范围的内容
看看Leopard怎么做的,关键代码:
public class DownLoadFileFactory implements Interceptor {

  ....

@Override
public Response intercept(Chain chain) throws IOException {
    Request request = chain.request().newBuilder().addHeader("RANGE", "bytes=" + downloadInfo.getBreakProgress() + "-").build();
    Response originalResponse = chain.proceed(request);
    DownLoadResponseBody body = new DownLoadResponseBody(this.downloadInfo ,originalResponse.body(), fileRespondResult);
    Response response = originalResponse.newBuilder().body(body).build();
    return response;
}

}
Observable.create(new Observable.OnSubscribe<ResponseBody>() {
    @Override
    public void call(Subscriber<? super ResponseBody> subscriber) {
         ....
        Request request = new Request.Builder().url(downloadInfo.getUrl()).build();
        try {
            Response response = okHttpClient.newCall(request).execute();
            ....
            downloadInfo.getDownLoadTask().writeCache(response.body().byteStream());
            // TODO: 2016/8/31 更新数据库 这里记得做下数据库延时更新
            HttpDbUtil.instance.updateState(downloadInfo);
           ....
        } catch (IOException e) {
           ....
        }
    }
})

从代码中我们可以观察到,Leopard对下载请求的时候,会通过DownloadInfo实时记录的进度,在向服务器请求的时候加入RANGE的头信息属性,让服务器在指定的范围返回对于的流。并且,当在Rx控制的IO线程中,Leopard在call进行缓存存储,再下载完成的时候在onNext对文件的最终追加合并,达到断点续传的作用。当然在Leopard中,断点续传也需要结合数据库操作,包括下载状态、进度、断点等信息,这个由读者去源码阅读,欢迎交流~

四、DownLoadManager 与DownLoadTask 解读分析

DownLoadManager 顾名思义,Leopard中对所有的下载任务起一个总控制的管理器。DownLoadTask 顾名思义,Leopard中指的是单一下载任务,可提供下载管理(开始、暂停、停止等功能)。

首先我们看下DownLoadTask 关键代码:
private LeopardClient getClient() {
    return new LeopardClient.Builder()
            .addRxJavaCallAdapterFactory(RxJavaCallAdapterFactory.create())
            .addDownLoadFileFactory(DownLoadFileFactory.create(this.fileRespondResult, this.downloadInfo))
            .build();
}

以上代码很明显每个Task都有一个独立的LeopardClient,在初始化的时候必须依赖DownLoadFileFactory,同时依然由Rx进行本地线程安全控制。

再其次看看其中一个Task的控制,下载控制
public void download( boolean isRestart) {
    ....
    downloadInfo.setState(DownLoadManager.STATE_DOWNLOADING);//改变状态为下载状态
   ...
    if (isRestart) {//如果是重新开始,则一切从0开始
        stop();
        resetProgress();
        startPoints = 0L;
    }
    getClient().downLoadFile(this.downloadInfo, this.fileRespondResult, this);
}
 Observable.create(new Observable.OnSubscribe<ResponseBody>() {
    @Override
    public void call(Subscriber<? super ResponseBody> subscriber) {
         ....
        Request request = new Request.Builder().url(downloadInfo.getUrl()).build();
        try {
            Response response = okHttpClient.newCall(request).execute();
            ....
            downloadInfo.getDownLoadTask().writeCache(response.body().byteStream());
            // TODO: 2016/8/31 更新数据库 这里记得做下数据库延时更新
            HttpDbUtil.instance.updateState(downloadInfo);
           ....
        } catch (IOException e) {
           ....
        }
    }
})

以上代码,刚刚文章前面已经贴过,现在重新贴下。从关键代码,我们可以读出:在Leopard下载任务中,其实也是走了okhttp3底层的异步请求中,关键代码:new Request.Builder().url(downloadInfo.getUrl()).build();在Rx控制的IO线程中进行缓存处理、以及下载任务状态变化。最后则是在主线程更新追加完整的文件。

最后看下DownLoadManager ,其中一个下载任务管理-暂停功能

首先贴下源代码:

public void pauseAllTask(){
    for (DownloadInfo downloadInfo : downloadInfosList){
        downloadInfo.getDownLoadTask().pause();
    }
}
public void pause() {
    ....
    if (this.downloadInfo!=null &&this.downloadInfo.getSubscriber() != null)
        this.downloadInfo.getSubscriber().unsubscribe();
    ....
    HttpDbUtil.instance.updateState(downloadInfo);
}

读者在这里应该可以很直接知道Leopard究竟怎么暂停,最新得Retrofit提供了能够直接取消请求的方法 call.cancel();从暂停的角度,某种意义下,是我们本地以及存储了缓存文件后,再下一次继续下载的时候告诉服务器指定那个范围开始下载的意思。因此,在暂停的时候,Leopard是通过取消下载的订阅事件,达到下载暂停的效果。

五、总结

Leopard,当然也存在许多问题,首先感谢读者在github给的star。其实写Leopard的原因是希望能够帮助程序猿们,一起提高编程抽象思维能力。我们当然也不能只是搬运代码的“程序猿”,更重要我们是需要写出更高质量的代码,创造的“程序猿”。

所以,还是共勉,奋斗路上加油~

源码地址:

Android 基于Retrofit+RxJava 封装 Leopard 网络框架
傻小孩b mark共勉,写给在成长路上奋斗的你
喜欢就为我点下喜欢、给我个github的star吧~ 感谢各位读者阅读。

    原文作者:DevSiven
    原文地址: https://www.jianshu.com/p/3fb0a77d2b60
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞