Android JobScheduler的使用和原理

我们先看一下JobScheduler的使用,了解一下JobScheduler的用法,在看一下JobScheduler的实现源码。

先看一下如何使用,翻译自tutsplus

JobScheduler允许开发者创建在后台执行的job,当预置的条件被满足时,这些Job将会在后台被执行。

在Android开发中,我们会遇到很多这样的情况,比如在未来的某个时间点或者未来满足某种条件(比如插入电源或者连接WiFi)的情况下下去执行一些操作。在Android L上,Google提供了一个叫做JobScheduler的组件来帮助我们处理这种情况。

JobScheduler Api可以在我们的App中执行一些操作,这些操作将会在我们预置的一些条件被满足的时候被执行。和AlarmManager不一样,执行这些操作的时间并不是严格准确的。 JobScheduler会把一系列的job收集起来一起执行,这样既允许我们的job被执行,又能兼顾到手机电量的使用情况,达到节电的目的。

如何使用JobScheduler Api
  1. 创建JobService

首先要确保我们创建的App最小支持的SDK在Android L以上,因为到目前为止,还没有兼容包来提供这个功能。

在我们的工程中写一个继承与JobService的Service(比如叫JobSchedulerService),这个Service提供了两个回调方法,一个是onStartJob(JobParameters params)onStopJob(JobParameters params)

public class JobSchedulerService extends JobService{
  @Overrid
  public boolean onStartJob(JobParameters params){
    return false;
  }

  @Override
  public boolean onStopJob(JobParameters params){
    return false;
  }
}
  • onStartJob

当系统要触发执行我们的Job的时候,会调用onStartJob方法。这个方法会返回一个布尔型的值。

当返回false的时候,系统会认为onStartJob这个方法返回的时候,我们要做的工作已经做完了,这不是一个耗时的工作。

当返回true的时候,系统会认为我们要执行一个耗时的工作,在onStartJob这个方法返回的时候,我们的工作仍然在异步执行。当我们的工作执行完成的时候,我们必须手动调用jobFinished(JobParameters params, boolean needRescheduled)

务必要注意,如果onStartJob返回了true,在异步工作执行完成之后,我们必须手动调用jobFinished方法,如果不调用jobFinished,系统会一直认为我们在执行当前Job,那么系统就不会再入队其他的Job去执行,也就是说JobScheduler的执行队列就会被阻塞了

  • onStopJob

当系统收到一个cancel job的请求时,并且这个job仍然在执行,系统就会调用onStopJob方法。

也就是说在系统受到取消请求时,并不会一定会调用onStopJob方法,只有onStartJob返回true的时候,才会调用onStopJob,否则不调用。
但不论是否调用onStopJob方法,系统受到取消请求时,都会取消该job(具体怎么取消,在讲源码的时候在分析).

需要注意的是,JobService是运行在我们应用的主线程,这意味着我们需要开启新线程或者使用Handler或者AsyncTask来处理耗时的工作。
为了简单起见,下面的代码使用了一个Handler来处理耗时工作,并且在处理的耗时工作也仅仅是弹出一个Toast.

private Handler mJobHandler = new Handler( new Handler.Callback() {
    @Override
    public boolean handleMessage( Message msg ) {
        Toast.makeText( getApplicationContext(), 
            "JobService task running", Toast.LENGTH_SHORT )
            .show();
        //请注意,我们手动调用了jobFinished方法。
        //当onStartJob返回true的时候,我们必须手动调用jobFinished方法
        //否则该应用中的其他job将不会被执行
        jobFinished( (JobParameters) msg.obj, false );
        return true;
    }
} );

jobFinished(JobParameters params, boolean needRescheduled)中的两个参数,第一个参数JobParameter来自于onStartJob(JobParameters params)中的params,这也说明了如果我们想要在onStartJob中执行异步操作,必须要保存下来这个JobParameter

接下来我们改造一下原来的onStartJobonStopJob

@Override
public boolean onStartJob(JobParameters params) {
    //这里我们启用一个Handler来模拟耗时操作
    //注意到我们在使用Hanlder的时候把传进来的JobParameters保存下来了
    mJobHandler.sendMessage( Message.obtain( mJobHandler, 1, params ) );
    //注意这里我们返回了true,因为我们要做耗时操作。
    //返回true意味着耗时操作花费的事件比onStartJob执行的事件更长
    //并且意味着我们会手动的调用jobFinished方法
    return true;
}
 
@Override
public boolean onStopJob(JobParameters params) {
    mJobHandler.removeMessages( 1 );
    return false;
}

要使该JobScheduler能够正常工作,必须在AndroidManifest.xml中注册,并声明权限

<service android:name=".JobSchedulerService"
    android:permission="android.permission.BIND_JOB_SERVICE" />
  1. 创建JobScheduler
    要使用我们创建的JobService,我们必须系统的JobScheduler服务,如下
mJobScheduler = (JobScheduler) 
    getSystemService( Context.JOB_SCHEDULER_SERVICE );

然后使用JobInfo.Builder来设置我们JobScheduler的触发条件

//Builder构造方法接收两个参数,第一个参数是jobId,每个app或者说uid下不同的Job,它的jobId必须是不同的
//第二个参数是我们自定义的JobService,系统会回调我们自定义的JobService中的onStartJob和onStopJob方法
JobInfo.Builder builder = new JobInfo.Builder( 1,
        new ComponentName( getPackageName(), 
            JobSchedulerService.class.getName() ) );
//指定每三秒钟重复执行一次
builder.setPeriodic( 3000 );

JobInfo.Builder可以设置很多参数,但是有一些参数是互斥的,同时设置了之后会抛出异常,下面详细说明一下:

setMinimumLatency(long minLatencyMillis):这个方法指定我们的Job至少要多少毫秒之后执行,比如setMinimumLatency(5000),就表明我们这是了这个JobScheduler之后,这个Job至少要5秒之后执行,前五秒肯定是不会执行的。这个参数和setPeriodic互斥。两个同时设置会抛出异常。

setOverrideDeadline(long maxExecutionDelayMillis):这个方法指定我们的Job在某段时间之后必须执行,即使设置的其他条件不满足(比如我们还设置了要求充电,连接wifi等条件)。这是一个严格准时的执行,比如setOverrideDeadline(5000)就表明这个Job在第五秒的时候会准时执行,而忽略其他的条件。这个方法也和setPerioidc互斥。

setPersisted(boolean isPersisted):来设置是否重启之后继续schedule该Job

setRequiredNetworkType(int networkType):来启动我们这个Job时所需要的网络类型,一共有三个值JobInfo.NETWORK_TYPE_NONE表明启动我们这个Job时不需要任何的网络连接;JobInfo.NETWORK_TYPE_ANY表明启动我们这个Job时只要连着网就可以,不要求网络类型。JobInfo.NETWORK_TYPE_UNMETERED表明启动我们这个Job时需要连接Wifi.

setRequiresCharging(boolean requiresCharging)来表示启动我们这个Job时是否需要连接电源

setRequiresDeviceIdle(boolean requiresDeviceIdle):来表示启动我们这个Job时是否需要机器处于空闲状态。

务必要注意,同时使用setRequiredNetworkType(int networkType), setRequiresCharging(boolean requireCharging)setRequiresDeviceIdle(boolean requireIdle)这三个条件,可能导致我们的Job永远都不会执行。这个时候我们需要setOverrideDeadline(long time)来确保我们的Job肯定能被执行一次

当以上两步都执行完毕之后,我们就可以schedule我们的Job了

if( mJobScheduler.schedule( builder.build() ) <= 0 ) {
    //If something goes wrong
}

JobSchedulerschedule方法返回一个整型。当schedule失败的时候会返回一个负数,成功的时候会返回我们在创建JobInfo.Builder时传入的JobId.

JobScheduler提供了两个方法来取消Job,一个是cancel(int jobId),该方法取消指定的Job,一个是cancelAll来取消所有的Job。

这就是JobScheduler大致的使用流程,下一篇会分析一下JobScheduler的源码。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350

推荐阅读更多精彩内容