Android随笔-IntentService详解（了解）

一、IntentService 是什么

IntentService 是 Android 提供的一个Service 子类 ，专门用于处理异步的、一次性的后台任务。它在 Service 的基础上封装了工作线程和消息队列，简化了后台任务的实现。

核心特点：

• 自带工作线程 ：内部通过 HandlerThread 创建了一个独立的工作线程
• 任务队列 ：所有通过 startService() 发送的 Intent 会被放入队列，串行执行
• 自动停止 ：当队列中所有任务处理完毕后，Service 自动调用 stopSelf()
• 无需手动管理线程 ：开发者只需重写 onHandleIntent() 方法即可

---

二、原理分析

核心源码结构

public abstract class IntentService extends Service {

    private volatile Looper mServiceLooper;
    private volatile ServiceHandler mServiceHandler;
    private String mName;
    private boolean mRedelivery;

    // 内部 Handler，绑定到工作线程的 Looper
    private final class ServiceHandler extends Handler {
        public ServiceHandler(Looper looper) {
            super(looper);
        }

        @Override
        public void handleMessage(Message msg) {
            // 在工作线程中执行
            onHandleIntent((Intent) msg.obj);
            // 任务完成后，检查是否还有任务，没有则停止
            stopSelf(msg.arg1);
        }
    }

    @Override
    public void onCreate() {
        super.onCreate();
        // 1. 创建 HandlerThread（带 Looper 的工作线程）
        HandlerThread thread = new HandlerThread("IntentService[" + mName + "]");
        thread.start();

        // 2. 获取工作线程的 Looper
        mServiceLooper = thread.getLooper();

        // 3. 创建绑定到该 Looper 的 Handler
        mServiceHandler = new ServiceHandler(mServiceLooper);
    }

    @Override
    public void onStart(@Nullable Intent intent, int startId) {
        // 4. 将 Intent 发送到 Handler 的消息队列
        Message msg = mServiceHandler.obtainMessage();
        msg.arg1 = startId;  // startId 用于精确停止
        msg.obj = intent;
        mServiceHandler.sendMessage(msg);
    }

    @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() {
        // 5. 销毁时退出 Looper
        mServiceLooper.quit();
    }

    @Override
    public IBinder onBind(Intent intent) {
        return null; // 不支持绑定
    }

    // 子类只需重写此方法，在子线程中执行耗时操作
    @WorkerThread
    protected abstract void onHandleIntent(@Nullable Intent intent);
}

原理流程图

startService(intent)
    ↓
onCreate() → 创建 HandlerThread + Looper + ServiceHandler
    ↓
onStartCommand() → onStart()
    ↓
mServiceHandler.sendMessage(msg) → 消息进入队列
    ↓
Looper.loop() → 取出消息
    ↓
handleMessage() → onHandleIntent(intent) [工作线程]
    ↓
任务完成 → stopSelf(startId) [检查是否还有未处理消息]
    ↓
所有任务完成 → onDestroy() → mServiceLooper.quit()

---

三、与 Service 的区别与联系

特性	IntentService	普通 Service
线程	自带工作线程（HandlerThread）	默认在主线程运行
任务执行	串行队列，一个接一个执行	需要自己实现线程管理
自动停止	任务完成后自动 stopSelf()	需要手动 stopService()
绑定支持	不支持 bindService()（onBind 返回 null）	支持 bindService()
并发能力	串行执行，不适合高并发	可自定义线程池实现并发
使用复杂度	简单，只需重写 onHandleIntent()	复杂，需自行处理线程和生命周期
继承关系	继承自 Service	基类
状态	Android 11 (API 30) 已废弃	正常使用
替代方案	WorkManager / JobIntentService	Service + 协程/线程池

---

四、应用场景

1. 一次性后台任务（最典型）

// 下载文件、上传图片、同步数据等
Intent intent = new Intent(context, DownloadIntentService.class);
intent.putExtra("url", "https://example.com/file.zip");
startService(intent);

2. 不需要与 UI 交互的任务

// 数据库清理、日志上传、缓存清理
Intent intent = new Intent(context, CleanupIntentService.class);
startService(intent);
// 完成后自动停止，无需关心

3. 串行执行的任务队列

// 批量图片压缩，一张接一张处理
for (String path : imagePaths) {
    Intent intent = new Intent(context, CompressIntentService.class);
    intent.putExtra("path", path);
    startService(intent);
}
// 所有任务按顺序执行，不会并发导致内存溢出

---

五、使用示例

完整代码示例

public class DownloadIntentService extends IntentService {

    private static final String TAG = "DownloadIntentService";

    // 必须提供无参构造，传入工作线程名称
    public DownloadIntentService() {
        super("DownloadIntentService");
    }

    @Override
    protected void onHandleIntent(@Nullable Intent intent) {
        if (intent == null) return;

        String url = intent.getStringExtra("url");
        String fileName = intent.getStringExtra("fileName");

        // 此方法运行在工作线程，可执行耗时操作
        try {
            downloadFile(url, fileName);
            // 下载完成后，如果需要通知 UI，发送广播或使用 LocalBroadcastManager
            sendDownloadCompleteBroadcast(fileName, true);
        } catch (IOException e) {
            Log.e(TAG, "Download failed", e);
            sendDownloadCompleteBroadcast(fileName, false);
        }
    }

    private void downloadFile(String url, String fileName) throws IOException {
        // 模拟下载逻辑
        URL downloadUrl = new URL(url);
        HttpURLConnection connection = (HttpURLConnection) downloadUrl.openConnection();
        // ... 下载逻辑
    }

    private void sendDownloadCompleteBroadcast(String fileName, boolean success) {
        Intent broadcast = new Intent("com.example.DOWNLOAD_COMPLETE");
        broadcast.putExtra("fileName", fileName);
        broadcast.putExtra("success", success);
        LocalBroadcastManager.getInstance(this).sendBroadcast(broadcast);
    }
}

// Activity 中启动
public class MainActivity extends AppCompatActivity {

    public void startDownload(String url, String fileName) {
        Intent intent = new Intent(this, DownloadIntentService.class);
        intent.putExtra("url", url);
        intent.putExtra("fileName", fileName);
        startService(intent);
    }
}

---

六、注意事项

1. 已废弃（最重要）

// ⚠️ Android 11 (API 30) 起 IntentService 已废弃
// 官方推荐替代方案：WorkManager

// ✅ 现代替代方案：WorkManager（Kotlin）
val downloadWork = OneTimeWorkRequestBuilder<DownloadWorker>()
    .setInputData(workDataOf(
        "url" to "https://example.com/file.zip",
        "fileName" to "file.zip"
    ))
    .build()

WorkManager.getInstance(context).enqueue(downloadWork)

// ✅ 现代替代方案：WorkManager（Java）
OneTimeWorkRequest downloadWork = 
    new OneTimeWorkRequest.Builder(DownloadWorker.class)
        .setInputData(new Data.Builder()
            .putString("url", "https://example.com/file.zip")
            .putString("fileName", "file.zip")
            .build())
        .build();

WorkManager.getInstance(context).enqueue(downloadWork);

2. 不支持 bindService

// ❌ 错误：尝试绑定 IntentService
bindService(intent, connection, Context.BIND_AUTO_CREATE);
// 结果：onBind() 返回 null，无法建立连接

如果需要双向通信，必须使用普通 Service + Binder，或改用 WorkManager + LiveData 观察结果。

3. 串行执行，不适合并发

// ⚠️ 注意：IntentService 是单线程队列，任务串行执行
// 如果同时启动 10 个下载任务，它们会排队执行，不会并发

// 如果需要并发，使用线程池：
ExecutorService executor = Executors.newFixedThreadPool(4);

4. 任务完成后自动停止

// ⚠️ 注意：IntentService 会在所有任务完成后自动 stopSelf()
// 不要手动调用 stopService()，可能导致正在执行的任务被中断

5. 无法直接更新 UI

// ❌ 错误：在 onHandleIntent 中直接操作 UI
@Override
protected void onHandleIntent(Intent intent) {
    // 工作线程，不能操作 UI
    textView.setText("Downloaded"); // 崩溃！
}

// ✅ 正确：通过广播、EventBus 或 LiveData 通知 UI
@Override
protected void onHandleIntent(Intent intent) {
    // 工作线程执行任务
    downloadFile();

    // 通过广播通知 UI
    Intent broadcast = new Intent("ACTION_DOWNLOAD_COMPLETE");
    LocalBroadcastManager.getInstance(this).sendBroadcast(broadcast);
}

6. 异常处理

@Override
protected void onHandleIntent(Intent intent) {
    try {
        // 耗时操作
        processTask();
    } catch (Exception e) {
        // 必须捕获异常，否则可能导致 Service 异常退出
        Log.e(TAG, "Task failed", e);
    }
}

7. 与前台服务结合

// ⚠️ Android 8.0+ 后台启动限制
// IntentService 默认是后台服务，在后台启动可能被限制

// 如果需要保证执行，考虑使用 JobIntentService（也已废弃）
// 或 ForegroundService + 手动线程管理

---

七、总结

问题	答案
IntentService 是什么？	Service 的子类，封装了工作线程和任务队列
核心原理？	HandlerThread + Looper + Handler，串行处理 Intent
与 Service 区别？	自带工作线程、自动停止、不支持绑定、串行执行
适用场景？	一次性后台任务（下载、上传、清理）
现代替代方案？	WorkManager（官方推荐）
注意事项？	已废弃、不支持绑定、串行执行、不能操作 UI

一句话总结 ：IntentService 是 Android 早期提供的"开箱即用"后台任务解决方案，它简化了 Service + 线程的样板代码，但由于功能局限（串行、不支持绑定、无约束执行），Android 11 已废弃，新项目请直接使用 WorkManager。