<h3 class="nolinks"><span style="color: #0000ff;">Introduction</span></h3>
<p>When working with Android, there will be occasions where you want to run a task at a later point in time or under certain conditions, such as when a device is plugged into a power source or connected to a Wi-Fi network. Google has provided a new component known as the <span style="color: #008000;"><strong>JobScheduler</strong></span> API to handle this very scenario.</p>
<p>Android JobScheduler API is a better choice for scheduling background jobs for your application.It improves the battery life by performing similar jobs as batches in the background.It is the better alternative for <strong><span style="color: #008000;">AlarmManager</span></strong> and <strong><span style="color: #008000;">syncAdapters</span></strong>.</p>
<p>In this tutorial, you will learn how to use the <strong><span style="color: #008000;">JobScheduler</span></strong> API for running a task in background. The <strong><span style="color: #008000;">JobScheduler</span></strong> API allows developers to create jobs that execute in the background when certain conditions are met.</p>
<p>Get <span style="color: #000080;"><strong>GITHUB</strong></span> code from <a href="https://github.com/arunk7839/JobSchedulerExample"><strong><span style="color: #00ff00;">here</span></strong></a>.</p>
<h3 class="nolinks"><span style="color: #0000ff;">Creating the Job Service</span></h3>
<ul>
<li>Create a new Android project with a minimum required API of 21, because the <strong><span style="color: #008000;">JobScheduler</span></strong> API works only on API level 21 and above.</li>
<li>Firstly create a new Java class that extends <strong><span style="color: #008000;">JobService</span></strong> class. To keep things simple, let&#8217;s name it <span style="color: #0000ff;"><strong>JobSchedulerService</strong></span> .</li>
<li>Now you must override two methods <strong><span style="color: #008000;">onStartJob</span><span style="color: #008000;">(JobParameters params)</span></strong> and <strong><span style="color: #008000;">onStopJob(JobParameters params)</span></strong>.</li>
</ul>
<pre style="padding-left: 30px;"><code>public class JobSchedulerService extends JobService {

 @Override
 public boolean onStartJob(JobParameters jobParameters) {
 
 return false;
 }

 @Override
 public boolean onStopJob(JobParameters params) {
 return false;
 }
}</code></pre>
<p> ;</p>
<p><strong><span style="color: #0000ff;">onStartJob(JobParameters params)</span></strong> :</p>
<ul>
<li>This method is called by the system when all the job parameters are met and the time for job execution arrived.</li>
<li>You can place your job in this method.</li>
<li>you must return a boolean from this method.</li>
<li>If the return value is <strong><span style="color: #008000;">false</span></strong>, the system assumes that whatever task has run did not take long and is done by the time the method returns(false).</li>
<li>Always keep in mind that the job service runs on your application&#8217;s main thread. This means that you <em>have to</em> use another thread, a handler, or an asynchronous task to run longer tasks to not block the main thread.</li>
<li>If you place your job in separate thread then you have to return true from the onStartJob() method.</li>
<li>If the return value is <span style="color: #008000;"><strong>true</strong></span>, then the system assumes that your job is still running in a separate thread and the burden falls on you, the developer, to tell the system when the given task is complete by calling <strong><span style="color: #008000;">jobFinished(JobParameters params, boolean needsRescheduled)</span></strong>.</li>
<li>For the jobFinished() you have to pass two parameters:</li>
</ul>
<ol>
<li>Job parameters.</li>
<li>Boolean(return true if you want to re-scheduled the same job again otherwise false).</li>
</ol>
<p> ;</p>
<p><strong><span style="color: #0000ff;">onStopJob(JobParameters params)</span></strong> :</p>
<ul>
<li>System called this method if your background job is cancelled before being finished.This happens if any of your job parameters are no longer available.For example wifi cuts off while downloading a file.</li>
<li>You can clear the unfinished job resources from this method.</li>
<li>You have to return true from this method if you want to re-scheduled the same job again otherwise return false.</li>
</ul>
<p> ;</p>
<p>Here we will use <strong><span style="color: #0000ff;">AsynTask</span></strong> to run our job in <span style="color: #008000;"><strong>JobSchedulerService </strong></span>class.</p>
<pre><code>private static class JobTask extends AsyncTask<;JobParameters, Void, JobParameters>; {
 private final JobService jobService;

 public JobTask(JobService jobService) {
 this.jobService = jobService;
 }

 @Override
 protected JobParameters doInBackground(JobParameters... params) {

<strong><span style="color: #008000;">//Place your code here</span></strong>
 for(int i=1;i<;=10;i++)
 {
 Log.e("number","num"+i);
 }

 return params[0];
 }

 @Override
 protected void onPostExecute(JobParameters jobParameters) {
 jobService.jobFinished(jobParameters, false);
 }
}</code></pre>
<p>In the <strong><span style="color: #008000;">AsyncTask</span></strong>, implement the <strong><span style="color: #008000;">doInBackground(JobParameters&#8230; params)</span></strong> method and the <span style="color: #008000;"><strong>onPostExecute(JobParameters jobParameters)</strong></span>.Inside the <span style="color: #008000;"><strong>doInBackground</strong></span> method, to keep things simple we will print the numbers from 1 to 10 though this is where you can put the logic of your own task which you want to execute.</p>
<p>In <strong><span style="color: #008000;">onPostExecute</span></strong> method ,when the task is done, you need to call <strong><span style="color: #008000;">jobFinished(JobParameters params, boolean needsRescheduled)</span></strong> to let the system know that you&#8217;re done with that task and now it can begin queuing up the next operation. If you don&#8217;t do this, your jobs will only run once and your application will not be allowed to perform additional jobs.</p>
<p>With the <strong><span style="color: #008000;">AsyncTask</span></strong> created, you can go ahead and start implementing the <strong>onStartJob(JobParameters params)</strong> and <strong>onStopJob(JobParameters params)</strong> methods to control your tasks. You&#8217;ll notice that in the following code snippet, the <strong><span style="color: #008000;">onStartJob(JobParameters params)</span></strong> method returns true. This is because you&#8217;re going to use an <strong>AsyncTask</strong> to control your operation, which means that it could take longer to finish than the onStartJob(JobParameters params) method. By returning <strong>true</strong>, you&#8217;re letting the application know that you will manually call the <strong><span style="color: #008000;">jobFinished(JobParameters params, boolean needsRescheduled) </span></strong>method.</p>
<pre><code>@Override
public boolean onStartJob(JobParameters jobParameters) {
 Toast.makeText(getApplicationContext(), "Job started ", Toast.LENGTH_LONG).show();
 new JobTask(this).execute(jobParameters);

 return true;
}

@Override
public boolean onStopJob(JobParameters params) {
 return false;
}</code></pre>
<p>Once you&#8217;re done with the Java portion of the <strong><span style="color: #008000;">JobSchedulerService</span> </strong>class, you need to go into <strong><span style="color: #008000;"><span class="skimlinks-unlinked">AndroidManifest.xml</span></span></strong> and add a node for the service so that your application has permission to bind and use this class as a <strong><span style="color: #008000;">JobService</span></strong>.</p>
<!-- WP QUADS Content Ad Plugin v. 3.0.1 -->
<div class="quads-location quads-ad2" id="quads-ad2" style="float:none;margin:0px;">

</div>

<pre><code><;service android:name=".JobSchedulerService"
 android:permission="android.permission.BIND_JOB_SERVICE"
 android:exported="true"/>;</code></pre>
<h3 class="nolinks"><span style="color: #0000ff;"> Creating the Job Scheduler</span></h3>
<p>With <strong><span style="color: #008000;">JobSchedulerService</span> </strong>class finished, we can start looking at how your application will interact with the JobScheduler API. The first thing you will need to do is create a <strong><span style="color: #008000;">JobScheduler</span></strong> object, called <strong><span style="color: #008000;">jobScheduler</span></strong> in the sample code, and initialize it by getting an instance of the system service <span style="color: #008000;"><strong>JOB_SCHEDULER_SERVICE</strong></span>. In the sample application, this is done in the <strong><span style="color: #008000;">MainActivity</span> </strong>class.</p>
<pre><code>final JobScheduler jobScheduler =
 (JobScheduler) getSystemService(Context.JOB_SCHEDULER_SERVICE);</code></pre>
<p>When you want to create your scheduled task, you can use the JobInfo.Builder to construct a JobInfo object that gets passed to your service. To create a <strong><span style="color: #008000;">JobInfo</span></strong> object, <strong><span style="color: #008000;">JobInfo.Builder</span></strong> accepts two parameters. The first is the identifier of the job that you will run and the second is the component name of the service that you will use with the <strong><span style="color: #008000;">JobScheduler</span></strong> API.</p>
<pre><code>if (Build.VERSION.SDK_INT >;= Build.VERSION_CODES.N) {
 jobInfo = new JobInfo.Builder(JOB_ID, new ComponentName(this, JobSchedulerService.class))
 .setPeriodic(15*60*1000,7*60*1000)
 .build();

} else
{
 jobInfo = new JobInfo.Builder(JOB_ID, new ComponentName(this, JobSchedulerService.class))
 .setPeriodic(60*1000)
 .build();
}</code></pre>
<p>This builder allows you to set many different options for controlling when your job will execute. The following code snippet shows how you could set your task to run periodically every one minute.It works well in Lollipop &; Marshmallow only.</p>
<pre><code>jobInfo.setPeriodic(60*1000);</code></pre>
<ul>
<li><strong><span style="color: #0000ff;">setPeriodic(long intervalMillis)</span></strong> : Specify that this job should recur with the provided interval, not more than once per period. You have no control over when within this interval this job will be executed,only the guarantee that it will be executed at most once within this interval.</li>
</ul>
<p>For Nougat and above we have to write the below code:</p>
<pre><code>jobInfo.setPeriodic(15*60*1000,7*60*1000)</code></pre>
<ul>
<li><strong><span style="color: #0000ff;">setPeriodic(long intervalMillis,long flexMillis)</span></strong> : This method accepts 2 parameters :<br />
<code>intervalMs</code><strong class="markup--strong markup--p-strong"> </strong>The job should run at most once every intervalMs. The minimum value is 15min.<br />
<code>flexMs</code> How close to the end of the period the job should run. The minimum value is 5min.</li>
</ul>
<p>So our task will run every 15 minutes. And since our flex parameter is set to 7 minutes the library will determine the best moment between 8th and 15th minute to execute the <strong><span style="color: #008000;">JobSchedulerService</span></strong>.</p>
<p>Other methods include:</p>
<ul>
<li><strong><span style="color: #0000ff;">setMinimumLatency(long minLatencyMillis)</span></strong> : This makes your job not launch until the stated number of milliseconds have passed. This is incompatible with<strong><span style="color: #008000;"> setPeriodic(long time)</span></strong> and <em>will</em> cause an exception to be thrown if they are both used.</li>
<li style="list-style-type: none;"></li>
<li><span style="color: #0000ff;"><strong>setOverrideDeadline(long maxExecutionDelayMillis) </strong></span>: This will set a deadline for your job. Even if other requirements are not met, your task will start approximately when the stated time has passed. Like <span style="color: #008000;"><strong>setMinimumLatency(long time)</strong>,</span> this function is mutually exclusive with <strong><span style="color: #008000;">setPeriodic(long time)</span></strong> and <em>will </em>cause an exception to be thrown if they are both used.</li>
<li style="list-style-type: none;"></li>
<li><strong><span style="color: #0000ff;">setPersisted(boolean isPersisted) </span></strong>: This function tells the system whether your task should continue to exist after the device has been rebooted.</li>
<li style="list-style-type: none;"></li>
<li><strong><span style="color: #0000ff;">setRequiredNetworkType(int networkType) </span></strong>: This function will tell your job that it can only start if the device is on a specific kind of network. The default is <strong><span style="color: #008000;">JobInfo.NETWORK_TYPE_NONE</span></strong>, meaning that the task can run whether there is network connectivity or not. The other two available types are <strong><span style="color: #008000;">JobInfo.NETWORK_TYPE_ANY</span></strong>, which requires some type of network connection available for the job to run, and <strong><span style="color: #008000;">JobInfo.NETWORK_TYPE_UNMETERED</span></strong>, which requires that the device be on a non-cellular network.</li>
<li><strong><span style="color: #0000ff;">setRequiresCharging(boolean requiresCharging) </span></strong>: Using this function will tell your application that the job should not start until the device has started charging.</li>
<li><strong><span style="color: #0000ff;">setRequiresDeviceIdle(boolean requiresDeviceIdle) </span></strong>: This tells your job to not start unless the user is not using their device and they have not used it for some time.</li>
</ul>
<p>Once the preferred conditions are stated, you can build the <strong><span style="color: #008000;">JobInfo</span></strong> object and send it to your <strong><span style="color: #008000;">JobScheduler</span></strong> object as shown below.</p>
<div>
<pre><code>jobScheduler.schedule(jobInfo);</code></pre>
<p>We can also check whether the schedule fails or not by writting below code:</p>
</div>
<div class="line number1 index0 alt2">
<pre><code>if( jobScheduler.schedule( builder.build() ) <;= 0 ) {
 //If something goes wrong
 }</code></pre>
</div>
<div>
<p>You&#8217;ll notice that the <strong><span style="color: #008000;">schedule</span></strong> operation returns an integer. If <strong><span style="color: #008000;">schedule</span></strong> fails, it will return a value of zero or less, corresponding to an error code. Otherwise it will return the job identifier that we defined in the<span style="color: #008000;"><strong> JobInfo.Builder</strong></span>.</p>
<p>If your application requires that you stop a specific or all jobs, you can do so by calling <strong><span style="color: #008000;">cancel(int jobId)</span></strong> or <strong><span style="color: #008000;">cancelAll</span></strong>() on the <strong><span style="color: #008000;">JobScheduler </span></strong><span style="color: #000000;">object</span>.</p>
<pre><code>jobScheduler.cancel(JOB_ID);</code></pre>
<pre><code>jobScheduler.cancelAll();</code></pre>
<div>
<div id="highlighter_385686" class="syntaxhighlighter noskimlinks noskimwords java"></div>
</div>
<p>You should now be able to use the <span style="color: #008000;"><strong>JobScheduler</strong></span> API with your own applications to batch jobs and run background operations.</p>
</div>