Skip to content

Most visited

Recently visited

navigation

JobParameters

public class JobParameters
extends Object implements Parcelable

java.lang.Object
   ↳ android.app.job.JobParameters


Contains the parameters used to configure/identify your job. You do not create this object yourself, instead it is handed in to your application by the System.

Summary

Inherited constants

From interface android.os.Parcelable

Fields

public static final Creator<JobParameters> CREATOR

Public methods

void completeWork(JobWorkItem work)

Report the completion of executing a JobWorkItem previously returned by dequeueWork().

JobWorkItem dequeueWork()

Dequeue the next pending JobWorkItem from these JobParameters associated with their currently running job.

int describeContents()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation.

ClipData getClipData()
int getClipGrantFlags()
PersistableBundle getExtras()
int getJobId()
Bundle getTransientExtras()
String[] getTriggeredContentAuthorities()

For jobs with addTriggerContentUri(JobInfo.TriggerContentUri) set, this reports which content authorities have triggered the job.

Uri[] getTriggeredContentUris()

For jobs with addTriggerContentUri(JobInfo.TriggerContentUri) set, this reports which URIs have triggered the job.

boolean isOverrideDeadlineExpired()

For jobs with setOverrideDeadline(long) set, this provides an easy way to tell whether the job is being executed due to the deadline expiring.

void writeToParcel(Parcel dest, int flags)

Flatten this object in to a Parcel.

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Fields

CREATOR

added in API level 21
Creator<JobParameters> CREATOR

Public methods

completeWork

void completeWork (JobWorkItem work)

Report the completion of executing a JobWorkItem previously returned by dequeueWork(). This tells the system you are done with the work associated with that item, so it will not be returned again. Note that if this is the last work in the queue, completing it here will not finish the overall job -- for that to happen, you still need to call dequeueWork() again.

If you are enqueueing work into a job, you must call this method for each piece of work you process. Do not call jobFinished(JobParameters, boolean) or else you can lose work in your queue.

Parameters
work JobWorkItem: The work you have completed processing, as previously returned by dequeueWork()

dequeueWork

JobWorkItem dequeueWork ()

Dequeue the next pending JobWorkItem from these JobParameters associated with their currently running job. Calling this method when there is no more work available and all previously dequeued work has been completed will result in the system taking care of stopping the job for you -- you should not call jobFinished(JobParameters, boolean) yourself (otherwise you risk losing an upcoming JobWorkItem that is being enqueued at the same time).

Once you are done with the JobWorkItem returned by this method, you must call completeWork(JobWorkItem) with it to inform the system that you are done executing the work. The job will not be finished until all dequeued work has been completed. You do not, however, have to complete each returned work item before deqeueing the next one -- you can use dequeueWork() multiple times before completing previous work if you want to process work in parallel, and you can complete the work in whatever order you want.

If the job runs to the end of its available time period before all work has been completed, it will stop as normal. You should return true from onStopJob(JobParameters) in order to have the job rescheduled, and by doing so any pending as well as remaining uncompleted work will be re-queued for the next time the job runs.

Returns
JobWorkItem Returns a new JobWorkItem if there is one pending, otherwise null. If null is returned, the system will also stop the job if all work has also been completed. (This means that for correct operation, you must always call dequeueWork() after you have completed other work, to check either for more work or allow the system to stop the job.)

describeContents

added in API level 21
int describeContents ()

Describe the kinds of special objects contained in this Parcelable instance's marshaled representation. For example, if the object will include a file descriptor in the output of writeToParcel(Parcel, int), the return value of this method must include the CONTENTS_FILE_DESCRIPTOR bit.

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getClipData

ClipData getClipData ()

Returns
ClipData The clip you passed in when constructing this job with setClipData(ClipData, int). Will be null if it was not set.

getClipGrantFlags

int getClipGrantFlags ()

Returns
int The clip grant flags you passed in when constructing this job with setClipData(ClipData, int). Will be 0 if it was not set.

getExtras

added in API level 21
PersistableBundle getExtras ()

Returns
PersistableBundle The extras you passed in when constructing this job with setExtras(android.os.PersistableBundle). This will never be null. If you did not set any extras this will be an empty bundle.

getJobId

added in API level 21
int getJobId ()

Returns
int The unique id of this job, specified at creation time.

getTransientExtras

Bundle getTransientExtras ()

Returns
Bundle The transient extras you passed in when constructing this job with setTransientExtras(android.os.Bundle). This will never be null. If you did not set any extras this will be an empty bundle.

getTriggeredContentAuthorities

added in API level 24
String[] getTriggeredContentAuthorities ()

For jobs with addTriggerContentUri(JobInfo.TriggerContentUri) set, this reports which content authorities have triggered the job. It will only be null if no authorities have triggered it -- that is, the job executed for some other reason, such as a deadline expiring. If this is non-null, you can use getTriggeredContentUris() to retrieve the details of which URIs changed (as long as that has not exceeded the maximum number it can reported).

Returns
String[]

getTriggeredContentUris

added in API level 24
Uri[] getTriggeredContentUris ()

For jobs with addTriggerContentUri(JobInfo.TriggerContentUri) set, this reports which URIs have triggered the job. This will be null if either no URIs have triggered it (it went off due to a deadline or other reason), or the number of changed URIs is too large to report. Whether or not the number of URIs is too large, you can always use getTriggeredContentAuthorities() to determine whether the job was triggered due to any content changes and the authorities they are associated with.

Returns
Uri[]

isOverrideDeadlineExpired

added in API level 21
boolean isOverrideDeadlineExpired ()

For jobs with setOverrideDeadline(long) set, this provides an easy way to tell whether the job is being executed due to the deadline expiring. Note: If the job is running because its deadline expired, it implies that its constraints will not be met.

Returns
boolean

writeToParcel

added in API level 21
void writeToParcel (Parcel dest, 
                int flags)

Flatten this object in to a Parcel.

Parameters
dest Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.