Android下载库（OkHttp3+Retrofit2+RxJava2）

最近封装了一个基于OkHttp3+Retrofit2+RxJava2的下载库给自己的项目用。

• 断点续传

• 多任务

• 数据库存储

先上图（有点糊，各位看官将就一下，有没有人给推荐一个靠谱点的录屏工具【摔盐】不用Windows，谢谢）

preview.gif

嗯。大概就是这鸟样子。有要吐槽UI的，请你安静点，请你安静点，耶～
可能因为服务器和模拟器是同一台电脑，所以速度比较快。。。
下面是重点

//核心库implementation 'eason.linyuzai:eason-download:1.0.1'//如有需要可以添加额外的监听器implementation 'eason.linyuzai:eason-download-listeners:1.0.1'

然后是最简单的用法

//可以当成Http ClientELoad eload = ELoad.Builder(Context context).build();//可以当成一个RequestDownloadTask task = eload.url(String url).create();
task.start();

然后来讲一下自定义配置
ELoad配置

//ELoad配置，配置对所有该ELoad生成的Task生效ELoad eload = ELoad.Builder(Context context)//任务回收器，默认使用TaskQueueRecycler.setTaskRecycler(TaskRecycler taskRecycler)//文件写入器，默认使用OkioSourceFileProcessor.setFileProcessor(FileProcessor fileProcessor)//下载路径，默认context.getExternalCacheDir()+"/ELoad".setDownloadPath(String downloadPath)//生成OkHttpClient.Builder，默认使用DefaultOkHttpClientFactory.setOkHttpClientFactory(OkHttpClientFactory okHttpClientFactory)//生成Retrofit.Builder，默认使用DefaultRetrofitFactory.setRetrofitFactory(RetrofitFactory retrofitFactory)//数据库，默认null，不写入数据库//提供SQLiteManager，也可自己定义，使用其他ORM库.setDatabaseManager(DatabaseManager databaseManager)//生成数据库Bean，如有需要，用于扩展注解式ORM框架.setEntityCreator(DownloadTaskEntity.Creator entityCreator)//下载进度监听.addDownloadListeners(DownloadTask.DownloadListener listener)//下载任务状态监听.addDownloadTaskListener(DownloadTask.DownloadTaskListener listener)
.build();

DownloadTask配置

//方式1:DownloadTask task = eload.url(String url)//url配置//添加header.header(String headerName, String headerValue)//设置headers.headers(Map<String, String> headers)//下载路径，对单个任务有效.filepath(String filepath)//文件名称，不设置会尝试根据Response等信息获取或随机生成.filename(String filename)//URLDecoder，配合服务端进行中文的编解码等.urlDecoder(String urlDecoder)//自定义数据.extra(Serializable extra)//下载进度监听，对单个任务有效.downloadListener(DownloadTask.DownloadListener listener)//下载任务状态监听，对单个任务有效.downloadTaskListener(DownloadTask.DownloadTaskListener listener)
.create();//方式2://通过数据库List<DownloadTaskEntity> entities = eload.loadTaskEntitiesFromDatabase()//将保存的任务记录重新生成DownloadTaskDownloadTask task = eload.convert(DownloadTaskEntity entity)//下载进度监听，对单个任务有效.downloadListener(DownloadTask.DownloadListener listener)//下载任务状态监听，对单个任务有效.downloadTaskListener(DownloadTask.DownloadTaskListener listener)
.create();

操作DownloadTask

//开始DownloadTask.start();//强制开始，在暂停，取消，异常的状态时可以重新下载DownloadTask.start(true);//暂停DownloadTask.pause();//继续，在暂停或异常的状态时可以继续下载DownloadTask.resume();//取消DownloadTask.cancel();//取消，并删除已下载的部分文件DownloadTask.cancel(true);//回收，可以在任务未开始，完成，异常，取消的状态时回收，复用OkHttpClientDownloadTask.recycle();

DownloadTask属性

//获得DownloadTaskEntityDownloadTaskEntity getEntity();//running状态时，下载总进度long getDownloadBytesTemp();//是否是空闲状态boolean isIdle();//是否是准备状态boolean isAttach();//是否是下载状态boolean isRunning();//是否是暂停状态boolean isPause();//是否完成boolean isFinish();//是否异常boolean isError();//是否取消boolean isCancel();

DownloadTaskEntity属性

//TaskIdString getTaskId();//创建时间long getCreateTime();//执行状态int getState();//http(s) HeadersMap<String, String> getHeaders();//UrlString getUrl();//URLDecoderString getUrlDecoder();//文件总大小long getTotalBytes();//已下载大小，只有暂停，取消，异常时才会更新//更新进度请用DownloadTask.getDownloadBytesTemp()long getDownloadBytes();//文件路径String getFilePath();//文件名字String getFileName();//额外数据Serializable getExtra();

使用RxJava2代替DownloadListener和DownloadTaskListener的监听

//回调下载进度和任务状态DownloadTask.toObservable();//回调下载进度DownloadTask.toDownloadObservable();//回调任务状态DownloadTask.toTaskObservable();

DownloadTask.toObservable().subscribe({    switch(it.callType) {    case DownloadTaskWrapper.DOWNLOAD_CONTENT_LENGTH:        //文件大小
        break;    case DownloadTaskWrapper.DOWNLOAD_BYTES_READ:        //字节读入
        break;    case DownloadTaskWrapper.DOWNLOAD_COMPLETE:        //下载完成
        break;    case DownloadTaskWrapper.TASK_PREPARE:        //任务准备
        break;    case DownloadTaskWrapper.TASK_START:        //任务开始
        break;    case DownloadTaskWrapper.TASK_PAUSE:        //任务暂停
        break;    case DownloadTaskWrapper.TASK_RESUME:        //任务继续
        break;    case DownloadTaskWrapper.TASK_ERROR:        //任务异常
        break;    case DownloadTaskWrapper.TASK_COMPLETE:        //任务完成
        break;    case DownloadTaskWrapper.TASK_CANCEL:        //任务取消
        break;    case DownloadTaskWrapper.TASK_RESET:        //任务重置
        break;    case DownloadTaskWrapper.TASK_RECYCLE:        //任务回收
        break;
    }
});//开始任务DownloadTask.start();

也提供Flowable的转换
额外的监听器

//网速计算NetPerSecDownloadListener(TextView textView)//剩余时间RemainingTimeDownloadListener(TextView textView)//百分比下载进度PercentProgressDownloadListener(TextView textView, ProgressBar progressBar, long interval)//具体数据下载进度NumberProgressDownloadListener(TextView textView, ProgressBar progressBar, long interval)//上述监听器都可以设置回调间隔时间//主线程回调下载进度监听MainThreadDownloadListener()//主线程回调下载任务状态监听MainThreadDownloadTaskListener()

作者：淋雨仔
链接：https://www.jianshu.com/p/77b48f0f647d