是一个传输框架,目前支持:
- 支持 HTTP/HTTPS 断点续传下载
- 支持 HTTP/HTTPS 大文件分片上传
- 支持 类EventBus的task状态变更通知,支持三种线程的订阅模式
- 支持 任务分组,分用户
下载:
““ java
mHandler = new DefaultHttpDownloadHandler();
//创建一个任务
ITask task = new TaskBuilder()
.setName(“test.zip”) //设置任务名称
.setDataSource(URL) //设置数据源
.setDestSource(FILE_PATH) //设置目标路径
.build();
mHandler.setTask(task);
//设置请求参数
Map params = new HashMap<>();
params.put("path","test.zip");
mHandler.setParams(params);
mHandler.setHandlerListenner(new SimpleTaskHandlerListenner());
//设置一个线程池去下载文件,如果不设置,则会在当前线程进行下载。
ThreadPoolExecutor threadPool = new ThreadPoolExecutor(3,3,
6000, TimeUnit.MILLISECONDS,new ArrayBlockingQueue(10000));
mHandler.setThreadPool(threadPool);
java
上传:
mHandler = new DefaultHttpUploadHandler();
//创建一个任务
ITask task = new TaskBuilder()
.setName(“test.zip”) //设置任务名称
.setDataSource(FILE_PATH) //设置数据源
.setDestSource(URL) //设置目标路径
.build();
mHandler.setTask(task);
//设置请求参数
Map params = new HashMap<>();
params.put("path","test.zip");
mHandler.setParams(params);
mHandler.setHandlerListenner(new SimpleTaskHandlerListenner());
//设置一个线程池去上传文件,如果不设置,则会在当前线程进行上传。
ThreadPoolExecutor threadPool = new ThreadPoolExecutor(3,3,
6000, TimeUnit.MILLISECONDS,new ArrayBlockingQueue(10000));
mHandler.setThreadPool(threadPool);
““
1.创建任务
““ java
ITask task = new TaskBuilder()
.setTaskType(task_type) //任务类型
.setDataSource(source) //任务数据源 (下在任务为要下载的服务文件链接,上传任务为要上传的本地文件路径)
.setDestSource(dest) //任务目标源 (下载任务为保存的本地路径,上传任务为服务器地址)
.setName(NAME) //任务名称
.build();
ITaskCmd cmd = new TaskCmdBuilder()
.setTaskType(task_type) //任务类型
.setProcessType(ProcessType.TYPE_ADD_TASK) //操作类型(添加任务)
.setTask(task) //任务信息
.build();
TaskEventBus.getDefault().execute(cmd); //执行命令
““
2.开始任务
““ java
ITaskCmd cmd = new TaskCmdBuilder()
.setTaskType(task_type) //任务类型
.setState(TaskState.STATE_START)
.setProcessType(ProcessType.TYPE_CHANGE_TASK) //操作类型(添加任务)
.setTask(task) //任务信息
.build();
TaskEventBus.getDefault().execute(cmd); //执行命令
java
3.结束/暂停 任务
ITaskCmd cmd = new TaskCmdBuilder()
.setTaskType(task_type) //任务类型
.setState(TaskState.STATE_START)
.setProcessType(ProcessType.TYPE_CHANGE_TASK) //操作类型(添加任务)
.setTask(task) //任务信息
.build();
TaskEventBus.getDefault().execute(cmd); //执行命令
““
4.接收任务变更通知
- 在Activity,Fragement,Service,Dialog 等 onResume 或 onStart 中:
java
TaskEventBus.getDefault().regesit(this);
- 在 onPause , onStop 中使用
java
TaskEventBus.getDefault().unregesit(this);
- 添加一个方法,参数为List tasks,并且添加注解TaskSubscriber
java
@TaskSubscriber
public void onTasksChanged(List
//TODO update ui on any processtype
}
默认情况下TaskScriber 会接受所有任务变更的消息,也可以指定只接受某个操作的消息例如:
java
@TaskSubscriber(taskType = TYPE_DOWNLOAD, processType = TYPE_CHANGE_TASK)
public void onTasksChanged(Listtasks) {
//TODO update ui in posting thread
}
也可以指定消息接收的线程,默认为发送消息的线程,例如:
java
@TaskSubscriber(taskType = TYPE_DOWNLOAD, processType = TYPE_CHANGE_TASK,threadMode = ThreadMode.MODE_MAIN)
public void onTasksChanged(List
//TODO update ui in main thread
}
““ java
TaskEventBus.init(getApplicationContext()); //初始化消息管理器
DaoHelper.init(getApplicationContext()); //初始化数据库
mContext = getApplicationContext();
mTaskManagerProxy = new TaskManagerProxy();
mTaskManagerProxy.setProcessCallback(this);
//Taskprocessor 为在内存中处理任务,TaskdDbProcessor 为数据库操作, 可以 实现ITaskProcessor 替换默认处理器
mTaskManagerProxy.setTaskProcessor(new TaskProcessorProxy(new TaskProcessor(),new TaskDbProcessor()));
mTaskManagerProxy.setTaskManager(new TaskManager());
//可以继承BaseTaskHandler 实现新的传输处理器
mTaskManagerProxy.setTaskHandler(TaskType.TYPE_HTTP_DOWNLOAD, DefaultHttpDownloadHandler.class); //设置下载器
mTaskManagerProxy.setTaskHandler(TaskType.TYPE_HTTP_UPLOAD, DefaultHttpUploadHandler.class); //设置上传器
ThreadPoolExecutor threadPool = new ThreadPoolExecutor(3,3,
6000, TimeUnit.MILLISECONDS,new ArrayBlockingQueue(10000));
mTaskManagerProxy.setThreadPool(TaskType.TYPE_HTTP_UPLOAD, threadPool);//设置上传线程池
threadPool = new ThreadPoolExecutor(3,3,
6000, TimeUnit.MILLISECONDS,new ArrayBlockingQueue(10000));
mTaskManagerProxy.setThreadPool(TaskType.TYPE_HTTP_DOWNLOAD,threadPool); //下载线程池
mTaskManagerProxy.setHeaders(new HashMap()); //设置请求头
mTaskManagerProxy.setParams(new HashMap()); //设置url参数
““
项目地址:
- https://github.com/shilec/Transer
服务端测试Demo详见:
- https://github.com/shilec/WebDemo