更好的Android多线程下载框架
/**
* 作者：Pich
* 原文链接：http://me.woblog.cn/
* QQ群：129961195
* Github：https://github.com/lifengsofts
*/
概述
为什么是更好的Android多线程下载框架呢，原因你懂的，广告法嘛！
本篇我们我们就来聊聊多线程下载框架，先聊聊我们框架的特点：
- 多线程
- 多任务
- 断点续传
- 支持大文件
- 可以自定义下载数据库
- 高度可配置，像超时时间这类
- 业务数据和下载数据分离
下面我们在说下该框架能实现那些的应用场景：
- 该框架可以很方便的下载单个文件，并且显示各种状态，包括开始下载，下载中，下载失败，删除等状态。
- 也可以实现常见的需要下载功能应用，比如：某某手机助手，在该应用内可以说是下载是核心功能，所以对框架的稳定性，代码可靠性，框架扩展性依赖很大，所以该框架真是从这种出发点而生的。通常这类应用的表示形式分三个页面需要用到下载功能，一个列表用来显示来自业务数据的列表，在该列表右边可以点击单个条目，或者多选实现下载，点击每个条目进入详情，同时还有个一个下载管理，包括大概两个界面，正在下载，下载完成的，在这几个界面都需要一个核心的功能就是都可以暂停，恢复，删除并且能显示下载进度。在列表一个最重要的问题就是界面刷新，如果每次更新都刷新整个列表，那么这将是异常灾难，而我们这个框架正好解决了该问题，采用了回调单个条目并更新该条目的进度和状态。
该项目状态
该项目的雏形始于14年的公司项目需要用到多线程下载，但当时实现的单线程多任务断点续传，后面不断完善，在这之间遇到过很多坑，也对一个下载框架有了更深的认识，所以在16年又重写了该框架。
项目的Github地址：https://github.com/lifengsofts/AndroidDownloader
项目的官网地址：http://i.woblog.cn/AndroidDownloader
项目还处于发展状态，但已经趋于稳定，并且有一定的编码规范，同时采用了多个开源项目的质量控制方案以保证每次代码提交的可靠性。
下面上几张框架Demo的截图，这样用户在心中有一个自己的概念，但是推荐各位还是讲Demo下载到本地亲自，运行一下。
截图
第一个界面是单独下载一个文件。
第二个界面是应用中最常用的一个界面，该界面来自业务数据。
第三个页面是离线管理中的下载中的界面。
第四个页面是离线管理中的下载完成的界面。
可以看到他们在每个界面都能暂停下载，继续下载，以及删除，并且都能拿到进度，状态等信息。
下面就来看看这么强大的下载框架那该如何来使用呢？
添加权限
我相信这一步任何一个项目都已经添加了，但是还是不得不提一下。
该框架需要网络访问权限，如果你是讲文件下载到存储卡，那相应的需要添加存储卡访问权限。
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
配置Service
因为该框架采用才service中下载一个文件的。这样做的目的是下载任务一般都需要在后头下载，如果在Activity中来做这类任务，我想任何一个新手都知道这样不行。
<service android:name="cn.woblog.android.downloader.DownloadService">
<intent-filter>
<action android:name="cn.woblog.android.downloader.DOWNLOAD_SERVICE" />
</intent-filter>
</service>
添加依赖
我们提供了多种集成方式，比如：gradle,maven,jar。选择适合你自己的就行了。
Gradle
在module目录下面的build.gradle文件中添加如下内容：
compile 'cn.woblog.android:downloader:1.0.1'
Maven
或者你使用的Maven依赖管理工具。那道理其实是一样的，在pom文件中添加：
<dependency>
<groupId>cn.woblog.android</groupId>
<artifactId>downloader</artifactId>
<version>1.0.0</version>
</dependency>
或者你也可以参考该链接使用Snapshots版本。
混淆配置
如果你的项目使用了混淆规则，那么一定要加上。
-keep public class * implements cn.woblog.android.downloader.db.DownloadDBController
-keep class cn.woblog.android.downloader.domain.** { *; }
创建下载管理器
现在万事俱备只欠东风了，接下来只需要创建一个下载管理器，该框架所有的操作都是通过该来实现的：
downloadManager = DownloadService.getDownloadManager(context.getApplicationContext());
或者你可以使用更详细的来配置该框架:
Config config = new Config();
//set database path.
// config.setDatabaseName("/sdcard/a/d.db");
// config.setDownloadDBController(dbController);
//set download quantity at the same time.
config.setDownloadThread(3);
//set each download info thread number
config.setEachDownloadThread(2);
// set connect timeout,unit millisecond
config.setConnectTimeout(10000);
// set read data timeout,unit millisecond
config.setReadTimeout(10000);
downloadManager = DownloadService.getDownloadManager(this.getApplicationContext(), config);
下载一个文件
//create download info set download uri and save path.
final DownloadInfo downloadInfo = new DownloadInfo.Builder().setUrl("http://example.com/a.apk")
.setPath("/sdcard/a.apk")
.build();
//set download callback.
downloadInfo.setDownloadListener(new DownloadListener() {
@Override
public void onStart() {
tv_download_info.setText("Prepare downloading");
}
@Override
public void onWaited() {
tv_download_info.setText("Waiting");
bt_download_button.setText("Pause");
}
@Override
public void onPaused() {
bt_download_button.setText("Continue");
tv_download_info.setText("Paused");
}
@Override
public void onDownloading(long progress, long size) {
tv_download_info
.setText(FileUtil.formatFileSize(progress) + "/" + FileUtil
.formatFileSize(size));
bt_download_button.setText("Pause");
}
@Override
public void onRemoved() {
bt_download_button.setText("Download");
tv_download_info.setText("");
downloadInfo = null;
}
@Override
public void onDownloadSuccess() {
bt_download_button.setText("Delete");
tv_download_info.setText("Download success");
}
@Override
public void onDownloadFailed(DownloadException e) {
e.printStackTrace();
tv_download_info.setText("Download fail:" + e.getMessage());
}
});
//submit download info to download manager.
downloadManager.download(downloadInfo);
下载一个文件时直接创建一个DownloadInfo，然后设置下载链接和下载路径。再添加一个监听。就可以提交到下载框架了。
通过下载监听器我们可以获取到很多状态。开始下载，等待中，暂停完成，下载中，删除成功，下载成功，下载失败等状态。
在列表控件使用
我们这里演示如何在RecyclerView这类列表控件使用。当然如果你用的是ListView那道理是一样的。
class ViewHolder extends RecyclerView.ViewHolder {
private final ImageView iv_icon;
private final TextView tv_size;
private final TextView tv_status;
private final ProgressBar pb;
private final TextView tv_name;
private final Button bt_action;
private DownloadInfo downloadInfo;
public ViewHolder(View view) {
super(view);
iv_icon = (ImageView) view.findViewById(R.id.iv_icon);
tv_size = (TextView) view.findViewById(R.id.tv_size);
tv_status = (TextView) view.findViewById(R.id.tv_status);
pb = (ProgressBar) view.findViewById(R.id.pb);
tv_name = (TextView) view.findViewById(R.id.tv_name);
bt_action = (Button) view.findViewById(R.id.bt_action);
}
@SuppressWarnings("unchecked")
public void bindData(final MyDownloadInfo data, int position, final Context context) {
Glide.with(context).load(data.getIcon()).into(iv_icon);
tv_name.setText(data.getName());
// Get download task status
downloadInfo = downloadManager.getDownloadById(data.getUrl().hashCode());
// Set a download listener
if (downloadInfo != null) {
downloadInfo
.setDownloadListener(new MyDownloadListener(new SoftReference(ViewHolder.this)) {
// Call interval about one second
@Override
public void onRefresh() {
if (getUserTag() != null && getUserTag().get() != null) {
ViewHolder viewHolder = (ViewHolder) getUserTag().get();
viewHolder.refresh();
}
}
});
}
refresh();
// Download button
bt_action.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
if (downloadInfo != null) {
switch (downloadInfo.getStatus()) {
case DownloadInfo.STATUS_NONE:
case DownloadInfo.STATUS_PAUSED:
case DownloadInfo.STATUS_ERROR:
//resume downloadInfo
downloadManager.resume(downloadInfo);
break;
case DownloadInfo.STATUS_DOWNLOADING:
case DownloadInfo.STATUS_PREPARE_DOWNLOAD:
case STATUS_WAIT:
//pause downloadInfo
downloadManager.pause(downloadInfo);
break;
case DownloadInfo.STATUS_COMPLETED:
downloadManager.remove(downloadInfo);
break;
}
} else {
// Create new download task
File d = new File(Environment.getExternalStorageDirectory().getAbsolutePath(), "d");
if (!d.exists()) {
d.mkdirs();
}
String path = d.getAbsolutePath().concat("/").concat(data.getName());
downloadInfo = new Builder().setUrl(data.getUrl())
.setPath(path)
.build();
downloadInfo
.setDownloadListener(new MyDownloadListener(new SoftReference(ViewHolder.this)) {
@Override
public void onRefresh() {
if (getUserTag() != null && getUserTag().get() != null) {
ViewHolder viewHolder = (ViewHolder) getUserTag().get();
viewHolder.refresh();
}
}
});
downloadManager.download(downloadInfo);
}
}
});
}
private void refresh() {
if (downloadInfo == null) {
tv_size.setText("");
pb.setProgress(0);
bt_action.setText("Download");
tv_status.setText("not downloadInfo");
} else {
switch (downloadInfo.getStatus()) {
case DownloadInfo.STATUS_NONE:
bt_action.setText("Download");
tv_status.setText("not downloadInfo");
break;
case DownloadInfo.STATUS_PAUSED:
case DownloadInfo.STATUS_ERROR:
bt_action.setText("Continue");
tv_status.setText("paused");
try {
pb.setProgress((int) (downloadInfo.getProgress() * 100.0 / downloadInfo.getSize()));
} catch (Exception e) {
e.printStackTrace();
}
tv_size.setText(FileUtil.formatFileSize(downloadInfo.getProgress()) + "/" + FileUtil
.formatFileSize(downloadInfo.getSize()));
break;
case DownloadInfo.STATUS_DOWNLOADING:
case DownloadInfo.STATUS_PREPARE_DOWNLOAD:
bt_action.setText("Pause");
try {
pb.setProgress((int) (downloadInfo.getProgress() * 100.0 / downloadInfo.getSize()));
} catch (Exception e) {
e.printStackTrace();
}
tv_size.setText(FileUtil.formatFileSize(downloadInfo.getProgress()) + "/" + FileUtil
.formatFileSize(downloadInfo.getSize()));
tv_status.setText("downloading");
break;
case STATUS_COMPLETED:
bt_action.setText("Delete");
try {
pb.setProgress((int) (downloadInfo.getProgress() * 100.0 / downloadInfo.getSize()));
} catch (Exception e) {
e.printStackTrace();
}
tv_size.setText(FileUtil.formatFileSize(downloadInfo.getProgress()) + "/" + FileUtil
.formatFileSize(downloadInfo.getSize()));
tv_status.setText("success");
break;
case STATUS_REMOVED:
tv_size.setText("");
pb.setProgress(0);
bt_action.setText("Download");
tv_status.setText("not downloadInfo");
case STATUS_WAIT:
tv_size.setText("");
pb.setProgress(0);
bt_action.setText("Pause");
tv_status.setText("Waiting");
break;
}
}
}
}
关键代码就是bindData方法中先通过业务的id，我们这里使用的url来获取该业务数据是否有对应的下载任务。如果有，则从新绑定监听器，也就是这段代码
downloadInfo
.setDownloadListener(new MyDownloadListener(new SoftReference(ViewHolder.this)) {
// Call interval about one second
@Override
public void onRefresh() {
if (getUserTag() != null && getUserTag().get() != null) {
ViewHolder viewHolder = (ViewHolder) getUserTag().get();
viewHolder.refresh();
}
}
});
其中要注意到的是缓存每个条目我们使用了SoftReference，这样做的目的内容在吃紧的情况下而已及时的是否这些条目。
接下来又一个重要的点是，设置按钮的点击事件，通常在这样的列表中有一个或多个按钮控制下载状态。
if (downloadInfo != null) {
switch (downloadInfo.getStatus()) {
case DownloadInfo.STATUS_NONE:
case DownloadInfo.STATUS_PAUSED:
case DownloadInfo.STATUS_ERROR:
//resume downloadInfo
downloadManager.resume(downloadInfo);
break;
case DownloadInfo.STATUS_DOWNLOADING:
case DownloadInfo.STATUS_PREPARE_DOWNLOAD:
case STATUS_WAIT:
//pause downloadInfo
downloadManager.pause(downloadInfo);
break;
case DownloadInfo.STATUS_COMPLETED:
downloadManager.remove(downloadInfo);
break;
}
} else {
// Create new download task
File d = new File(Environment.getExternalStorageDirectory().getAbsolutePath(), "d");
if (!d.exists()) {
d.mkdirs();
}
String path = d.getAbsolutePath().concat("/").concat(data.getName());
downloadInfo = new Builder().setUrl(data.getUrl())
.setPath(path)
.build();
downloadInfo
.setDownloadListener(new MyDownloadListener(new SoftReference(ViewHolder.this)) {
@Override
public void onRefresh() {
if (getUserTag() != null && getUserTag().get() != null) {
ViewHolder viewHolder = (ViewHolder) getUserTag().get();
viewHolder.refresh();
}
}
});
downloadManager.download(downloadInfo);
}
关键点就是如果没有下载任务就创建一个下载任务，如果已有下载任务就根据任务现在的状态执行相应的操作，比如当前是没有下载，点击就是创建一个下载任务。
接下还有一个重点就是，我们在回调监听中调用了refresh方法，在该方法中根据状态显示进度和相应的操作按钮。这样做的好处上面已经提到了。
private void refresh() {
if (downloadInfo == null) {
tv_size.setText("");
pb.setProgress(0);
bt_action.setText("Download");
tv_status.setText("not downloadInfo");
} else {
switch (downloadInfo.getStatus()) {
case DownloadInfo.STATUS_NONE:
bt_action.setText("Download");
tv_status.setText("not downloadInfo");
break;
case DownloadInfo.STATUS_PAUSED:
case DownloadInfo.STATUS_ERROR:
bt_action.setText("Continue");
tv_status.setText("paused");
try {
pb.setProgress((int) (downloadInfo.getProgress() * 100.0 / downloadInfo.getSize()));
} catch (Exception e) {
e.printStackTrace();
}
tv_size.setText(FileUtil.formatFileSize(downloadInfo.getProgress()) + "/" + FileUtil
.formatFileSize(downloadInfo.getSize()));
break;
case DownloadInfo.STATUS_DOWNLOADING:
case DownloadInfo.STATUS_PREPARE_DOWNLOAD:
bt_action.setText("Pause");
try {
pb.setProgress((int) (downloadInfo.getProgress() * 100.0 / downloadInfo.getSize()));
} catch (Exception e) {
e.printStackTrace();
}
tv_size.setText(FileUtil.formatFileSize(downloadInfo.getProgress()) + "/" + FileUtil
.formatFileSize(downloadInfo.getSize()));
tv_status.setText("downloading");
break;
case STATUS_COMPLETED:
bt_action.setText("Delete");
try {
pb.setProgress((int) (downloadInfo.getProgress() * 100.0 / downloadInfo.getSize()));
} catch (Exception e) {
e.printStackTrace();
}
tv_size.setText(FileUtil.formatFileSize(downloadInfo.getProgress()) + "/" + FileUtil
.formatFileSize(downloadInfo.getSize()));
tv_status.setText("success");
break;
case STATUS_REMOVED:
tv_size.setText("");
pb.setProgress(0);
bt_action.setText("Download");
tv_status.setText("not downloadInfo");
case STATUS_WAIT:
tv_size.setText("");
pb.setProgress(0);
bt_action.setText("Pause");
tv_status.setText("Waiting");
break;
}
}
}
到这里改下框架的核心使用方法就介绍完了。
支持
如有任何问题可以在加我们的QQ群或者在Github上提Issue，另外请提Issue或者的PR的一定要看下项目的贡献代码的方法以及一要求，因为如果要保证一个开源项目的质量就必须在各方面都规范化。
更好的Android多线程下载框架的更多相关文章
- Andoid 更好的Android多线程下载框架
概述 为什么是更好的Android多线程下载框架呢,原因你懂的,广告法嘛! 本篇我们我们就来聊聊多线程下载框架,先聊聊我们框架的特点: 多线程 多任务 断点续传 支持大文件 可以自定义下载数据库 高度 ...
- 无废话Android之smartimageview使用、android多线程下载、显式意图激活另外一个activity,检查网络是否可用定位到网络的位置、隐式意图激活另外一个activity、隐式意图的配置，自定义隐式意图、在不同activity之间数据传递（5）
1.smartimageview使用 <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android&q ...
- android程序---->android多线程下载(一)
多线程下载是加快下载速度的一种方式,通过开启多个线程去执行一个任务,可以使任务的执行速度变快.多线程的任务下载时常都会使用得到断点续传下载,就是我们在一次下载未结束时退出下载,第二次下载时会接着第一次 ...
- android程序---->android多线程下载(二)
上篇我们讲到了android中下载的断点续传问题,今天我们开始学习下载的多线程问题.本次的多线程源码下载:androdi中多线程下载的实现代码.有关断点续传的问题,请参见博客:android程序--- ...
- android 多线程下载 断点续传
来源:网易云课堂Android极客班第八次作业练习 练习内容: 多线程 asyncTask handler 多线程下载的原理 首先获取到目标文件的大小,然后在磁盘上申请一块空间用于保存目标文件,接着把 ...
- *Android 多线程下载 仿下载助手
今天带来一个多线程下载的 样例.先看一下效果.点击 下载 開始下载,同一时候显示下载进度.完成下载,变成程 安装,点击安装 提示 安装应用. 界面效果 线程池 ThreadPoolExecutor , ...
- *Android 多线程下载 仿下载助手（改进版）
首先声明一点: 这里的多线程下载 并非指的 多个线程下载一个 文件.而是 每一个线程 负责一个文件. 真正的多线程 希望后面能给大家带来. ------------- 欢迎 爱学习的小伙伴 加群 ...
- Android 多线程下载，断点续传，线程池
你可以在这里看到这个demo的源码: https://github.com/onlynight/MultiThreadDownloader 效果图 这张效果图是同时开启三个下载任务,限制下载线程数量的 ...
- Android -- 多线程下载， 断点下载
1. 原理图 2. 示例代码 需要权限 <uses-permission android:name="android.permission.INTERNET"/> &l ...
随机推荐
- JS DOM简介
1. 概述 文档对象模型(Document Object Model,简称 DOM),是W3C组织推荐的处理可扩展标记语言(HTML或者XML)的标准编程接口.W3C 已经定义了一系列的 DOM 接口 ...
- Linux用命令设置终端背景色和字体颜色
用命令改 1.setterm -inversecreen on 背景字体颜色互换 2.setterm -inversecreen on 恢复默认 3.setterm -[选项] [参数] |-back ...
- 《手把手教你》系列基础篇（九十三）-java+ selenium自动化测试-框架设计基础-POM设计模式实现-上篇（详解教程）
1.简介 上一篇介绍了POM的基础理论知识和非POM方式写脚本,这篇介绍利用页面工厂类(page factory)去实现POM,通过查看PageFactory类,我们可以知道它是一个初始化一个页面实例 ...
- 聊聊redis的主从复制吧
聊聊基础概念 主从复制与主从替换 主从复制不同于主从替换,主从复制是正常情况下主节点同步数据到从节点:主从替换是主节点挂了之后,把从节点替换为主节点: 从节点存在的意义:备份主节点数据+负载均衡(对外 ...
- 深入HTTP请求流程
1.HTTP协议介绍 HTTP协议(HyperText Transfer Protocol,超文本传输协议)是因特网上应用最为广泛的一种网络传输协议,它是从WEB服务器传输超文本标记语言(HTML)到 ...
- 1903021121—刘明伟—Java第六周作业—java类
项目 内容 课程班级博客链接 19信计班(本) 作业要求链接 第6周作业 扩展阅读 java面向对象的概念和定义 作业要求 每道题要有题目,代码,截图(只截运行结果). 题目1: 一个Phone ...
- 使用python获取交换机syslog日志并使用jQuery在html上展示
需求 现网有部分pop点独立于海外,无法发送日志给内网日志服务器,同时最近网内有比较重要割接,所以临时写一个脚本来展示网内日志 思路 使用socket接收syslog数据,udp 514,数据部分格式 ...
- 基于surging网络组件多协议适配的平台化发展
前言 Surging 发展已经有快6年的时间,经过这些年的发展,功能框架也趋于成熟,但是针对于商业化需求还需要不断的打磨,前段时间客户找到我想升级成平台化,针对他的需求我 ...
- MongoDB 设置用户和密码
每日一句 Zeal without knowledge is fire without light. 没有知识的热忱犹如火之无光. 给每个数据库设置单独的管理员 我们除了可以设置数据库的超级管理员以外 ...
- es的查询、排序查询、分页查询、布尔查询、查询结果过滤、高亮查询、聚合函数、python操作es
今日内容概要 es的查询 Elasticsearch之排序查询 Elasticsearch之分页查询 Elasticsearch之布尔查询 Elasticsearch之查询结果过滤 Elasticse ...