个人学习笔记，未经允许，不得转载，谢谢~
一、定义
IntentService 是Service的子类，用于处理后台异步请求任务。由于Service在主线程，不能进行耗时操作，因此Google提供了IntentService，内部维护了一个子线程来进行操作。用户通过调用 Context.startService(Intent) 发送请求，Service根据请求启动，在IntentService内维护了一个工作线程来处理耗时操作，当任务执行完后，IntentService会自动停止。
所有的请求都在同一个工作线程上处理，一次处理一个请求，所以处理完所有的请求可能会花费很长的时间，但由于 IntentService 是另外创建子线程来工作，所以不会阻碍主线程，防止出现ANR。
使用场景：可以用来处理后台长时间的耗时操作，如：文件下载、音乐播放。
IntentService已经在Android API 30弃用（对应Android 11）：在Android 8.0增加了Background execution limits，而IntentService受其影响，所以可以考虑使用WorkManager或JobIntentService。
二、IntentService的使用
以下demo通过IntentService实现在后台循环播放音乐。
2个步骤
setp1
创建IntentService的子类，实现onHandleIntent()等方法，并在清单文件中注册
//创建IntentService的子类
public class MusicPlayerService extends IntentService {
private static final String ACTION_PLAY_MUSIC = "com.wanda.servicedemo.action.PLAY_MUSIC";
private static final String TAG = MusicPlayerService.class.getSimpleName();
private MediaPlayer mMediaPlayer;
public MusicPlayerService() {
super("MusicPlayerService");
}
public static void startPlayer(Context context) {
Log.i(TAG, "startPlayer");
Intent intent = new Intent(context, MusicPlayerService.class);
intent.setAction(ACTION_PLAY_MUSIC);
context.startService(intent);
}
@Override
protected void onHandleIntent(Intent intent) {
if (intent != null) {
final String action = intent.getAction();
Log.i(TAG, "onHandleIntent: action = " + action);
if (ACTION_PLAY_MUSIC.equals(action)) {
handleActionPlayMusic();
}
}
}
private void handleActionPlayMusic() {
boolean isMainThread = Looper.getMainLooper().getThread() == Thread.currentThread();
//打印handle此任务的出当前线程名
Log.i(TAG, "handleActionPlayMusic： Current Thread is " +
Thread.currentThread().getName() +
" , is MainThread: " + isMainThread);
if (mMediaPlayer == null) {
mMediaPlayer = MediaPlayer.create(this, R.raw.record);
mMediaPlayer.setLooping(true);
mMediaPlayer.start();
}
}
@Override
public void onCreate() {
Log.i(TAG, "onCreate");
super.onCreate();
}
@Override
public int onStartCommand(@Nullable Intent intent, int flags, int startId) {
Log.i(TAG, "onStartCommand");
return super.onStartCommand(intent, flags, startId);
}
@Override
public void onStart(@Nullable Intent intent, int startId) {
Log.i(TAG, "onStart");
super.onStart(intent, startId);
}
@Override
public void onDestroy() {
Log.i(TAG, "onDestroy");
super.onDestroy();
}
}
并在清单文件中注册：
<service
android:name=".MusicPlayerService"
android:exported="false"></service>
setp2
在 Activity 中通过调用 startService(Intent) 方法发送任务请求
//在Activity添加Button启动IntentService（仅展示部分代码）
case R.id.startIntentService:
Log.i(TAG, "onClick: startIntentService");
MusicPlayerService.startPlayer(this);
break;
图8
从图8日志中可以看出，IntentService在执行完任务后就会自行销毁执行onDestroy()。
三、IntentService源码分析
虽然IntentService已经在Android API 30弃用，但是我们还是需要学习其原理。在分析IntentService源码前，需要提前学习Handler相关知识，这可以使我们对IntentService理解得更透彻。如果你已经学习过了Handler，那接下来可以跟我一起分析源码啦。
先看看IntentService类import了什么：
import android.annotation.Nullable;
//WorkerThread注解：表示只能在WorkThread上调用被该注解标记的方法，也就是标记@WorkThread的方法只能在子线程上运行。如果被该注解标记的元素是一个类，那么类中的所有方法都应该在WorkThread上调用。
import android.annotation.WorkerThread;
//UnsupportedAppUsage注解：简单理解为不支持外部应用使用被此注释声明的变量或方法等。
import android.compat.annotation.UnsupportedAppUsage;
import android.content.Intent;
//引入Hnadler说明在IntentService内部的工作方式和Handler息息相关
import android.os.Handler;
import android.os.HandlerThread;
import android.os.IBinder;
import android.os.Looper;
import android.os.Message;
接下来看看IntentService是怎么具体实现的吧：
//注解Deprecated表示IntentService被弃用。实际上IntentService在Android API 30（Android 11）被弃用，因为IntentService受Android 8.0推出的后台执行限制所影响。
@Deprecated
public abstract class IntentService extends Service {
private volatile Looper mServiceLooper;
@UnsupportedAppUsage
private volatile ServiceHandler mServiceHandler;
private String mName;
private boolean mRedelivery;
//创建了一个内部类，继承自Handler
private final class ServiceHandler extends Handler {
public ServiceHandler(Looper looper) {
super(looper);
}
@Override
public void handleMessage(Message msg) {
//处理我们重写的该方
onHandleIntent((Intent)msg.obj)
//当执行完任务后，Service就销毁
stopSelf(msg.arg1);
}
}
/**
* 构造函数
*
* @param name 用于命名所在的工作线程名称
*/
public IntentService(String name) {
super();
mName = name;
}
/**
* 设置Intent是否重传，通常在构造函数中调用。
*
* 当enabled为true，onStartCommand(Intent,int,int)将返回START_REDELIVER_ INTENT，
* 且如果在onHandleIntent(Intent)返回前，进程就终止了，则进程将重启并重传intent。
* 当enabled为false(默认)，onStartCommand(Intent,int,int)将返回START_NOT_STICKY，
* 如果进程终止，Intent也随之终止。
*
*/
public void setIntentRedelivery(boolean enabled) {
mRedelivery = enabled;
}
@Override
public void onCreate() {
super.onCreate();
//HandlerThread就是一个带有Handler的Thread，这里就是创建了一个线程
HandlerThread thread = new HandlerThread("IntentService[" + mName + "]");
thread.start();
//获取这个线程的Looper
mServiceLooper = thread.getLooper();
//创建了一个Handler，并给Handler指定了thread的looper，说明此Handler将执行此子线程上的任务
mServiceHandler = new ServiceHandler(mServiceLooper);
}
//将关于Intent的消息发送到队列中给Handler处理
@Override
public void onStart(@Nullable Intent intent, int startId) {
Message msg = mServiceHandler.obtainMessage();
msg.arg1 = startId;
msg.obj = intent;
mServiceHandler.sendMessage(msg);
}
//IntentService中不需要重写该方法
@Override
public int onStartCommand(@Nullable Intent intent, int flags, int startId) {
onStart(intent, startId);
return mRedelivery ? START_REDELIVER_INTENT : START_NOT_STICKY;
}
@Override
public void onDestroy() {
mServiceLooper.quit();
}
@Override
@Nullable
public IBinder onBind(Intent intent) {
return null;
}
@WorkerThread
protected abstract void onHandleIntent(@Nullable Intent intent);
}
总结：
- 在 onCreate() 方法中，新建了一个 HandlerThread 对象(thread)，并用HandlerThread创建的Looper创建了一个Handler对象(mServiceHanlder)，使mServiceHanlder和thread的Looper相关联；
- 在 onStart() 方法中，将 Intent指定到Message，发送给 mServiceHandler，此Intent就是我们通过 startService(Intent) 传入的 Intent。
- mServiceHanlder 接收到任务请求，调用 onHandleIntent() 方法处理任务请求，处理完所有请求后，调用 stopSelf() 销毁IntentService。
