added in version 26.1.0
belongs to Maven artifact com.android.support:support-compat:28.0.0-alpha1

Summary: Inherited Constants | Ctors | Methods | Protected Methods | Inherited Methods | [Expand All]

JobIntentService

This package is part of the Android support library which is no longer maintained. The support library has been superseded by AndroidX which is part of Jetpack. We recommend using the AndroidX libraries in all new projects. You should also consider migrating existing projects to AndroidX. To find the AndroidX class that maps to this deprecated class, see the AndroidX support library class mappings.

public abstract class JobIntentService
extends Service

java.lang.Object
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	android.support.v4.app.JobIntentService

---

Helper for processing work that has been enqueued for a job/service. When running on Android O or later, the work will be dispatched as a job via JobScheduler.enqueue. When running on older versions of the platform, it will use Context.startService.

You must publish your subclass in your manifest for the system to interact with. This should be published as a JobService, as described for that class, since on O and later platforms it will be executed that way.

Use enqueueWork(Context, Class, int, Intent) to enqueue new work to be dispatched to and handled by your service. It will be executed in onHandleWork(Intent).

You do not need to use WakefulBroadcastReceiver when using this class. When running on Android O, the JobScheduler will take care of wake locks for you (holding a wake lock from the time you enqueue work until the job has been dispatched and while it is running). When running on previous versions of the platform, this wake lock handling is emulated in the class here by directly calling the PowerManager; this means the application must request the WAKE_LOCK permission.

There are a few important differences in behavior when running on Android O or later as a Job vs. pre-O:

• When running as a pre-O service, the act of enqueueing work will generally start the service immediately, regardless of whether the device is dozing or in other conditions. When running as a Job, it will be subject to standard JobScheduler policies for a Job with a setOverrideDeadline(long) of 0: the job will not run while the device is dozing, it may get delayed more than a service if the device is under strong memory pressure with lots of demand to run jobs.

• When running as a pre-O service, the normal service execution semantics apply: the service can run indefinitely, though the longer it runs the more likely the system will be to outright kill its process, and under memory pressure one should expect the process to be killed even of recently started services. When running as a Job, the typical JobService execution time limit will apply, after which the job will be stopped (cleanly, not by killing the process) and rescheduled to continue its execution later. Job are generally not killed when the system is under memory pressure, since the number of concurrent jobs is adjusted based on the memory state of the device.

Here is an example implementation of this class:

import android.content.Context;
import android.content.Intent;
import android.os.Handler;
import android.os.SystemClock;
import android.support.v4.app.JobIntentService;
import android.util.Log;
import android.widget.Toast;

/**
 * Example implementation of a JobIntentService.
 */
public class SimpleJobIntentService extends JobIntentService {
    /**
     * Unique job ID for this service.
     */
    static final int JOB_ID = 1000;

    /**
     * Convenience method for enqueuing work in to this service.
     */
    static void enqueueWork(Context context, Intent work) {
        enqueueWork(context, SimpleJobIntentService.class, JOB_ID, work);
    }

    @Override
    protected void onHandleWork(Intent intent) {
        // We have received work to do.  The system or framework is already
        // holding a wake lock for us at this point, so we can just go.
        Log.i("SimpleJobIntentService", "Executing work: " + intent);
        String label = intent.getStringExtra("label");
        if (label == null) {
            label = intent.toString();
        }
        toast("Executing: " + label);
        for (int i = 0; i < 5; i++) {
            Log.i("SimpleJobIntentService", "Running service " + (i + 1)
                    + "/5 @ " + SystemClock.elapsedRealtime());
            try {
                Thread.sleep(1000);
            } catch (InterruptedException e) {
            }
        }
        Log.i("SimpleJobIntentService", "Completed service @ " + SystemClock.elapsedRealtime());
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        toast("All work complete");
    }

    final Handler mHandler = new Handler();

    // Helper for showing tests
    void toast(final CharSequence text) {
        mHandler.post(new Runnable() {
            @Override public void run() {
                Toast.makeText(SimpleJobIntentService.this, text, Toast.LENGTH_SHORT).show();
            }
        });
    }
}

Summary

Inherited constants
From class android.app.Service int START_CONTINUATION_MASK int START_FLAG_REDELIVERY int START_FLAG_RETRY int START_NOT_STICKY int START_REDELIVER_INTENT int START_STICKY int START_STICKY_COMPATIBILITY int STOP_FOREGROUND_DETACH int STOP_FOREGROUND_REMOVE
From class android.content.Context String ACCESSIBILITY_SERVICE String ACCOUNT_SERVICE String ACTIVITY_SERVICE String ALARM_SERVICE String APPWIDGET_SERVICE String APP_OPS_SERVICE String AUDIO_SERVICE String BATTERY_SERVICE int BIND_ABOVE_CLIENT int BIND_ADJUST_WITH_ACTIVITY int BIND_ALLOW_OOM_MANAGEMENT int BIND_AUTO_CREATE int BIND_DEBUG_UNBIND int BIND_EXTERNAL_SERVICE int BIND_IMPORTANT int BIND_NOT_FOREGROUND int BIND_WAIVE_PRIORITY String BLUETOOTH_SERVICE String CAMERA_SERVICE String CAPTIONING_SERVICE String CARRIER_CONFIG_SERVICE String CLIPBOARD_SERVICE String COMPANION_DEVICE_SERVICE String CONNECTIVITY_SERVICE String CONSUMER_IR_SERVICE int CONTEXT_IGNORE_SECURITY int CONTEXT_INCLUDE_CODE int CONTEXT_RESTRICTED String CROSS_PROFILE_APPS_SERVICE String DEVICE_POLICY_SERVICE String DISPLAY_SERVICE String DOWNLOAD_SERVICE String DROPBOX_SERVICE String FINGERPRINT_SERVICE String HARDWARE_PROPERTIES_SERVICE String INPUT_METHOD_SERVICE String INPUT_SERVICE String IPSEC_SERVICE String JOB_SCHEDULER_SERVICE String KEYGUARD_SERVICE String LAUNCHER_APPS_SERVICE String LAYOUT_INFLATER_SERVICE String LOCATION_SERVICE String MEDIA_PROJECTION_SERVICE String MEDIA_ROUTER_SERVICE String MEDIA_SESSION_SERVICE String MIDI_SERVICE int MODE_APPEND int MODE_ENABLE_WRITE_AHEAD_LOGGING int MODE_MULTI_PROCESS int MODE_NO_LOCALIZED_COLLATORS int MODE_PRIVATE int MODE_WORLD_READABLE int MODE_WORLD_WRITEABLE String NETWORK_STATS_SERVICE String NFC_SERVICE String NOTIFICATION_SERVICE String NSD_SERVICE String POWER_SERVICE String PRINT_SERVICE int RECEIVER_VISIBLE_TO_INSTANT_APPS String RESTRICTIONS_SERVICE String SEARCH_SERVICE String SENSOR_SERVICE String SHORTCUT_SERVICE String STORAGE_SERVICE String STORAGE_STATS_SERVICE String SYSTEM_HEALTH_SERVICE String TELECOM_SERVICE String TELEPHONY_SERVICE String TELEPHONY_SUBSCRIPTION_SERVICE String TEXT_CLASSIFICATION_SERVICE String TEXT_SERVICES_MANAGER_SERVICE String TV_INPUT_SERVICE String UI_MODE_SERVICE String USAGE_STATS_SERVICE String USB_SERVICE String USER_SERVICE String VIBRATOR_SERVICE String WALLPAPER_SERVICE String WIFI_AWARE_SERVICE String WIFI_P2P_SERVICE String WIFI_RTT_RANGING_SERVICE String WIFI_SERVICE String WINDOW_SERVICE
From interface android.content.ComponentCallbacks2 int TRIM_MEMORY_BACKGROUND int TRIM_MEMORY_COMPLETE int TRIM_MEMORY_MODERATE int TRIM_MEMORY_RUNNING_CRITICAL int TRIM_MEMORY_RUNNING_LOW int TRIM_MEMORY_RUNNING_MODERATE int TRIM_MEMORY_UI_HIDDEN

Public constructors
JobIntentService() Default empty constructor.

Public methods
static void	enqueueWork(Context context, ComponentName component, int jobId, Intent work) Like enqueueWork(Context, Class, int, Intent), but supplies a ComponentName for the service to interact with instead of its class.
static void	enqueueWork(Context context, Class cls, int jobId, Intent work) Call this to enqueue work for your subclass of JobIntentService.
boolean	isStopped() Returns true if onStopCurrentWork() has been called.
IBinder	onBind(Intent intent) Returns the IBinder for the JobServiceEngine when running as a JobService on O and later platforms.
void	onCreate()
void	onDestroy()
int	onStartCommand(Intent intent, int flags, int startId) Processes start commands when running as a pre-O service, enqueueing them to be later dispatched in onHandleWork(Intent).
boolean	onStopCurrentWork() This will be called if the JobScheduler has decided to stop this job.
void	setInterruptIfStopped(boolean interruptIfStopped) Control whether code executing in onHandleWork(Intent) will be interrupted if the job is stopped.

Protected methods
abstract void	onHandleWork(Intent intent) Called serially for each work dispatched to and processed by the service.

Inherited methods