android 5.0加入了jobscheduler,目的是减少设备唤醒次数,从而减小耗电,而且Android 5.0上静态注册 CONNECTIVITY_ACTION 广播将失效,只有动态注册才行,也可以使用JobScheduler在指定的网络条件运行你的任务,还可以通过ConnectivityManager registerNetworkCallback()来监听网络状态。ACTION_NEW_PICTURE,ACTION_NEW_VIDEO广播已经去除,当然应用可以通过ContentResolver来监听。
涉及到的类包括 JobScheduler,JobService,JobInfo
一 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的建造者,其构造器为:
JobInfo.Builder(int jobId, ComponentName jobService)
- 1
第一个参数为该任务的标识符,该标识符在相同的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 Can't call setOverrideDeadline() on a periodic job.的异常
-
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信息
其构造器为:JobInfo.TriggerContentUri(Uri uri, int flags)
- 1
第一个参数是希望监控的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表示你希望放弃该任务
-