Job | Notion

0. 정의

Job | kotlinx.coroutines – Kotlin Programming Language

Coroutine 작업 하나를 의미하는 객체.

Kotlin Coroutines에서는 Coroutine을 컨트롤하기 위한 객체인 Job을 제공한다.

Job은 1개부터 여러 개에 이르는 Coroutine의 동작을 제어할 수 있다!

1. Job의 상태

Coroutines Job은 coroutines의 6가지 상태를 가지고 있다.

State	isActive	isCompleted	isCancelled
New (optional initial state)	false	false	false
Active (default initial state)	true	false	false
Completing (transient state)	true	false	false
Cancelling (transient state)	false	false	true
Cancelled (final state)	false	true	true
Completed (final state)	false	true	false

위 Job을 바탕으로 Coroutine의 상태를 확인, 제어할 수 있다.

이 때 job.cancel()을 호출하면 해당 Job은 즉시 취소 상태로 가게 된다.

 /* Kotlin 공식 레퍼런스 中 */
                                  wait children
+-----+ start  +--------+ complete   +-------------+  finish  +-----------+
| New | -----> | Active | ---------> | Completing  | -------> | **Completed** |
+-----+        +--------+            +-------------+          +-----------+
                 |  cancel / fail       |
                 |     +----------------+
                 |     |
                 V     V
             +------------+                           finish  +-----------+
             | Cancelling | --------------------------------> | **Cancelled** |
             +------------+                                   +-----------+

2. Job의 기능

start : 현재 coroutine의 동작 상태를 체크하며, 동작 중인 경우 true, 준비/완료 상태는 false를 return.
join : 현재 coroutine 동작이 끝날 때까지 대기한다. 즉, async { } await 처럼 사용가능하다.
cancel : 현재 coroutine을 즉시 종료하도록 유도만 하고 대기하지 않는다.
- 단, 빠르게 동작하는 단순 루프에서는 delay가 없으면 종료하지 못한다.
cancelAndJoin : 현재 coroutine에 종료하라는 신호를 보내고, 정상 종료할 때까지 대기한다.
cancelChildren : CoroutineScope 내 작성한 children coroutine들을 종료한다.
- cancel과 다르게 하위 아이템들만 종료하며, 부모는 취소하지 않는다.