Merge "Expand JS documentation." into sc-dev am: 9c3d74f7e0 am: a69ed8d4cc (883dc6fa) · Commits · e / os / android_frameworks_base

apex/jobscheduler/framework/java/android/app/job/JobInfo.java

+10 −4

Original line number	Original line	Diff line number	Diff line
	@@ -1433,7 +1433,10 @@ public class JobInfo implements Parcelable {
	}		}

	/**		/**
	* Specify that this job should be delayed by the provided amount of time.		* Specify that this job should be delayed by the provided amount of time. The job may not
			* run the instant the delay has elapsed. JobScheduler will start the job at an
			* indeterminate time after the delay has elapsed.
			* <p>
	* Because it doesn't make sense setting this property on a periodic job, doing so will		* Because it doesn't make sense setting this property on a periodic job, doing so will
	* throw an {@link java.lang.IllegalArgumentException} when		* throw an {@link java.lang.IllegalArgumentException} when
	* {@link android.app.job.JobInfo.Builder#build()} is called.		* {@link android.app.job.JobInfo.Builder#build()} is called.
	@@ -1449,9 +1452,11 @@ public class JobInfo implements Parcelable {

	/**		/**
	* Set deadline which is the maximum scheduling latency. The job will be run by this		* Set deadline which is the maximum scheduling latency. The job will be run by this
	* deadline even if other requirements are not met. Because it doesn't make sense setting		* deadline even if other requirements (including a delay set through
	* this property on a periodic job, doing so will throw an		* {@link #setMinimumLatency(long)}) are not met.
	* {@link java.lang.IllegalArgumentException} when		* <p>
			* Because it doesn't make sense setting this property on a periodic job, doing so will
			* throw an {@link java.lang.IllegalArgumentException} when
	* {@link android.app.job.JobInfo.Builder#build()} is called.		* {@link android.app.job.JobInfo.Builder#build()} is called.
	* @see JobInfo#getMaxExecutionDelayMillis()		* @see JobInfo#getMaxExecutionDelayMillis()
	*/		*/
	@@ -1465,6 +1470,7 @@ public class JobInfo implements Parcelable {
	* Set up the back-off/retry policy.		* Set up the back-off/retry policy.
	* This defaults to some respectable values: {30 seconds, Exponential}. We cap back-off at		* This defaults to some respectable values: {30 seconds, Exponential}. We cap back-off at
	* 5hrs.		* 5hrs.
			* <p>
	* Note that trying to set a backoff criteria for a job with		* Note that trying to set a backoff criteria for a job with
	* {@link #setRequiresDeviceIdle(boolean)} will throw an exception when you call build().		* {@link #setRequiresDeviceIdle(boolean)} will throw an exception when you call build().
	* This is because back-off typically does not make sense for these types of jobs. See		* This is because back-off typically does not make sense for these types of jobs. See

apex/jobscheduler/framework/java/android/app/job/JobService.java

+4 −0

Original line number	Original line	Diff line number	Diff line
	@@ -153,6 +153,10 @@ public abstract class JobService extends Service {
	* Once this method returns (or times out), the system releases the wakelock that it is holding		* Once this method returns (or times out), the system releases the wakelock that it is holding
	* on behalf of the job.</p>		* on behalf of the job.</p>
	*		*
			* <p class="caution"><strong>Note:</strong> When a job is stopped and rescheduled via this
			* method call, the deadline constraint is excluded from the rescheduled job's constraint set.
			* The rescheduled job will run again once all remaining constraints are satisfied.
			*
	* @param params The parameters identifying this job, similar to what was supplied to the job in		* @param params The parameters identifying this job, similar to what was supplied to the job in
	* the {@link #onStartJob(JobParameters)} callback, but with the stop reason		* the {@link #onStartJob(JobParameters)} callback, but with the stop reason
	* included.		* included.