💡 Kotlin Coroutines: 비동기 프로그래밍 정리

💡 Kotlin Coroutines: 비동기 프로그래밍 활용 예시

Kotlin Coroutines는 Android 환경에서 비동기(Asynchronous) 프로그래밍을 위한 가장 현대적이고 효율적인 방법입니다. 메인 스레드(UI 스레드)를 블로킹하지 않고, 네트워크 요청이나 데이터베이스 접근과 같은 오래 걸리는 작업을 처리할 수 있게 해줍니다.

핵심은 suspend 함수와 **구조화된 동시성(Structured Concurrency)**입니다.

---

1. ⚙️ 코루틴을 위한 환경 설정

Kotlin Coroutines를 사용하려면 build.gradle.kts 파일에 의존성을 추가해야 합니다.

// build.gradle.kts (Module: app)

dependencies {
    // 코루틴 핵심 라이브러리
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.7.3")
    
    // Android 환경에서 사용 시
    implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
    
    // ViewModel에서 코루틴 사용 시
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.7.0")
}

---

2. 📝 활용 예시: 안드로이드 MVVM 아키텍처

안드로이드 앱에서 ViewModel 내에서 네트워크 작업을 수행하고 결과를 UI에 반영하는 표준적인 코루틴 활용 예시입니다.

2.1. suspend 함수 정의 (데이터 레이어)

데이터베이스 접근이나 Retrofit을 사용한 네트워크 요청 등 시간이 오래 걸리는 작업은 suspend 키워드를 사용하여 정의합니다. 이 함수는 코루틴 스코프 내에서만 호출될 수 있으며, 실행 중 블로킹 없이 잠시 멈췄다가(suspending) 나중에 재개됩니다.

// 1. Data Class (예시)
data class User(val id: Int, val name: String)

// 2. Repository (데이터 레이어)
class UserRepository {
    
    // suspend 키워드: 이 함수가 비동기 작업을 수행함을 명시
    suspend fun fetchUser(userId: Int): User {
        // withContext를 사용하여 IO 스레드로 전환 (네트워크, DB 작업에 적합)
        return withContext(Dispatchers.IO) {
            // 실제 네트워크 요청이나 DB 쿼리 코드가 여기에 들어갑니다.
            
            // 시뮬레이션: 2초 동안 지연 (블로킹 없이)
            kotlinx.coroutines.delay(2000)
            
            // 결과 반환
            User(userId, "사용자 #$userId")
        }
    }
}

2.2. ViewModel에서 코루틴 실행 (ViewModel 레이어)

ViewModel에서는 viewModelScope를 사용하여 코루틴을 시작합니다. viewModelScope는 ViewModel의 수명 주기와 함께 시작하고, ViewModel이 파괴될 때 코루틴을 자동으로 취소(Cancel)하여 메모리 누수를 방지합니다 (구조화된 동시성).

// 1. ViewModel (비즈니스 로직 레이어)
class UserViewModel(private val repository: UserRepository) : ViewModel() {
    
    // UI에 보여줄 상태 (LiveData 또는 StateFlow 사용)
    private val _userState = MutableStateFlow<User?>(null)
    val userState: StateFlow<User?> = _userState
    
    fun loadUserData(userId: Int) {
        // 2. viewModelScope를 사용하여 코루틴 시작
        // ViewModel이 살아있는 동안 코루틴이 실행됩니다.
        viewModelScope.launch {
            try {
                // 3. suspend 함수 호출 (awaiting its result)
                val user = repository.fetchUser(userId) 
                
                // 4. 결과 처리: UI 스레드에서 자동으로 실행됨
                _userState.value = user
                
            } catch (e: Exception) {
                // 에러 처리
                Log.e("UserViewModel", "데이터 로드 중 오류 발생", e)
            }
        }
    }
}

2.3. 여러 비동기 작업 병렬 처리

두 가지 이상의 독립적인 비동기 작업을 동시에 실행하고 모든 결과가 도착할 때까지 기다려야 할 경우, async 빌더와 await 함수를 사용합니다.

class DataService(private val repository: UserRepository) {
    
    // 두 작업을 동시에 실행
    suspend fun loadDashboardData(userId: Int): Pair<User, String> {
        
        // CoroutineScope 내에서 async를 사용하여 작업을 병렬로 시작
        val userDeferred = CoroutineScope(Dispatchers.IO).async { 
            repository.fetchUser(userId) 
        }
        
        val settingDeferred = CoroutineScope(Dispatchers.IO).async { 
            fetchUserSettings() // 별도의 suspend 함수 가정
        }

        // await()를 사용하여 두 작업이 모두 완료될 때까지 기다립니다.
        val user = userDeferred.await()
        val settings = settingDeferred.await()

        return Pair(user, settings)
    }
    
    // 설정 정보를 가져오는 또 다른 suspend 함수 (예시)
    private suspend fun fetchUserSettings(): String {
        delay(1500) // 1.5초 지연
        return "Loaded Settings"
    }
}

---

3. 🔑 코루틴 핵심 개념 요약

개념	설명	활용
suspend	함수가 실행 중 잠시 멈출 수 있는(Non-blocking) 비동기 함수임을 표시.	모든 네트워크/DB 접근 함수 정의.
launch	코루틴을 시작하고 결과를 무시하거나(fire-and-forget), 상태를 업데이트할 때 사용.	ViewModel에서 UI 업데이트 코루틴 시작.
async / await	결과를 반환하는 코루틴을 시작(async)하고, 나중에 그 결과를 받을 때(await) 사용. 병렬 처리에 주로 활용됨.	여러 API 호출을 동시에 수행.
Dispatchers	코루틴이 실행될 스레드(컨텍스트)를 지정.	Dispatchers.Main (UI), Dispatchers.IO (네트워크/DB), Dispatchers.Default (CPU 집약 작업).
withContext	현재 코루틴이 실행되는 컨텍스트를 변경(스레드 전환)하고 작업을 수행 후 원래 컨텍스트로 복귀.	Dispatchers.Main에서 Dispatchers.IO로 전환하여 네트워크 요청 수행.