版权声明：本文为博主原创文章，未经博主允许不得转载。
JobScheduler学习
后台任务是应用开发中常见的问题。
最简单的做法就是直接开一个Thread，用Handler通信即可，但是所开的线程和活动是没有关系的，一旦应用被杀死，就和之前所创建的线程失去了联系，就算活动再次启动，此时启动的线程并不是之前的线程。
当然，这个问题可以用Service解决，那么如果用户把服务也杀了呢？你可能会想用AlarmManager，周期性地进行唤醒，可是用户关机了，AlarmManager也就没了。当然这还没到“穷途末路”，用BroadcastReceiver就可以直接解决服务自启的所有问题。
但是让我们换个角度来看，打开管理器查看当前活动的服务就能看到，这些一直在活动的后台往往是导致手机耗电飞快的原因。当然这种问题是需要开发者的自觉的，如果让开发者来考虑省电，这将会是开发者的一大烦恼，比如说希望连接WiFi时才进行，插入充电器才进行，将会使代码大大增加；另一方面，万一此时没有网络可用呢？还得写一个BroadcastReceiver来监听网络情况。超级麻烦的不是吗？
Android L开始引入了一个新的API：JobScheduler。正如其名，它允许将任务调度直接交给系统，并且你所需要的许多约束条件，如周期调度，延迟调度，网络连接，电源插入，还有Android L引入的空闲模式（虽然现在还挺鸡肋），都可以快捷地进行设置。现在就开始对JobScheduler的学习
API成员
-
JobInfo
代表一个任务，使用建造者模式进行制造，然后传递给JobScheduler进行调度管理。需要注意的是JobInfo类中的几个常量，建造时需要用到，至于作用会在后面的set方法中介绍：- BACKOFF_POLICY_EXPONENTIAL
- BACKOFF_POLICY_LINEAR
- DEFAULT_INITIAL_BACKOFF_MILLIS
- MAX_BACKOFF_DELAY_MILLIS
- NETWORK_TYPE_ANY
- NETWORK_TYPE_NONE
- NETWORK_TYPE_NOT_ROAMING
- NETWORK_TYPE_UNMETERED
-
JobInfo.Builder
-
JobInfo的建造者，其构造器为：
第一个参数为该任务的标识符，该标识符在相同的uid的所有客户端中必须是唯一的（官方文档是这么写的，我的理解是在该设备上必须是唯一的）。为了保证在应用升级后也是稳定的，因此建议不要基于资源id进行设置
第二个参数是你希望用来处理该任务的服务对应的ComponentName，用来启动该服务
接下来是用来建造JobInfo的各个参数对应的set方法：
-
setBackoffCriteria(long initialBackoffMillis, int backoffPolicy)
设置退避/重试策略。类似网络原理中的冲突退避，当一个任务的调度失败时需要重试，所采取的策略。第一个参数时第一次尝试重试的等待间隔，单位为毫秒，预设的参数有：- DEFAULT_INITIAL_BACKOFF_MILLIS
30000 - MAX_BACKOFF_DELAY_MILLIS
18000000
第二个参数是对应的退避策略，预设的参数有：
- BACKOFF_POLICY_EXPONENTIAL
二进制退避。等待间隔呈指数增长 - BACKOFF_POLICY_LINEAR
- DEFAULT_INITIAL_BACKOFF_MILLIS
-
setMinimumLatency(long minLatencyMillis)
设置任务执行延迟的时长 - setOverrideDeadline(long maxExecutionDelayMillis)
设置任务的最大延迟时长。一旦达到该时间，无论条件是否满足，任务都会执行
由于设置延迟对周期性任务来说没有意义，因此在build()时会抛出IllegalArgumentException异常
-
setPeriodic (long intervalMillis)
设置周期。可以保证在每个间隔之间任务最多只执行一次 -
setPeriodic (long intervalMillis, long flexMillis)
在周期末的一个flex长度的窗口，任务都有可能被执行 -
setPersisted (boolean isPersisted)
设置设备重启后，这个任务是否还保留。需要RECEIVE_BOOT_COMPLETED权限 -
setRequiredNetworkType (int networkType)
设置要求的网络，只有接入给定类型的网络才能执行，而且是必须要接入网络才能执行。预置的参数有：- NETWORK_TYPE_NONE
默认值。表示与网络状态无关 - NETWORK_TYPE_ANY
必须连接网络 - NETWORK_TYPE_NOT_ROAMING
必须连接非漫游的网络 - NETWORK_TYPE_UNMETERED
必须连接非计费的网络
- NETWORK_TYPE_NONE
-
setRequiresCharging (boolean requiresCharging)
设置是否需要充电器接入。默认false -
setRequiresDeviceIdle (boolean requiresDeviceIdle)
设置是否需要设备处于空闲状态。默认false
空闲状态指设置已经有一段时间没有被使用 -
addTriggerContentUri (JobInfo.TriggerContentUri uri)
添加一个TriggerContentUri，该Uri将利用ContentObserver来监控一个Content Uri，当且仅当其发生变化时将触发任务的执行
这个功能不能和setPeriodic(long)或者setPersisted(boolean)一起使用， 因为这样是没有意义的，否则在build()时会抛出IllegalArgumentException异常
为了持续监控content的变化，你需要在最近的任务触发后再调度一个新的任务 -
setTriggerContentMaxDelay (long durationMs)
设置从content变化到任务被执行，中间的最大延迟 -
setTriggerContentUpdateDelay (long durationMs)
设置从content变化到任务被执行中间的延迟。如果在延迟期间content发生了变化，延迟会重新计算 -
build()
创建对应的JobInfo
-
-
JobInfo.TriggerContentUri
保存了一项任务触发绑定的content uri信息
其构造器为：第一个参数是希望监控的content的Uri，第二个参数是标识符
-
JobParameters
当任务被调度，交由应用处理时提供的对象，包含了该任务的信息。无法自己创建JobParameter的实例
由于是用来提供任务信息的，所以基本都是get方法：- PersistableBundle getExtras()
- int getJobId()
- String getTriggeredContentAuthorities()
获得触发该任务的content authorities - Uri[] getTriggeredContentUris()
- boolean isOverrideDeadlineExpired()
判断该调度是否因为达到deadline了
-
JobScheduler
负责调度任务。一般调用schedule(JobInfo)方法将任务加入到调度队列中。JobScheduler无法自己创建，因为是系统级的服务，所以用Context.getSystemService(Context.JOB_SCHEDULER_SERVICE)获得其实例-
int schedule(JobInfo)
将任务加入到调度队列中。将会返回一个结果- RESULT_SUCCESS
加入成功 - RESULT_FAILURE
不合法的参数将会导致失败，有可能是该任务的run-time太短（不是很懂），或者其指定的JobService无法解析
- RESULT_SUCCESS
-
cancel(int jobId)
取消对应ID的任务 - cancelAll()
取消由这个包注册的所有任务 - List< JobInfo > getAllPendingJobs()
获得这个包注册的正在等待的任务 - JobInfo getPendingJob(int jobId)
获得指定的由该包注册的正在等待的任务
-
-
JobService
JobScheduler的回调入口。
由于需要应用来完成任务的执行，因此需要继承该类，重载其onStartJob(JobParameter)方法，进行任务的执行
建议使用Handler来完成任务执行的逻辑，以防阻塞未来的任务
在Manifest注册该Service时，要注意添加android.permission.BIND_JOB_SERVICE权限，否则会被系统忽略-
void jobFinished (JobParameters params, boolean needsReschedule)
当完成任务的执行时，调用该方法通知JobManager。该方法可以在任何线程调用
第一个参数是该任务对应的JobParameter，你会在onStartJob方法获得
第二个参数表示是否需要重新调度。退避机制会产生作用，也就是重调度的任务加入到队列中后，将会等待一段时间才能获得调度。在设备空闲模式下，退避机制不会产生作用 -
boolean onStartJob (JobParameters params)
JobService将会在这个回调方法获得可执行的任务，如果该任务不需要额外的执行，可以立即返回false。否则需要在单独的线程中执行（使用Handler），并且返回true，在任务执行完后调用jobFinished()方法进行通知 -
boolean onStopJob (JobParameters params)
当你主动通知任务执行完毕（jobFinished）之前，系统可能会要求你停止任务，这时将会调用onStopJob方法
当该任务的需求不再满足时将发生这种状况，必须对此做出反应，否则应用可能会出现行为异常。一种立即引起的影响就是系统可能会将你的wakelock释放
返回true表示你希望对该任务重新进行调度，同样需要遵守退避策略；返回false表示你希望放弃该任务
-
关于JobScheduler API的学习大概就是这么多了，可以看到Google从Android L开始就很关注电池续航的问题，包括M的doze mode也是一样，估计N也会引入更好的省电策略。看到网上关于这块的中文资料都不是挺全面，于是就自己尝试对整个API进行学习，感觉还行吧，就酱。
1924
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
