Class Overview
Builder class for constructing OneoffTask
objects.
Summary
[Expand]
Inherited Methods |
From class
com.google.android.gms.gcm.Task.Builder
|
From class
java.lang.Object
Object
|
clone()
|
boolean
|
equals(Object arg0)
|
void
|
finalize()
|
final
Class<?>
|
getClass()
|
int
|
hashCode()
|
final
void
|
notify()
|
final
void
|
notifyAll()
|
String
|
toString()
|
final
void
|
wait(long arg0, int arg1)
|
final
void
|
wait(long arg0)
|
final
void
|
wait()
|
|
Public Constructors
public
OneoffTask.Builder
()
Public Methods
public
OneoffTask.Builder
setExecutionWindow
(long windowStartDelaySeconds, long windowEndDelaySeconds)
Mandatory setter for creating a one-off task. You specify the earliest point in time in the
future from which your task might start executing, as well as the latest point in time in the
future at which your task must have executed.
Parameters |
windowStartDelaySeconds |
long : Earliest point from which your task is eligible to run. |
windowEndDelaySeconds |
long : Latest point at which your task must be run.
|
Optional setter for specifying any extra parameters necessary for the task.
public
OneoffTask.Builder
setPersisted
(boolean isPersisted)
Optional setter to specify whether this task should be persisted across reboots. Defaults to
false. Callers must hold the permission
android.Manifest.permission.RECEIVE_BOOT_COMPLETED, otherwise this setting is ignored.
Parameters |
isPersisted |
boolean : True if this task should be persisted across device reboots.
|
public
OneoffTask.Builder
setRequiredNetwork
(int requiredNetworkState)
Set the network state your task requires to run. If the specified network is
unavailable your task will not be executed until it becomes available. The default
for either a periodic or one-off task is NETWORK_STATE_CONNECTED
. Note that
changing this to NETWORK_STATE_ANY
means there is no guarantee that data will be
available when your task executes. In addition, the only guarantee for connectivity is at the
moment of execution - it is possible for the device to lose data shortly after your task
begins executing.
Parameters |
requiredNetworkState |
int |
public
OneoffTask.Builder
setRequiresCharging
(boolean requiresCharging)
Set whether your task requires that the device be connected to power in order to execute. Use
this to defer nonessential operations whenever possible. Note that if you set this field and
the device is not connected to power your task will not run until the device
is plugged in. One way to deal with your task not executing until the constraint is met is to
schedule another task without the constraints that is subject to some deadline that you can
abide. This task would be responsible for executing your fallback logic.
Parameters |
requiresCharging |
boolean |
Set whichever GcmTaskService
you implement to execute the logic for this task.
Parameters |
gcmTaskService |
Class : Endpoint against which you're scheduling this task.
|
Mandatory setter for specifying the tag identifier for this task. This tag will be returned
at execution time to your endpoint. See onRunTask(com.google.android.gms.gcm.TaskParams)
Maximum tag length is 100.
Parameters |
tag |
String : String identifier for this task. Consecutive schedule calls for the same tag will
update any preexisting task with the same tag. |
public
OneoffTask.Builder
setUpdateCurrent
(boolean updateCurrent)
Optional setter to specify whether this task should override any preexisting tasks with the
same tag. This defaults to false, which means if a task with the same tag and service is
already present then the new task will be dropped instead of replacing the previous task.
Parameters |
updateCurrent |
boolean : True to update the current task with the parameters of the new. Default
false.
|
Protected Methods
protected
void
checkConditions
()