silencedut / taskscheduler

A concise,practical async library for Android project，already was used in million devices

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'
}

taskscheduler's Issues

请教

TaskScheduler.execute(() -> {
List allCity = DBUtils.getCityManager().queryLike(keyword);
if (ObjectUtils.isNotEmpty(allCity)) {
List cityInfoDatas = new ArrayList<>();
for (City city : allCity) {
cityInfoDatas.add(new CityInfoData(city.country, city.countryEn, city.cityId));
}
mView.showMatchCitys(cityInfoDatas);
}
});
我在线程里面去获取数据库的信息。
mView.showMatchCitys(cityInfoDatas)//UI更新
就报错
Only the original thread that created a view hierarchy can touch its views
不能在线程更新UI了，是不是还得用handler才能更新 那这样和一般的异步有什么区别哦

java.util.concurrent.RejectedExecutionException

我在一个图片列表里不断的TaskScheduler.execute(new Task())执行一个下载图片的任务
然后就crach了，是我使用姿势不对么
version：2.4.0

As a Service

How can this library be used as a background service doing a repeated task?

removeHandlerCallback这个方法没找到？

请问下是弃用了吗还是开发中？

咨询~

TaskScheduler.execute(new Task() {
@OverRide
public boolean doInBackground() throws InterruptedException {

                                       }
                @Override
                public void onSuccess(boolean result) {
                    /**UI线程*/
                                   }
            });

为什么这样写TaskScheduler.execute(new Task() {}
中的new Task() 就会报错。
而 Task task = new Task() {}
就不会报错呢？

How can I pass values to the Task via a constructor?

Similar to how in Asynctask I can pass values, I would like to do the same here instead of created global values or retrieving the value from the db. How do I do that?

支持延时任务

不支持像Executor.schedule(runnable, delay, timeUnit)的延时任务？