工作狀態

工作在整個生命週期中會進行一系列的 State 變更。

一次性工作狀態

如果是 one-time 工作請求,您的工作會以 ENQUEUED 狀態開始。

ENQUEUED 狀態下,工作只要符合 Constraints 和初始延遲時間需求,就能立即執行。此 API 會移至 RUNNING 然後根據實作結果,可能將工作移至 SUCCEEDEDFAILED,或回到 ENQUEUED 如果是 retry 的話。在流程中任何時間點,您都可以取消工作,這時該作業就會移至 CANCELLED 狀態。

圖 1 說明一次性工作的壽命,以及可能讓其他狀態發生的事件。

圖 1. 一次性工作的狀態圖表。

SUCCEEDEDFAILEDCANCELLED 都代表這項工作的終端狀態。如果您的工作處於上述任一狀態,則 WorkInfo.State.isFinished() 會傳回 true。

週期性工作狀態

成功和失敗狀態僅適用於一次性和連鎖工作。對於週期工作而言,只有一項終端態 CANCELLED。這是因為週期工作絕不會結束。無論結果如何,每次結果在執行後都會經過重新排程。圖 2 說明週期工作的精簡狀態圖表。

圖 2. 週期工作的狀態圖表。

封鎖狀態

我們尚未提及最終的狀態,現在是 BLOCKED。這個狀態適用於以系列或連鎖調度管理的工作。工作鍊和其狀態圖包含在鏈鎖工作中。

後續步驟

您可以參考「管理工作」一節,進一步瞭解如何管理和監控工作進度。