有人说“Android的开发，玩的就是多线程”。从某个角度来说的确如此，现在的App被设计的越来越复杂，相信很多开发人员都因大量而又复杂的后台任务(background work)而焦头烂额：Async-Task和Activity的生命周期太过于耦合，虽然实现简单但是对于重要的后台任务还是不靠谱；Loaders虽然可以用于异步从磁盘列读取数据，但是对于异步的网络请求就无能为力了；相对给力点的方案是后台服务中开辟进程池(Thread Pool)，使用ThreadPoolExecutor来帮助管理线程，但是app越复杂后台操作越多，需要处理的多线程的问题越多，想一想就头大.....
但是各位读者不要沮丧，今天就是向大家介绍一个后台任务队列管理库Android-Priority-Job-Queue，它将提供一个优雅的架构来解决以上所有的问题！
1. 简介
用官方的话来说，Android-Priority-Job-Queue是一款专门为Android平台编写的，实现了Job Queue的后台任务队列类库，能够轻松的在后台执行定时任务，并且提高了用户体验和应用的稳定性。其设计理念以灵活性和功能性为主，并且一直在更新。
“Priority Job Queue is an implementation of a Job Queue specifically written for Android to easily schedule jobs (tasks) that run in the background, improving UX and application stability.”
It is written primarily with flexibility & functionality in mind. This is an ongoing project, which we will continue to add stability and performance improvements.
其使用框架也很简便直接：
构造一个任务管理器JobManager，为我们管理任务；
自定义Job类，来作为任务的载体；
在需要时，将自定义的Job类实例加入到JobManager中；
这样就OK了，JobManager会根据优先级、持久性、负载平衡、延迟，网络控制、分组等因素来管理任务的执行。由于是独立于各个Activity，JobManager为Job的执行提供了一个很好的生命周期，用户体验更为棒。是不是很惊喜！闲话少叙，我们来看使用范例吧！
2. 使用实例
2.1 添加方法
在Android Studio添加，如下引用：
dependencies {
compile 'com.birbit:android-priority-jobqueue:2.0.1'
}
如果你很怀旧，还在坚持使用Eclipse，那就在maven这样配置：
com.birbit
android-priority-jobqueue
2.0.1
2.2 配置JobManager
JobManager是整个框架的核心。作为一个重型的对象，建议Application只构建一个JobManager实例供全局使用。另一方面，为了让任务的执行有一个更好的生命周期，建议将JobManager放在Application类，而不是一个具体的Activity。以下是示例代码：
import android.app.Application;
import android.util.Log;
import com.path.android.jobqueue.JobManager;
import com.path.android.jobqueue.config.Configuration;
import com.path.android.jobqueue.log.CustomLogger;
public class JobQueueApplication extends Application {
private JobManager jobManager;
private static JobQueueApplication instance;
@Override
public void onCreate() {
super.onCreate();
instance = this;//1. Application的实例
configureJobManager();//2. 配置JobMananger
}
//私有构造器
private JobQueueApplication(){
instance=this;
}
public JobManager getJobManager() {
return jobManager;
}
public static JobQueueApplication getInstance() {
return instance;
}
private void configureJobManager() {
//3. JobManager的配置器，利用Builder模式
Configuration configuration = new Configuration.Builder(this)
.customLogger(new CustomLogger() {
private static final String TAG = "JOBS";
@Override
public boolean isDebugEnabled() {
return true;
}
@Override
public void d(String text, Object... args) {
Log.d(TAG, String.format(text, args));
}
@Override
public void e(Throwable t, String text, Object... args) {
Log.e(TAG, String.format(text, args), t);
}
@Override
public void e(String text, Object... args) {
Log.e(TAG, String.format(text, args));
}
})
.minConsumerCount(1)//always keep at least one consumer alive
.maxConsumerCount(3)//up to 3 consumers at a time
.loadFactor(3)//3 jobs per consumer
.consumerKeepAlive(120)//wait 2 minute
.build();
jobManager = new JobManager(this, configuration);
}
}
以上是整个自定义Application类的代码，其逻辑很清晰。首先为Application类设置单例模式，并保存私有变量jobManager；然后在onCreate()中调用configureJobManager方法来完成jobManager的初始化。我们来看下在其初始化参数Configuration实例中都配置了哪些内容：
CustomLogger：日志设置，便于用户查看任务队列的工作信息，在调试的过程中很有用，后面分析JobManager的任务调度时就会用到；
minConsumerCount&maxConsumerCount: 最少消费者和最多消费者数量，所谓的消费者就是开启的线程，用来执行任务。任务队列实际上就是一个生产者和消费者问题，用户是生产者，提交任务(Job)，开启的线程就是消费者来执行任务，任务被执行就是“消费”。这里所谓的最少和最大将会下面具体解释；
loadFactor(int)： 其意义是设置多少个任务为一组被分配个一个消费者(Thread)，也就是一个Thread最多要“承包”几个任务来执行；
consumerKeepAlive :设置消费者在没有任务的情况下保持存活的时长，以秒为单位，如果过了这个时长还没有任务，消费者线程就会被回收；
Configuration以建筑者模式来链式配置，对此不是很熟悉的读者可以参考如何构建含有大量参数的构造器：浅谈Builder Pattern的使用和链式配置.
有了JobManger自然还需要Job，下面就来看看如何设置Job.
2.3 Job
自定义的Job类需要继承Android-Priority-Job-Queue提供的Job类，下面就是是一个简单的范例，这个任务的内容就是睡眠5秒。
import android.util.Log;
import com.path.android.jobqueue.Job;
import com.path.android.jobqueue.Params;
import com.path.android.jobqueue.RetryConstraint;
public class MyJob extends Job{
public static final int PRIORITY = 1;
private String text;
String TAG = "Myjob";
int sleepTime;
public MyJob(String text) {
// A job should be persisted in case the application exits
// before job is completed.
super(new Params(PRIORITY).persist());
this.text = text;
sleepTime = 5;
Log.i(TAG, text+" goin");
}
@Override
public void onAdded() {
// Job has been saved to disk.
// This is a good place to dispatch a UI event
// to indicate the job will eventually run.
Log.i(TAG, text+" Onadded");
}
@Override
public void onRun() throws Throwable {
// Job logic goes here.
// All work done here should be synchronous,
// a job is removed from the queue once onRun() finishes.
Thread.sleep(sleepTime*1000);
Log.i(TAG, text+" onRun");
}
@Override
protected RetryConstraint shouldReRunOnThrowable(Throwable throwable, int runCount,
int maxRunCount) {
// An error occurred in onRun.
// Return value determines whether this job should retry or cancel. You can further
// specify a backoff strategy or change the job's priority. You can also apply the
// delay to the whole group to preserve jobs' running order.
return RetryConstraint.createExponentialBackoff(runCount, 10);
}
@Override
protected void onCancel() {
}
}
Job类的模块很清晰，我们只需要按照要求覆盖以下方法即可:
在构造器，利用Params类中配置参数；
onAdded(): 任务加入队列并被保存在硬盘上，定义此时要处理的逻辑；
onRun(): 任务开始执执行，在此定义任务的主题逻辑，当执行完毕后，任务将被从任务队列中删除；
onCancel()：任务取消的时候要执行的逻辑；
shouldReRunOnThrowable()：当onRun()方法中抛出异常时，就会调用该函数，该函数返回Job类在执行发生异常时的应对策略，是重新执行还是取消，或者是一定时间之后再尝试。
在这里特别说明下Params类，通过该类可以配置Job类的各种信息，同样也采用类Builder Pattern的链式配置：
默认构造器传入的是int参数是该任务的优先级，优先级越高，越优先执行。
public Params(int priority) {
this.priority = priority;
}
requireNetwork(): 设置该任务要求访问网络；
groupBy(String groupId)：设置组ID，被设置相同组ID的任务，将会按照顺序执行；
persist()：设置任务为可持久化的，持久化要求Job类为序列化的，这一点并不意外，因为一个类的内容只有序列化之后才能变成字节模式保存在硬盘上；
delayInMs(long delayMs)：设置延迟时间，ms为单位，在该时间之后再放入任务队列中。
2.4 执行任务
Job的执行很简单，就把任务类加入到任务队列中即可以。
public class MainActivity extends AppCompatActivity {
private JobManager jobManager;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Button btn_start = (Button)findViewById(R.id.start_job_button);
//JobManager对象
jobManager = JobQueueApplication.getInstance().getJobManager();
btn_start.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
for(int i=0; i<9 ;i++) {
//将任务加入后台队列中
jobManager.addJobInBackground(new MyJob(“"+i));
}
}
});
}
}
在一个Activity中点击Button,就会把9个MyJob实例加入到后台队列中。其运行效果如下：
03-25 21:44:47.207 I/Myjob: 0 goin
03-25 21:44:47.208 I/Myjob: 1 goin
03-25 21:44:47.208 I/Myjob: 2 goin
03-25 21:44:47.208 I/Myjob: 3 goin
03-25 21:44:47.208 I/Myjob: 4 goin
03-25 21:44:47.208 I/Myjob: 5 goin
03-25 21:44:47.208 I/Myjob: 6 goin
03-25 21:44:47.208 I/Myjob: 7 goin
03-25 21:44:47.208 I/Myjob: 8 goin
03-25 21:44:47.218 I/Myjob: 0 Onadded
03-25 21:44:47.228 I/Myjob: 1 Onadded
03-25 21:44:47.241 I/Myjob: 2 Onadded
03-25 21:44:47.251 I/Myjob: 3 Onadded
03-25 21:44:47.260 I/Myjob: 4 Onadded
03-25 21:44:47.274 I/Myjob: 5 Onadded
03-25 21:44:47.280 I/Myjob: 6 Onadded
03-25 21:44:47.291 I/Myjob: 7 Onadded
03-25 21:44:47.307 I/Myjob: 8 Onadded
03-25 21:44:52.235 I/Myjob: 1 onRun
03-25 21:44:52.267 I/Myjob: 4 onRun
03-25 21:44:52.297 I/Myjob: 7 onRun
03-25 21:44:57.250 I/Myjob: 8 onRun
03-25 21:44:57.282 I/Myjob: 6 onRun
03-25 21:44:57.310 I/Myjob: 5 onRun
03-25 21:45:02.264 I/Myjob: 3 onRun
03-25 21:45:02.299 I/Myjob: 2 onRun
03-25 21:45:02.324 I/Myjob: 0 onRun
为了便于查看,这里输出的日志信息只保留最主要的内容，我们可以看到任务0-8依次启动并加入到任务队列中，然后再被执行，JobManager帮你管理了一切，完美！
有的读者可能已经发行了，任务0-8的执行顺序是混乱的，这就涉及到Android-Priority-JobQueue任务的调度问题，也是本人最好兴趣的内容。
3. 任务调度分析
回顾一下，我们对JobManager的设置：至少一个消费者线程，至多三个；每个消费者线程最多处理三个任务。这些设置就是在影响任务调度。
当一个任务要加入任务队列时，会做出如下的判断：
首先计算当前能处理的任务数的最大值(CurrentTaskCapacity)= 已启动的消费线程数(CurrentThreadNum) * 每个线程处理任务的容量(PerThreadTaskCapacity)；
CurrentTaskCapacity = CurrentThreadNum * PerThreadTaskCapacity
如果当前任务数加上现在要加入任务，小于或等于CurrentTaskCapacity，则将该任务加入到任务队列中；
如果当前任务数加上现在要加入任务，大于CurrentTaskCapacity，则判断CurrentThreadNum是不是已经达到设置的最大值，如果没有就开辟新的消费者线程来承担任务；
如果CurrentTaskCapacity和CurrentThreadNum都达到上限，那就对不起了，该任务就不能加入队列，需要等到有任务执行完毕，任务容量又有了空余时才能进入队列等待执行。
如何验证上面结论呢？还记得我们在Application类中配置JobManager时设置的日志信息吗? 这个时候它就发挥作用了，下面是任务0-8加入到任务队列中时输出的日志，内容很多，请注意的表黑的部分：
03-25 21:44:47.218 D/JOBS: added job id: 84 class: MyJob priority: 0 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.218 I/Myjob: 0 Onadded
03-25 21:44:47.222 D/JOBS: pool-1-thread-1: load factor check. true = (0 < 1)|| (0 * 3 < 1 + 0). consumer thread: false
03-25 21:44:47.222 D/JOBS: adding another consumer
03-25 21:44:47.223 D/JOBS:** starting consumer Thread-177**
03-25 21:44:47.224 D/JOBS: looking for next job
03-25 21:44:47.224 D/JOBS: running groups
03-25 21:44:47.224 D/JOBS: non persistent result null
03-25 21:44:47.228 D/JOBS: added job id: 85 class: MyJob priority: 1 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.228 I/Myjob: 1 Onadded
03-25 21:44:47.234 D/JOBS: persistent result com.path.android.jobqueue.JobHolder@55
03-25 21:44:47.234 D/JOBS: running job MyJob
03-25 21:44:47.237 D/JOBS: pool-1-thread-1: load factor check. false = (1 < 1)|| (1 * 3 < 1 + 1). consumer thread: false
03-25 21:44:47.241 D/JOBS: added job id: 86 class: MyJob priority: 2 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.241 I/Myjob: 2 Onadded
03-25 21:44:47.245 D/JOBS: pool-1-thread-1: load factor check. false = (1 < 1)|| (1 * 3 < 2 + 1). consumer thread: false
03-25 21:44:47.251 D/JOBS: added job id: 87 class: MyJob priority: 3 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.251 I/Myjob: 3 Onadded
03-25 21:44:47.255 D/JOBS: pool-1-thread-1: load factor check. true=(1 < 1) || (1 * 3 < 3 + 1). consumer thread: false
03-25 21:44:47.255 D/JOBS: adding another consumer
03-25 21:44:47.256 D/JOBS: starting consumer Thread-178
03-25 21:44:47.257 D/JOBS: looking for next job
03-25 21:44:47.257 D/JOBS: running groups
03-25 21:44:47.257 D/JOBS: non persistent result null
03-25 21:44:47.260 D/JOBS: added job id: 88 class: MyJob priority: 4 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.260 I/Myjob: 4 Onadded
03-25 21:44:47.264 D/JOBS: persistent result com.path.android.jobqueue.JobHolder@58
03-25 21:44:47.264 D/JOBS: running job MyJob
03-25 21:44:47.270 D/JOBS: pool-1-thread-1: load factor check. false = (2 < 1)|| (2 * 3 < 3 + 2). consumer thread: false
03-25 21:44:47.274 D/JOBS: added job id: 89 class: MyJob priority: 5 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.274 I/Myjob: 5 Onadded
03-25 21:44:47.277 D/JOBS: pool-1-thread-1: load factor check. false = (2 < 1)|| (2 * 3 < 4 + 2). consumer thread: false
03-25 21:44:47.280 D/JOBS: added job id: 90 class: MyJob priority: 6 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.280 I/Myjob: 6 Onadded
03-25 21:44:47.283 D/JOBS: pool-1-thread-1: load factor check. true = (2 < 1)|| (2 * 3 < 5 + 2). consumer thread: false
03-25 21:44:47.283 D/JOBS: adding another consumer
03-25 21:44:47.287 D/JOBS: starting consumer Thread-179
03-25 21:44:47.288 D/JOBS: looking for next job
03-25 21:44:47.288 D/JOBS: running groups
03-25 21:44:47.288 D/JOBS: non persistent result null
03-25 21:44:47.291 D/JOBS: added job id: 91 class: MyJob priority: 7 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.291 I/Myjob: 7 Onadded
03-25 21:44:47.295 D/JOBS: persistent result com.path.android.jobqueue.JobHolder@5b
03-25 21:44:47.295 D/JOBS: running job MyJob
03-25 21:44:47.302 D/JOBS: pool-1-thread-1: load factor check. false = (3 < 1)|| (3 * 3 < 5 + 3). consumer thread: false
03-25 21:44:47.306 D/JOBS: added job id: 92 class: MyJob priority: 8 delay: 0 group : null persistent: true requires network: false
03-25 21:44:47.307 I/Myjob: 8 Onadded
03-25 21:44:47.310 D/JOBS: pool-1-thread-1: load factor check. false = (3 < 1)|| (3 * 3 < 6 + 3). consumer thread: false
日志中这样的load factor check. true = (0 < 1)|| (0 * 3 < 1 + 0)计算表达式，就是在进行线程调度的判定，当计算表达式为true时，就意味着要启动新的消费者进程。 ||右边括号内的表达式就是在比较当前任务数和当前任务容量。
通过日志我们可以看到，面对任务0-8，JobManager依次启动了三个消费者进程，并将这9个任务分配给他们：
Thread-177：任务0、1、2；
Thread-178：任务3、4、5；
Thread-179：任务6、7、8；
三个消费者线程并发执行，由于所有任务的优先级都是一样的，消费者线程们就会随机执行任务。
消费者线程被创建，自然也会被回收，这才是完整的生命周期。以下是当任务执行完成时日志的输出：
03-25 21:47:02.280 D/JOBS: Thread-177: load factor check. false = (2 < 1)|| (2 * 3 < 0 + 0). consumer thread: true
03-25 21:47:02.280 D/JOBS: finishing consumer Thread-177
03-25 21:47:02.310 D/JOBS: Thread-178: load factor check. false = (1 < 1)|| (1 * 3 < 0 + 0). consumer thread: true
03-25 21:47:02.310 D/JOBS: finishing consumer Thread-178
03-25 21:47:02.337 D/JOBS: Thread-179: load factor check. true = (0 < 1)|| (0 * 3 < 0 + 0). consumer thread: true
03-25 21:47:02.337 D/JOBS: didn't allow me to die, re-running Thread-179
03-25 21:47:02.337 D/JOBS: re-running consumer Thread-179
我们可以看到，当任务执行完毕之后Thread-177和Thread-178都被回收了，但是由于我们设置了最小消费者线程数为1，所以Thread-179被留下“坚守岗位”，等待下一个任务的到来，直到超时。
由此可知，JobMananger的任务调度机制还是十分复杂和完备的，真庆幸已经有人帮我们实现了。
4. RetryConstraint
最后要说的就是RetryConstraint，即任务在执行中发生异常之后要执行的策略。用户可以根据自己的使用情况来设置：
RETRY: RetryConstraint的自带策略，立刻重新尝试执行策略，直到执行成功或者尝试次数达到最大(18次)；
CANCEL：RetryConstraint的自带策略，取消当前任务的执行；
*createExponentialBackoff(int runCount, long initialBackOffInMs) *：定期延迟尝试执行任务，如果任务执行失败，下次执行的延迟时间会以指数形式增长,最大尝试次数为20次；
public static RetryConstraint createExponentialBackoff(int runCount, long initialBackOffInMs) {
RetryConstraint constraint = new RetryConstraint(true);
constraint.setNewDelayInMs(initialBackOffInMs *
(long) Math.pow(2, Math.max(0, runCount - 1)));
return constraint;
}
在官方给出的示例PostTweet中，是这样定义* RetryConstraint*的：
@Override
protected RetryConstraint shouldReRunOnThrowable(Throwable throwable, int runCount,
int maxRunCount) {
if(throwable instanceof TwitterException) {
//if it is a 4xx error, stop
TwitterException twitterException = (TwitterException) throwable;
int errorCode = twitterException.getErrorCode();
return errorCode < 400 || errorCode > 499 ? RetryConstraint.RETRY : RetryConstraint.CANCEL;
}
return RetryConstraint.RETRY;
}
如果是4XX的错误(服务器错误)就取消访问，其他异常就离开重新尝试请求。
关于Android-Priority-JobQueue，今天先介绍到这里，内容已经够多了。总之，这是一个很优秀的任务队列管理库，很值得使用和研究。欢迎大家尝试，以及给我留言指教。
阅读参考：
扫一扫
4831
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
