TaskScheduler
A concise,practical async library for Android project,already was used in million devices
About
Android的日常开发中,经常需要处理异步任务,系统提供的Handler和Asynctask实在不方便,一些开源的第三方库由于过于庞大和复杂,例如RxJava,虽然很方便,但RxJava在团队中不容易推广,所以实现了一个简洁、方便、实用的异步库。
该异步库已经用于多个日活过百万线上项目中,暂时没发现什么问题,由于线上项目对崩溃率的要求比较严格,可以规避了执行异步任务或UI操作等带来的崩溃。这个库因为单独抽离出来,实际线上会有些差别,但核心思想是一样的,相对原来的更简洁一些。
这个库用起来会很简单,只提供少量的接口,但功能会很强大,其实目的也就是这,就是利用已经相对完善的jdk或者sdk提供的类进行一定的封装,让异步任务更简洁,没必要提供很多看起来功能很全但实际中基本上用不到的接口,达到一看到接口基本就能看懂该怎么用,避免臃肿。
绑定生命周期
支持当通过Handler的方式在Activity、Fragment中执行或延迟执行匿名内部类的runnable时,当onDestroy时,runnable自动被移除,极大简化使用,避免内存泄漏
在Activity里或者Fragment里使用时,在onDestory不需要显示的移除匿名内部类(注意support版本要大于27,官方建议一直用最新的compileSdkVersion和supportVersion)
TaskScheduler.runOnUIThread(this,new Runnable() {
@Override
public void run() {
}
},5000);
可指定在特定生命周期移除未执行任务,如onStop
TaskScheduler.runOnUIThread(this, Lifecycle.Event.ON_STOP, new Runnable() {
@Override
public void run() {
Log.i("LifeFragment","runTask with life on Stop");
}
},5000);
外部传入任意Handler
TaskScheduler.runLifecycleRunnable(this,anyHandler,,new Runnable() {
@Override
public void run() {
}
},5000);
Using
简单的不需要回调的异步任务
TaskScheduler.execute(new Runnable() {
@Override
public void run() {
// DO BACKGROUND WORK
}
});
异步需要回调的任务
Task task = new Task<String>() {
@Override
public String doInBackground() {
return "background task";
}
@Override
public void onSuccess(String result) {
//回调到主线程
}
@Override
public void onFail(Throwable throwable) {
super.onFail(throwable);
//doInBackground 里发生错误时回调
}
@Override
public void onCancel() {
super.onCancel();
//任务被取消时回调
}
});
doInBackground 和 onSuccess(Object result)时默认必须实现的接口,其他实现都是可选的。除了doInBackground在异步线程中执行,其他的都会回调到主线程执行。
执行任务
TaskScheduler.execute(task);
取消任务
将会回调到onCancel(),没法真正取消正在执行的任务,只是结果不在onSuccess里回调, 不一定能让任务停止,和AsyncTask同样道理,可参考之前写的一篇博客为什么AsyncTask的cancel不能真正的让线程终止运行
TaskScheduler.cancel(task);
超时任务
如果任务超时,将会回调到onCancel()
TaskScheduler.executeTimeOutTask(timeOutMillis,task);
周期性任务
如果任务超时,将会回调到onCancel()
主线程,Io线程可选
TaskScheduler.scheduleUITask( SchedulerTask task);
取消任务
TaskScheduler.stopScheduleTask(SchedulerTask task)
其他的一些常用方法
/**
*获取回调到handlerName线程的handler.一般用于在一个后台线程执行同一种任务,避免线程安全问题。如数据库,文件操作
*/
Handler provideHandler(String handlerName)
/**
* 提供一个公用的异步handler
*/
Handler ioHandler()
/**
*常用的handler的操作
*/
runOnUIThread(@NonNull Runnable runnable)
runOnUIThread(Runnable runnable,long delayed)
removeUICallback(@NonNull Runnable runnable)
Add to library
Step1.Add it in your root build.gradle at the end of repositories:
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
Step2. Add the dependency:
dependencies {
compile 'com.github.silencedut:taskscheduler:latest'
}