Android APIs
public abstract class

JobService

extends Service
java.lang.Object
   ↳ android.content.Context
     ↳ android.content.ContextWrapper
       ↳ android.app.Service
         ↳ android.app.job.JobService

Class Overview

Entry point for the callback from the JobScheduler.

This is the base class that handles asynchronous requests that were previously scheduled. You are responsible for overriding onStartJob(JobParameters), which is where you will implement your job logic.

This service executes each incoming job on a Handler running on your application's main thread. This means that you must offload your execution logic to another thread/handler/AsyncTask of your choosing. Not doing so will result in blocking any future callbacks from the JobManager - specifically onStopJob(android.app.job.JobParameters), which is meant to inform you that the scheduling requirements are no longer being met.

Summary

Constants
String PERMISSION_BIND Job services must be protected with this permission:
     
         ...
          
    

        
[Expand]
Inherited Constants
From class android.app.Service
From class android.content.Context
From interface android.content.ComponentCallbacks2
Public Constructors
JobService()
Public Methods
final void jobFinished(JobParameters params, boolean needsReschedule)
Callback to inform the JobManager you've finished executing.
abstract boolean onStartJob(JobParameters params)
Override this method with the callback logic for your job.
abstract boolean onStopJob(JobParameters params)
This method is called if the system has determined that you must stop execution of your job even before you've had a chance to call jobFinished(JobParameters, boolean).
[Expand]
Inherited Methods
From class android.app.Service
From class android.content.ContextWrapper
From class android.content.Context
From class java.lang.Object
From interface android.content.ComponentCallbacks2
From interface android.content.ComponentCallbacks

Constants

public static final String PERMISSION_BIND

Added in API level 21

Job services must be protected with this permission:

     
         ...
     
 

If a job service is declared in the manifest but not protected with this permission, that service will be ignored by the OS.

Constant Value: "android.permission.BIND_JOB_SERVICE"

Public Constructors

public JobService ()

Added in API level 21

Public Methods

public final void jobFinished (JobParameters params, boolean needsReschedule)

Added in API level 21

Callback to inform the JobManager you've finished executing. This can be called from any thread, as it will ultimately be run on your application's main thread. When the system receives this message it will release the wakelock being held.

You can specify post-execution behaviour to the scheduler here with needsReschedule . This will apply a back-off timer to your job based on the default, or what was set with setBackoffCriteria(long, int). The original requirements are always honoured even for a backed-off job. Note that a job running in idle mode will not be backed-off. Instead what will happen is the job will be re-added to the queue and re-executed within a future idle maintenance window.

Parameters
params Parameters specifying system-provided info about this job, this was given to your application in onStartJob(JobParameters).
needsReschedule True if this job should be rescheduled according to the back-off criteria specified at schedule-time. False otherwise.

public abstract boolean onStartJob (JobParameters params)

Added in API level 21

Override this method with the callback logic for your job. Any such logic needs to be performed on a separate thread, as this function is executed on your application's main thread.

Parameters
params Parameters specifying info about this job, including the extras bundle you optionally provided at job-creation time.
Returns
  • True if your service needs to process the work (on a separate thread). False if there's no more work to be done for this job.

public abstract boolean onStopJob (JobParameters params)

Added in API level 21

This method is called if the system has determined that you must stop execution of your job even before you've had a chance to call jobFinished(JobParameters, boolean).

This will happen if the requirements specified at schedule time are no longer met. For example you may have requested WiFi with setRequiredNetworkType(int), yet while your job was executing the user toggled WiFi. Another example is if you had specified setRequiresDeviceIdle(boolean), and the phone left its idle maintenance window. You are solely responsible for the behaviour of your application upon receipt of this message; your app will likely start to misbehave if you ignore it. One immediate repercussion is that the system will cease holding a wakelock for you.

Parameters
params Parameters specifying info about this job.
Returns
  • True to indicate to the JobManager whether you'd like to reschedule this job based on the retry criteria provided at job creation-time. False to drop the job. Regardless of the value returned, your job must stop executing.