Android开发笔记（一百四十三）任务调度JobScheduler

任务调度

App除了通过屏幕向用户展示可交互的界面元素之外，还经常需要在后台做些背地里做的事情，比如说精密计算、文件下载、统计分析、数据导入、状态监控等等，这些用户看不到的事一般放在Service中处理。

然而有时候我们希望在特定情况下再启动事务，比如说延迟若干时间之后，或者等手机空闲了再运行，这样一方面不会在系统资源紧张之时喧宾夺主，另一方面也起到削峰填谷提高系统效率的作用。对于这些额外的条件要求，Service并不能直接支持，往往需要加入其他手段，才能较好地满足相关的运行条件，比如：
一、对于延迟时间执行，通常考虑利用系统的闹钟管理器AlarmManager进行定时管理，有关AlarmManager的说明参见《Android开发笔记（五十）定时器AlarmManager》。
二、对于是否联网、是否充电、是否空闲，一般要监听系统的相应广播，常见的系统广播说明如下：
1、网络状态变化需要监听系统广播android.net.conn.CONNECTIVITY_CHANGE；
2、设备是否充电需要监听系统广播Intent.ACTION_POWER_CONNECTED也就是android.intent.action.ACTION_POWER_CONNECTED；
3、设备是否空闲需要监听系统广播Intent.ACTION_SCREEN_OFF也就是android.intent.action.SCREEN_OFF；

可是要想给Service补充以上条件，势必加大了程序逻辑的复杂度，一会儿注册这个事件，一会儿注册那个事件，工程代码将变得不易维护。有鉴于此，Android从5.0开始，增加支持一种特殊的机制，即任务调度JobScheduler，该工具集成了常见的几种运行条件，开发者只需添加少数几行代码，即可完成原来要多种组件配合的工作。

任务调度机制由三个工具组成，首先是JobInfo，它指定了一个任务的概要信息，比如何时启动，启动时需要满足什么条件等等；其次是JobScheduler，它是系统提供的任务调度服务，它的实例从系统服务Context.JOB_SCHEDULER_SERVICE中获得；最后是JobService，它描述了该任务内部的具体业务逻辑，它的运行时刻由JobScheduler根据JobInfo指定的条件而计算决定。下面分别说明这三个工具的编码过程：

 

JobInfo

任务信息的运行条件由JobInfo.Builder来构造，下面是Builder的函数说明：
构造函数：指定该任务来源与目的，与Intent类似，第二个参数指定了开发者自定义的JobService。
setRequiredNetworkType：设置需要的网络条件，有三个取值：JobInfo.NETWORK_TYPE_NONE（无网络时执行，默认）、JobInfo.NETWORK_TYPE_ANY（有网络时执行）、JobInfo.NETWORK_TYPE_UNMETERED（网络无需付费时执行）
setPersisted：重启后是否还要继续执行，此时需要声明权限RECEIVE_BOOT_COMPLETED，否则会报错“java.lang.IllegalArgumentException: Error: requested job be persisted without holding RECEIVE_BOOT_COMPLETED permission.”而且RECEIVE_BOOT_COMPLETED需要在安装的时候就要声明，如果一开始没声明，而在升级时才声明，那么依然会报权限不足的错误。
setRequiresCharging：是否在充电时执行
setRequiresDeviceIdle：是否在空闲时执行
setPeriodic：设置时间间隔，单位毫秒。该方法不能和setMinimumLatency、setOverrideDeadline这两个同时调用，否则会报错“java.lang.IllegalArgumentException: Can't call setMinimumLatency() on a periodic job”，或者报错“java.lang.IllegalArgumentException: Can't call setOverrideDeadline() on a periodic job”。
setMinimumLatency：设置至少延迟多久后执行，单位毫秒。
setOverrideDeadline：设置最多延迟多久后执行，单位毫秒。
build：完成条件设置，返回构建好的JobInfo对象。

 

JobScheduler

任务调度的实例从系统服务Context.JOB_SCHEDULER_SERVICE中获得，代码举例如下：

[java] view plain copy

1. JobScheduler js = (JobScheduler) getSystemService(Context.JOB_SCHEDULER_SERVICE);  

获得任务调度实例后，即可进行任务调度操作，下面是任务调度的相关方法：
schedule：把指定的JobInfo对象放入调度队列，并在条件满足时触发该对象中定义的JobService。
cancel：取消指定编号的任务。
cancelAll：取消所有任务。
getAllPendingJobs：获取所有挂起（即尚未执行）的任务。

 

JobService

任务服务是一种特殊的Service，它描述了该任务内部的具体业务逻辑，需要开发者重写的方法如下：
onStartJob：在任务开始执行时触发。返回false表示执行完毕，返回true表示需要开发者自己调用jobFinished方法通知系统已执行完成。
onStopJob：在任务停止执行时触发。

JobService内部另外实现了两个方法，说明如下

1、onBind方法，源码如下所示

[java] view plain copy

1. public final IBinder onBind(Intent intent) {  
2.     return mBinder.asBinder();  
3. }  

JobService实现了onBind方法，表示任务调度在工作的时候，JobService是通过绑定方式启动的。

2、jobFinished方法，源码如下所示

[java] view plain copy

1. public final void jobFinished(JobParameters params, boolean needsReschedule) {  
2.     ensureHandler();  
3.     Message m = Message.obtain(mHandler, MSG_JOB_FINISHED, params);  
4.     m.arg2 = needsReschedule ? 1 : 0;  
5.     m.sendToTarget();  
6. }  

因为JobService由系统触发，不是在App的主线程中，所以这里通过Message机制与主线程进行通信。

 

启动方式

由于JobService继承自Service，因此既可以把它当作专门的调度服务来启动，也可以把它当作普通的服务来启动。

 

在Service外部进行调度

在Activity代码中增加任务调度，需要声明JobInfo对象，并通过JobScheduler进行调度，具体代码如下所示：

[java] view plain copy

1. //将任务作业发送到作业调度中去  
2. public void scheduleJob() {  
3.     Log.d(TAG, "scheduleJob");  
4.     JobInfo.Builder builder = new JobInfo.Builder(0,   
5.             new ComponentName(this, SimpleJobService.class));  
6.     //设置需要的网络条件，默认为JobInfo.NETWORK_TYPE_NONE即无网络时执行  
7.     //NETWORK_TYPE_NONE  
8.     builder.setRequiredNetworkType(JobInfo.NETWORK_TYPE_ANY);  
9.     //builder.setPersisted(true); //重启后是否还要继续执行  
10.     builder.setRequiresCharging(false); //是否在充电时执行  
11.     builder.setRequiresDeviceIdle(false); //是否在空闲时执行  
12.     //builder.setPeriodic(1000); //设置时间间隔，单位毫秒  
13.     //setPeriodic不能和setMinimumLatency、setOverrideDeadline这两个同时调用  
14.     //否则会报错“java.lang.IllegalArgumentException: Can't call setMinimumLatency() on a periodic job”  
15.     //“java.lang.IllegalArgumentException: Can't call setOverrideDeadline() on a periodic job”  
16.     builder.setMinimumLatency(500); //设置至少延迟多久后执行，单位毫秒  
17.     builder.setOverrideDeadline(3000); //设置最多延迟多久后执行，单位毫秒  
18.     JobInfo ji = builder.build();  
19.       
20.     JobScheduler js = (JobScheduler) getSystemService(Context.JOB_SCHEDULER_SERVICE);  
21.     js.schedule(ji);  
22. }  

该方式用到的JobService代码例子如下所示：

[java] view plain copy

1. public class SimpleJobService extends JobService {  
2. private final static String TAG = "SimpleJobService";  
3.   
4. private Handler mHandler = new Handler() {  
5.     @Override  
6.     public void handleMessage(Message msg) {  
7.         try {  
8.             Thread.sleep(5000);  
9.         } catch (InterruptedException e) {  
10.             e.printStackTrace();  
11.         }  
12.         JobParameters param = (JobParameters) msg.obj;  
13.         jobFinished(param, true);  
14.         Log.d(TAG, "jobFinished");  
15.     }  
16. };  
17.   
18. @Override  
19. public int onStartCommand(Intent intent, int flags, int startId) {  
20.     Log.d(TAG, "onStartCommand");  
21.     return START_NOT_STICKY;  
22. }  
23.   
24. @Override  
25. public boolean onStartJob(JobParameters params) {  
26.     Log.d(TAG, "onStartJob");  
27.     Message message = Message.obtain();  
28.     message.obj = params;  
29.     mHandler.sendMessage(message);  
30.     //返回false表示执行完毕，返回true表示需要开发者自己调用jobFinished方法通知系统已执行完成  
31.     return true;  
32. }  
33.   
34. @Override  
35. public boolean onStopJob(JobParameters params) {  
36.     //停止，不是结束。jobFinished不会直接触发onStopJob  
37.     //必须在“onStartJob之后，jobFinished之前”取消任务，才会在jobFinished之后触发onStopJob  
38.     Log.d(TAG, "onStopJob");  
39.     mHandler.removeMessages(0);  
40.     return true;  
41. }  

以上代码需要注意的是：
1、因为系统服务是通过绑定方式启动JobService，所以此时onStartCommand方法永远不会执行；
2、onStopJob顾名思义是在任务停止时触发，但是直接调用jobFinished方法并不能触发onStopJob。原因是onStopJob的触发是有条件的，首先这里的停止指的是取消任务而不是完成任务；其次必须在“onStartJob之后，jobFinished之前”取消任务，才会在jobFinished之后触发onStopJob。

另外注意在AndroidManifest.xml中补充服务声明：

[html] view plain copy

1. <service  
2.     android:name=".service.SimpleJobService"  
3.     android:permission="android.permission.BIND_JOB_SERVICE" />  

 

在Service内部进行调度

如果Activity通过常规的startService方法启动JobService，那么就得JobService自己在onStartCommand方法中进行任务调度了。除了对onStartCommand的处理存在区别之外，其它代码与上一种方式基本相同，完整的JobService代码如下所示：

[java] view plain copy

1. public class MultiJobService extends JobService {  
2.     private final static String TAG = "MultiJobService";  
3.   
4.     private Handler mHandler = new Handler() {  
5.         @Override  
6.         public void handleMessage(Message msg) {  
7.             JobParameters param = (JobParameters) msg.obj;  
8.             jobFinished(param, true);  
9.             Intent intent = new Intent(getApplicationContext(), MainActivity.class);  
10.             intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);  
11.             startActivity(intent);  
12.         }  
13.     };  
14.   
15.     @Override  
16.     public int onStartCommand(Intent intent, int flags, int startId) {  
17.         Log.d(TAG, "onStartCommand");  
18.         scheduleJob();  
19.         return START_NOT_STICKY;  
20.     }  
21.   
22.     @Override  
23.     public boolean onStartJob(JobParameters params) {  
24.         Log.d(TAG, "onStartJob");  
25.         Message message = Message.obtain();  
26.         message.obj = params;  
27.         mHandler.sendMessage(message);  
28.         //返回false表示执行完毕，返回true表示需要开发者自己调用jobFinished方法通知系统已执行完成  
29.         return true;  
30.     }  
31.   
32.     @Override  
33.     public boolean onStopJob(JobParameters params) {  
34.         Log.d(TAG, "onStopJob");  
35.         mHandler.removeMessages(0);  
36.         return true;  
37.     }  
38.       
39.     //将任务作业发送到作业调度中去  
40.     public void scheduleJob() {  
41.         Log.d(TAG, "scheduleJob");  
42.         JobInfo.Builder builder = new JobInfo.Builder(0,   
43.                 new ComponentName(this, MultiJobService.class));  
44.       //设置需要的网络条件，默认为JobInfo.NETWORK_TYPE_NONE即无网络时执行  
45.         builder.setRequiredNetworkType(JobInfo.NETWORK_TYPE_ANY);  
46.         //重启后是否还要继续执行，此时需要声明权限RECEIVE_BOOT_COMPLETED  
47.         //否则会报错“java.lang.IllegalArgumentException: Error: requested job be persisted without holding RECEIVE_BOOT_COMPLETED permission.”  
48.         //而且RECEIVE_BOOT_COMPLETED需要在安装的时候就要声明，如果一开始没声明，在升级时才声明，那么依然会报权限不足的错误  
49.         builder.setPersisted(true);  
50.         builder.setRequiresCharging(false); //是否在充电时执行  
51.         builder.setRequiresDeviceIdle(false); //是否在空闲时执行  
52.         builder.setPeriodic(1000); //设置时间间隔，单位毫秒  
53.         JobInfo ji = builder.build();  
54.           
55.         JobScheduler js = (JobScheduler) getSystemService(Context.JOB_SCHEDULER_SERVICE);  
56.         js.schedule(ji);  
57.     }  
58.   
59. }  

另外注意在AndroidManifest.xml中补充服务声明：

[html] view plain copy

1. <service  
2.     android:name=".service.MultiJobService"  
3.     android:permission="android.permission.BIND_JOB_SERVICE" />  

点击下载本文用到的任务调度机制的代码


点此查看Android开发笔记的完整目录