on Android, is onStopJob always called?

Question

I am trying to implement my first JobService. I understand that a call to onStartJob is practically guaranteed (yes there are some edges if I specify some outrageous requirements without an expiration time). But how about onStopJob? Is it guaranteed to be called?

To be specific I have a job that will be performed in the background. But I have a way to know when the job is done (e.g. sharedPrefs). I was hoping to rely on when onStopJob is called to send a Notification to the user that the job is done.

Note: onStopJob is a convenient place for sending the notification since I am already checking whether the job is done so to know if I should retry.

p.s. Something to consider that might help (I am considering it too): If my onStartJob returns true, how does the system know when my job stops running unless it calls onStopJob?

score 8 · Answer 1 · edited Oct 15 '18 at 04:18

Situation:

(1)onStartJob() return false.
(2)System received a cancel request after onStartJob() return false.(For example,invoke jobScheduler.cancelAll(); after onStartJob() return.)
(3)Invoke jobFinished(params,false); soon after onStartJob() return true.
(4)onStartJob() return true and requirements are no longer met.
(5)Call jobScheduler.cancelAll() after onStartJob() return true;

Keeping in mind:
onStopJob() 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().

Explain:
(1)(2)(3)System will not call onStopJob() for you job if you have tell system that you job have done by return false in onStartJob() or by call jobFinished(),because system does not have to.

(4)System will call onStopJob() for you but it will take a long time after requirements are not met,maybe 1min(test on Xiaomi 4c).

(5)System will call onStopJob() for you.

Your question:
(1)how does the system know when my job stops running unless it calls onStopJob? You can call jobFinished() or return false in onStartJob() to let system know that you have finish your job.

(2)Is it guaranteed to be called? It is depends on situations.So it is not right to rely on onStopJob() to determine that job has done.

score 4 · Answer 2 · answered Jul 02 '16 at 11:46

4

According to the document, onStopJob is called when system decides to stop your job forcefully before it finishs. You cannot use this API to fulfill your needs.

I suggest sending a broadcast message as a completion signal when your job finishs.

answered Jul 02 '16 at 11:46

Xavier Lin

328
2
7

score 1 · Answer 3 · answered Feb 19 '20 at 09:29

When u return true in onstartjob()

 public boolean onStartJob(JobParameters jobParameters) {
        Toast.makeText(getApplicationContext(),
               "MyJobService.onStartJob()",
                Toast.LENGTH_SHORT).show();
        Log.d("KRN","KRANTHU: ");
        /*
         * 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.
         */
        return true;
    }

Only then the api will call onstop() function. While when u return false in onstartjob (), it considers that the job is completed and doesnt calls onstopjob().

You question- > how does the system know when my job stops

When the constraint(condition) that u hv set in your jobinfo doesnt meets or the conditions is not meeting anymore than the app knows that the job has stopped.

on Android, is onStopJob always called?

3 Answers3