原生移动开发 / 系统课时

串联存在依赖的后台任务

串联存在依赖的后台任务

当后台工作不是“各跑各的”,而是必须先完成上传、再处理结果、最后清理本地数据时,需要明确表达阶段依赖。本篇使用 WorkContinuation 串联多个 Worker,并通过 Data 把前一阶段的结果安全传给下一阶段。

学习目标

  • 理解 WorkContinuation 如何表达顺序、分支与汇合关系
  • 使用 then 串联有依赖的 OneTimeWorkRequest
  • 使用 Data 在 Worker 之间传递有限、可序列化的结果

用 WorkContinuation 表达任务依赖

WorkContinuation 可以把多个一次性任务组织成一条执行链。最常见的方式是先用 beginWith() 创建起点,再用 then() 添加后续任务。这样定义的不是简单的代码调用顺序,而是 WorkManager 保存下来的任务依赖关系。

例如,一个离线同步流程可以拆成“上传文件 → 处理服务端结果 → 删除本地临时文件”三个阶段。只有前一步成功,后一步才应继续执行。

WorkManager 多阶段任务依赖与数据传递

串联 Worker 并传递结果

下面的示例使用三个 Worker。第一个生成一个任务标识,第二个读取该标识并处理,第三个根据处理状态执行清理。为了让示例可直接运行,三个 Worker 均采用 CoroutineWorker。

kotlin
import android.content.Context
import androidx.work.CoroutineWorker
import androidx.work.Data
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.WorkManager
import androidx.work.WorkerParameters

class UploadWorker(
    appContext: Context,
    params: WorkerParameters
) : CoroutineWorker(appContext, params) {
    override suspend fun doWork(): Result {
        val uploadId = "upload-<ID>"
        return Result.success(
            Data.Builder()
                .putString("uploadId", uploadId)
                .build()
        )
    }
}

class ProcessWorker(
    appContext: Context,
    params: WorkerParameters
) : CoroutineWorker(appContext, params) {
    override suspend fun doWork(): Result {
        val uploadId = inputData.getString("uploadId")
            ?: return Result.failure()

        val status = "processed:$uploadId"
        return Result.success(
            Data.Builder()
                .putString("status", status)
                .build()
        )
    }
}

class CleanupWorker(
    appContext: Context,
    params: WorkerParameters
) : CoroutineWorker(appContext, params) {
    override suspend fun doWork(): Result {
        val status = inputData.getString("status")
            ?: return Result.failure()

        println("cleanup status=$status")
        return Result.success()
    }
}

fun enqueueChain(context: Context) {
    val upload = OneTimeWorkRequestBuilder<UploadWorker>().build()
    val process = OneTimeWorkRequestBuilder<ProcessWorker>().build()
    val cleanup = OneTimeWorkRequestBuilder<CleanupWorker>().build()

    WorkManager.getInstance(context)
        .beginWith(upload)
        .then(process)
        .then(cleanup)
        .enqueue()
}

预期结果:

text
cleanup status=processed:upload-<ID>

这里需要注意一个关键点:Result.success(Data) 会把输出数据写入前一个 Worker 的 outputData,但后续 Worker 不会因为使用 then() 就自动拥有这些字段。要把前置输出合并为后续输入,应使用 WorkContinuation 的输入合并能力,例如在链开始时指定 InputMerger,或者显式设计任务之间的数据衔接方式。

在简单的一对一依赖中,也可以直接让后续任务读取经过输入合并后的字段。对于并行任务汇合,则更值得关注 ArrayCreatingInputMerger 等输入合并策略,因为多个前置 Worker 可能同时产生同名或同类型数据。

多个前置任务如何汇合

当任务存在“并行完成后再继续”的关系时,可以先分别创建两个 WorkContinuation,再使用 WorkContinuation.combine() 汇合,之后通过 then() 继续执行。这个模型适合例如“上传元数据”和“上传文件”都完成后再提交最终确认。

kotlin
import android.content.Context
import androidx.work.OneTimeWorkRequestBuilder
import androidx.work.WorkManager

fun enqueueCombined(context: Context) {
    val metadata = OneTimeWorkRequestBuilder<UploadMetadataWorker>().build()
    val file = OneTimeWorkRequestBuilder<UploadFileWorker>().build()
    val finalize = OneTimeWorkRequestBuilder<FinalizeWorker>().build()

    val workManager = WorkManager.getInstance(context)
    val metadataChain = workManager.beginWith(metadata)
    val fileChain = workManager.beginWith(file)

    WorkContinuation
        .combine(metadataChain, fileChain)
        .then(finalize)
        .enqueue()
}

片段示例:上述代码依赖项目中已经定义 UploadMetadataWorker、UploadFileWorker 和 FinalizeWorker,这里只演示组合关系,不单独提供这些 Worker 的实现。

预期结果:

text
UploadMetadataWorker ─┐
                     ├─> FinalizeWorker
UploadFileWorker ────┘

combine() 表达的是依赖汇合,而不是保证两个 Worker 按固定先后运行。只要业务允许并行,使用这种结构可以避免人为把没有依赖关系的任务串行化。

数据传递的边界

Data 适合传递少量、结构简单的任务元数据,例如字符串、整数、布尔值和有限大小的数组。不要把大文件、数据库记录集或完整二进制内容塞进 Data;后台任务之间应传递文件路径、数据库主键或远端任务 ID,再由下一阶段重新读取真实数据。

还要区分“任务依赖”和“业务成功”。then() 保证后续 Worker 等待前置 Worker 的状态,但你的 Worker 仍需要判断输入是否存在、是否有效,并在临时失败时返回 Result.retry()。这样才能把“依赖已满足”和“业务已经完成”分开处理。

实际项目中,能画成清晰依赖链的后台流程通常更适合拆成多个 Worker;如果几个步骤必须共享复杂的内存状态,则不应强行把所有对象都通过 Data 搬运,而应把共享状态落到持久化存储中。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

串联存在依赖的后台任务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通