在Android 5.0中使用JobScheduler

原文链接 : using-the-jobscheduler-api-on-android-lollipop

在这篇文章中,你会学习到在Android 5.0中如何使用JobScheduler API。JobScheduler API允许开发者在符合某些条件时创建执行在后台的任务。

介绍

在Android开发中,会存在这么些场景 : 你需要在稍后的某个时间点或者当满足某个特定的条件时执行一个任务,例如当设备接通电源适配器或者连接到WIFI。幸运的是在API 21 ( Android 5.0,即Lollipop )中,google提供了一个叫做JobScheduler API的新组件来处理这样的场景。

当一系列预置的条件被满足时,JobScheduler API为你的应用执行一个操作。与AlarmManager不同的是这个执行时间是不确定的。除此之外,JobScheduler API允许同时执行多个任务。这允许你的应用执行某些指定的任务时不需要考虑时机控制引起的电池消耗。

这篇文章中,你会学到关于JobScheduler API更多的东西以及在你的应用中用于运行一个简单的后台任务的JobService,这篇文章中所展示的代码你都可以在github中找到。

1. 创建Job Service

首先,你需要创建一个API最低为21的Android项目,因为JobScheduler是最近的版本才加入Android的,在写这篇文章的时候,它还没有兼容库支持。(译者注:截止目前已知一个兼容库 JobSchedulerCompat

假定你使用的是Android Studio,当你点击了创建项目的完成按钮之后,你会得到一个"hello world"的应用骨架。你要做的第一步就是创建一个新的java类。为了简单起见,让我们创建一个继承自JobService且名字为JobSchedulerService的类,这个类必须实现两个方法,分别是onStartJob(JobParameters params)onStopJob(JobParameters params)

public class JobSchedulerService extends JobService {

    @Override
    public boolean onStartJob(JobParameters params) {

        return false;
    }

    @Override
    public boolean onStopJob(JobParameters params) {

        return false;
    }
}

当任务开始时会执行onStartJob(JobParameters params)方法,因为这是系统用来触发已经被执行的任务。正如你所看到的,这个方法返回一个boolean值。如果返回值是false,系统假设这个方法返回时任务已经执行完毕。如果返回值是true,那么系统假定这个任务正要被执行,执行任务的重担就落在了你的肩上。当任务执行完毕时你需要调用jobFinished(JobParameters params, boolean needsRescheduled)来通知系统。

当系统接收到一个取消请求时,系统会调用onStopJob(JobParameters params)方法取消正在等待执行的任务。很重要的一点是如果onStartJob(JobParameters params)返回false,那么系统假定在接收到一个取消请求时已经没有正在运行的任务。换句话说,onStopJob(JobParameters params)在这种情况下不会被调用。

需要注意的是这个job service运行在你的主线程,这意味着你需要使用子线程,handler, 或者一个异步任务来运行耗时的操作以防止阻塞主线程。因为多线程技术已经超出了我们这篇文章的范围,让我们简单实现一个Handler来执行我们在JobSchedulerService定义的任务吧。

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( (JobParameters) msg.obj, false );
        return true;
    }

} );

在Handler中,你需要实现handleMessage(Message msg)方法来处理你的任务逻辑。在这个例子中,我们尽量保证例子简单,因此我们只在handleMessage(Message msg)中显示了一个Toast,这里就是你要写你的任务逻辑( 耗时操作 )的地方,比如同步数据等。

当任务执行完毕之后,你需要调用jobFinished(JobParameters params, boolean needsRescheduled)来让系统知道这个任务已经结束,系统可以将下一个任务添加到队列中。如果你没有调用jobFinished(JobParameters params, boolean needsRescheduled),你的任务只会执行一次,而应用中的其他任务就不会被执行。

jobFinished(JobParameters params, boolean needsRescheduled)的两个参数中的params参数是从JobService的onStartJob(JobParameters params)的params传递过来的,needsRescheduled参数是让系统知道这个任务是否应该在最初的条件下被重复执行。这个boolean值很有用,因为它指明了你如何处理由于其他原因导致任务执行失败的情况,例如一个失败的网络请求调用。

创建了Handler实例之后,你就可以实现onStartJob(JobParameters params)onStopJob(JobParameters params)方法来控制你的任务了。你可能已经注意到在下面的代码片段中onStartJob(JobParameters params)返回了true。这是因为你要通过Handler实例来控制你的操作,这意味着Handler的handleMessage方法的执行时间可能比onStartJob(JobParameters params)更长。返回true,你会让系统知道你会手动地调用jobFinished(JobParameters params, boolean needsRescheduled)方法。

@Override
public boolean onStartJob(JobParameters params) {
    mJobHandler.sendMessage( Message.obtain( mJobHandler, 1, params ) );
    return true;
}

@Override
public boolean onStopJob(JobParameters params) {
    mJobHandler.removeMessages( 1 );
    return false;
}

一旦你在Java部分做了上述工作之后,你需要到AndroidManifest.xml中添加一个service节点让你的应用拥有绑定和使用这个JobService的权限。

<service android:name=".JobSchedulerService"
    android:permission="android.permission.BIND_JOB_SERVICE" />

2. 创建一个JobScheduler对象

随着JobSchedulerService构建完毕,我们可以开始研究你的应用如何与JobScheduler API进行交互了。第一件要做的事就是你需要创建一个JobScheduler对象,在实例代码的MainActivity中我们通过getSystemService( Context.JOB_SCHEDULER_SERVICE )初始化了一个叫做mJobScheduler的JobScheduler对象。

mJobScheduler = (JobScheduler) 
    getSystemService( Context.JOB_SCHEDULER_SERVICE );

当你想创建定时任务时,你可以使用JobInfo.Builder来构建一个JobInfo对象,然后传递给你的Service。JobInfo.Builder接收两个参数,第一个参数是你要运行的任务的标识符,第二个是这个Service组件的类名。

JobInfo.Builder builder = new JobInfo.Builder( 1,
        new ComponentName( getPackageName(), 
            JobSchedulerService.class.getName() ) );

这个builder允许你设置很多不同的选项来控制任务的执行。下面的代码片段就是展示了如何设置以使得你的任务可以每隔三秒运行一次。

builder.setPeriodic( 3000 );

其他设置方法 :

  • setMinimumLatency(long minLatencyMillis): 这个函数能让你设置任务的延迟执行时间(单位是毫秒),这个函数与setPeriodic(long time)方法不兼容,如果这两个方法同时调用了就会引起异常;
  • setOverrideDeadline(long maxExecutionDelayMillis):
    这个方法让你可以设置任务最晚的延迟时间。如果到了规定的时间时其他条件还未满足,你的任务也会被启动。与setMinimumLatency(long time)一样,这个方法也会与setPeriodic(long time)不兼容,同时调用这两个方法会引发异常。
  • setPersisted(boolean isPersisted):
    这个方法告诉系统当你的设备重启之后你的任务是否还要继续执行。
  • setRequiredNetworkType(int networkType):
    这个方法让你这个任务只有在满足指定的网络条件时才会被执行。默认条件是JobInfo.NETWORK_TYPE_NONE,这意味着不管是否有网络这个任务都会被执行。另外两个可选类型,一种是JobInfo.NETWORK_TYPE_ANY,它表明需要任意一种网络才使得任务可以执行。另一种是JobInfo.NETWORK_TYPE_UNMETERED,它表示设备不是蜂窝网络( 比如在WIFI连接时 )时任务才会被执行。
  • setRequiresCharging(boolean requiresCharging):
    这个方法告诉你的应用,只有当设备在充电时这个任务才会被执行。
  • setRequiresDeviceIdle(boolean requiresDeviceIdle):
    这个方法告诉你的任务只有当用户没有在使用该设备且有一段时间没有使用时才会启动该任务。

需要注意的是setRequiredNetworkType(int networkType), setRequiresCharging(boolean requireCharging) 以及 setRequiresDeviceIdle(boolean requireIdle)这几个方法可能会使得你的任务无法执行,除非调用setOverrideDeadline(long time)设置了最大延迟时间,使得你的任务在未满足条件的情况下也会被执行。一旦你预置的条件被设置,你就可以构建一个JobInfo对象,然后通过如下所示的代码将它发送到你的JobScheduler中。

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

你可能注意到了,这个schedule方法会返回一个整型。如果schedule方法失败了,它会返回一个小于0的错误码。否则它会返回我们在JobInfo.Builder中定义的标识id。

如果你的应用想停止某个任务,你可以调用JobScheduler对象的cancel(int jobId)来实现;如果你想取消所有的任务,你可以调用JobScheduler对象的cancelAll()来实现。

mJobScheduler.cancelAll();

到了这里,你现在应该已经知道如何在你的应用中使用JobScheduler API来执行批量任务和后台操作了。

结论

这篇文章中,你学会了怎么实现一个使用Handler对象来运行后台任务的JobService子类,你也学会了如何使用JobInfo.Builder来设置JobService。掌握了这些之后,你可以在减少资源消耗的同时提升应用的效率。

Android安全概述

Android 安全架构的理解不仅帮助我了解 Android 的工作原理,而且为我开启了如何构建移动操作系统和 Linux 的眼界。 本章从安全角度讲解 Android 架构的基础知识。 在第 1....

发布于:1年以前  |  1711次阅读  |  详细内容 »

Android Linux 内核层安全

作为最广为人知的开源项目之一,Linux 已经被证明是一个安全,可信和稳定的软件,全世界数千人对它进行研究,攻击和打补丁。 不出所料,Linux 内核是 Android 操作系统的基...

发布于:1年以前  |  1482次阅读  |  详细内容 »

Android 本地用户空间层安全

本地用户空间层在 Android 操作系统的安全配置中起到重要作用。 不理解在该层上发生了什么,就不可能理解在系统中如何实施安全架构决策。 在本章中,我们的主题是 Android ...

发布于:1年以前  |  1186次阅读  |  详细内容 »

Android 框架层安全

如我们在第1.2节中所描述的那样,应用程序框架级别上的安全性由 IPC 引用监视器实现。 在 4.1 节中,我们以 Android 中使用的进程间通信系统的描述开始,讲解这个级别上的...

发布于:1年以前  |  1410次阅读  |  详细内容 »

Android 应用层安全

虽然在这一节中我们描述了应用层的安全性,但是实际的安全实施通常出现在到目前为止描述的底层。 但是,在介绍应用层之后,我们更容易解释 Android 的一些安全功能。 5.1 ...

发布于:1年以前  |  2034次阅读  |  详细内容 »

Android 安全的其它话题

在本章中,我们会涉及到与 Android 安全相关的其他主题,这些主题不直接属于已经涉及的任何主题。 6.1 Android 签名过程 Android 应用程序以 Android 应用包文件(.apk文件...

发布于:1年以前  |  1587次阅读  |  详细内容 »

数据绑定(Data Binding)-Part5

原文链接 : Data Binding - Part 5 直到现在,我们已经见识到Data Binding的很多功能了。但是还有一个很强大的特点没有介绍,那就是观察者模式的应用。 观察者模式在数据会...

发布于:1年以前  |  1059次阅读  |  详细内容 »

在Android 5.0中使用JobScheduler

原文链接 : using-the-jobscheduler-api-on-android-lollipop 在这篇文章中,你会学习到在Android 5.0中如何使用JobScheduler API。JobScheduler API允许开发者在符合某些...

发布于:1年以前  |  965次阅读  |  详细内容 »

Code Review最佳实践

原文链接 : Code Review Best Practices 在Wiredrive上,我们做了很多的Code Review。在此之前我从来没有做过,这对于我来说是一个全新的体验,下面来总结一下在Code Revie...

发布于:1年以前  |  1183次阅读  |  详细内容 »

从Dex到源代码(伪代码)

这个系列的头两篇文章中,我写了两篇关于APK format和aapt tool的文章. 在这篇文章中我将重点讲述dex2jar,它是一个作用于Android .dex文件和Java .class文件的工具。已经...

发布于:1年以前  |  1380次阅读  |  详细内容 »

第五章 基于空间的架构

第五章 基于空间的架构 大多数基于网站的商务应用都遵循相同的请求流程:一个请求从浏览器发到web服务器,然后到应用服务器,然后到数据库服务器。虽然这个模式在用户数不...

发布于:1年以前  |  1165次阅读  |  详细内容 »

Retrofit指南

这是一篇关于如何使用Retrofit写一个Android的REST客户端的小教程。 我为什么选择Retrofit? 在使用square的Retrofit之前,我尝试过Volley和AsyncTask。但在使用过Retrofi...

发布于:1年以前  |  1366次阅读  |  详细内容 »

使用Mockito对异步方法进行单元测试

原文链接 : Unit testing asynchronous methods with Mockito 之前我拍着胸脯承诺要维护的我博客,因此才有了这篇文章。但是请忘记我的那些承诺,我今天要写的是关于Mockit...

发布于:1年以前  |  1150次阅读  |  详细内容 »

Android中调试RxJava

原文链接 : Debugging RxJava on Android 调试是查找和分析bug的过程或者预防软件的正确操作出现问题Wikipedia。 当前调试不是一件容易的事情,我们在处理Android的异步操...

发布于:1年以前  |  797次阅读  |  详细内容 »

国内优秀Android学习资源

技术博客 应用开发 博主 博客 备注 任玉刚 CSDN博客 深入Android应用开发,深度与广度兼顾 郭霖 CSDN博客 内容实用,行文流畅,高人气博主 夏安明 CSDN博客 ...

发布于:1年以前  |  1194次阅读  |  详细内容 »

最多阅读

简化Android的UI开发 7月以前  |  193173次阅读
Android设计与开发工作流 7月以前  |  2301次阅读
Google Enjarify:可代替dex2jar的dex反编译 1年以前  |  2293次阅读
Android多渠道打包工具:apptools 1年以前  |  1924次阅读
Android权限 - 第一篇 1年以前  |  1893次阅读
Google Java编程风格规范(中文版) 1年以前  |  1875次阅读
Stetho 1年以前  |  1811次阅读
Android UI基本技术点 1年以前  |  1803次阅读
30分钟搭建一个android的私有Maven仓库 1年以前  |  1767次阅读
2015 Google IO带来的新 Android 开发工具 1年以前  |  1707次阅读
你应该知道的布局和属性 1年以前  |  1655次阅读
听FackBook工程师讲*Custom ViewGroups* 1年以前  |  1652次阅读
MVP在Android平台上的应用 1年以前  |  1634次阅读
Gradle小知识#3:任务的顺序 1年以前  |  1629次阅读