Android Priority Job Queue:一个专门为Android轻松调度任务的工作队列
16lz
2021-01-23
在android中使用多线程已经是不可或缺的逻辑了,当然你可以直接使用子线程或线程子,在这里介绍的是一个专门为Android轻松调度任务的工作队列——Android Priority Job Queue
如果你需要线程池请看这里:android:线程池和AsyncTask使用小结
- 引入Android Priority Job Queue
compile 'com.birbit:android-priority-jobqueue:2.0.1'
Android Priority Job Queue官方地址:https://github.com/yigit/android-priority-jobqueue
- 配置JobManager
package tsou.com.simple.jobqueuetest;import android.app.Application;import android.util.Log;import com.birbit.android.jobqueue.JobManager;import com.birbit.android.jobqueue.config.Configuration;import com.birbit.android.jobqueue.log.CustomLogger;/** * Created by Administrator on 2017/12/26 0026. */public class MyApplication extends Application { private static MyApplication instance; private JobManager jobManager; @Override public void onCreate() { super.onCreate(); instance = this; // 配置JobMananger configureJobManager(); } public static MyApplication getInstance() { return instance; } public JobManager getJobManager() { return jobManager; } /** * 配置JobMananger */ private void configureJobManager() { Configuration configuration = new Configuration.Builder(this) //日志设置,便于用户查看任务队列的工作信息 .customLogger(new CustomLogger() { @Override public boolean isDebugEnabled() { return true; } @Override public void d(String text, Object... args) { Log.d("huangxiaoguo", String.format(text, args)); } @Override public void e(Throwable t, String text, Object... args) { Log.e("huangxiaoguo", String.format(text, args)); } @Override public void e(String text, Object... args) { Log.e("huangxiaoguo", String.format(text, args)); } @Override public void v(String text, Object... args) { Log.v("huangxiaoguo", String.format(text, args)); } }) //最少开启的线程 .minConsumerCount(3) //最多开启的线程 .maxConsumerCount(3) //一个Thread设置多3个任务 .loadFactor(3) //设置线程在没有任务的情况下保持存活的时长,以秒为单位 .consumerKeepAlive(120) .build(); jobManager = new JobManager(configuration); }}
- 创建Job任务
package tsou.com.simple.jobqueuetest.job;import android.os.SystemClock;import android.support.annotation.NonNull;import android.support.annotation.Nullable;import android.util.Log;import com.birbit.android.jobqueue.Job;import com.birbit.android.jobqueue.Params;import com.birbit.android.jobqueue.RetryConstraint;/** * Created by Administrator on 2017/12/26 0026. */public class MyJob extends Job { private String mPriorty; public MyJob(String priority) { /** * 默认构造器传入的是int(priority)参数是该任务的优先级,优先级越高,越优先执行。 * * requireNetwork(): 设置该任务要求访问网络; *
* groupBy(String groupId):设置组ID,被设置相同组ID的任务,将会按照顺序执行; *
* persist():设置任务为可持久化的,持久化要求Job类为序列化的,这一点并不意外, * 因为一个类的内容只有序列化之后才能变成字节模式保存在硬盘上; *
*delayInMs(long delayMs):设置延迟时间,ms为单位,在该时间之后再放入任务队列中。 *
* addTags :添加标记取消任务时使用 */
super(new Params(Integer.parseInt(priority)) .requireNetwork() .persist() .addTags("huangxiaoguo")); this.mPriorty = priority; Log.e("huangxiaoguo", mPriorty + "初始化"); } @Override public void onAdded() { //任务加入队列并被保存在硬盘上,定义此时要处理的逻辑; Log.e("huangxiaoguo", mPriorty + "====>onAdded==任务加入队列"); } @Override public void onRun() throws Throwable { //任务开始执执行,在此定义任务的主题逻辑,当执行完毕后,任务将被从任务队列中删除; Log.e("huangxiaoguo", mPriorty + "====>onRun==任务开始执行"); SystemClock.sleep(15000); } @Override protected void onCancel(int cancelReason, @Nullable Throwable throwable) { //任务取消的时候要执行的逻辑; Log.e("huangxiaoguo", mPriorty + "====>onCancel==任务取消"); } @Override protected RetryConstraint shouldReRunOnThrowable(@NonNull Throwable throwable, int runCount, int maxRunCount) { /** * 当onRun()方法中抛出异常时,就会调用该函数, *该函数返回Job类在执行发生异常时的应对策略, *是重新执行还是取消,或者是一定时间之后再尝试。 */ //RetryConstraint的自带策略,立刻重新尝试执行策略, // 直到执行成功或者尝试次数达到最大(18次); // return RetryConstraint.RETRY; //RetryConstraint的自带策略,取消当前任务的执行; //return RetryConstraint.CANCEL; //定期延迟尝试执行任务,如果任务执行失败, // 下次执行的延迟时间会以指数形式增长,最大尝试次数为20次; return RetryConstraint.createExponentialBackoff(runCount, 10); }}
- 开始执行队列
private void initData() { jobManager = MyApplication.getInstance().getJobManager(); }
for (int i = 0; i < 9; i++) { jobManager.addJobInBackground(new MyJob(String.valueOf(i))); }
- 开始任务(一般在执行暂停任务后)
jobManager.start();
- 暂停任务(一般在onStop方法中)
jobManager.stop();
- 取消任务(一般在onDestroy中)
/** * 取消任务时必须要指明tag,不然无效。当然这个tags可以多个 */ jobManager.cancelJobsInBackground(null, TagConstraint.ANY, "huangxiaoguo");
- 清除任务队列(一般在onDestroy方法中)
new Thread(new Runnable() { @Override public void run() { jobManager.clear(); jobManager.destroy(); } }).start();
- 全部执行
- 执行取消任务