工作狀態

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

一次性工作狀態

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

在 ENQUEUED 狀態下,工作只要符合 Constraints 和初始延遲時間需求,就能立即執行。接著會進入 RUNNING 狀態。視工作結果而定,工作可能會移至 SUCCEEDED、FAILED,或在結果為 retry 時回到 ENQUEUED。在流程中任何時間點,您都可以取消工作,這時該作業就會移至 CANCELLED 狀態。

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

一次性工作狀態的流程圖,顯示 ENQUEUED、RUNNING、SUCCEEDED、FAILED 和 CANCELLED 之間的轉換。
圖 1. 一次性工作的狀態圖表。

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

週期性工作狀態

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

週期工作狀態的流程圖,顯示 ENQUEUED、RUNNING 和 CANCELLED 之間的轉換。
圖 2. 週期工作的狀態圖表。

封鎖狀態

其中一個最終狀態是 BLOCKED。這個狀態適用於以系列或連鎖調度管理的工作。工作鏈和其狀態圖包含在鏈鎖工作中。

後續步驟

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