Coroutine Builder: apa itu, tipe-tipe builder coroutine dan cara kerjanya

Apa itu Coroutine Builder?

Coroutine Builder — adalah fungsi ekstensi Kotlin yang menerima CoroutineScope dan suspend-block, membuat dan menjalankan coroutine baru. Setiap builder menentukan bagaimana coroutine akan dieksekusi: dengan atau tanpa pengembalian hasil, dengan memblokir thread atau secara asinkron. Builder adalah titik masuk ke model coroutine dalam bahasa ini.

Semua builder bekerja melalui CoroutineScope, yang mengelola siklus hidup coroutine anak. Ketika scope dibatalkan, semua coroutine yang dijalankan melaluinya akan dibatalkan secara otomatis — ini adalah prinsip konkurensi terstruktur. Pendekatan ini mencegah kebocoran coroutine dan menjamin penyelesaian yang dapat diprediksi.

import kotlinx.coroutines.*

fun main() = runBlocking {
    // Builder bekerja di dalam CoroutineScope
    val job = launch {
        delay(1000L)
        println("Dunia!")
    }
    println("Halo,")
    job.join()
}

Tipe-tipe utama builder coroutine

Kotlin menyediakan empat builder coroutine bawaan: launch, async, runBlocking, dan produce. Masing-masing memiliki tipe kembalian dan area penerapan sendiri. Untuk pengembangan mobile Android, yang utama adalah launch dan async — mereka bekerja secara non-blocking dan terintegrasi dengan komponen arsitektur.

Setiap builder menerima parameter tambahan: CoroutineStart (strategi eksekusi), CoroutineContext (dispatcher, pengecualian) dan blok kode bernama. Secara default, coroutine dijalankan segera (CoroutineStart.DEFAULT).

launch: eksekusi fire-and-forget

launch — builder yang paling sering digunakan dalam pengembangan Android. Builder ini menjalankan coroutine yang tidak mengembalikan hasil dan mengembalikan objek Job untuk mengelola siklus hidupnya. Ini adalah pilihan ideal untuk operasi yang hanya membutuhkan efek samping: penyimpanan ke database, pengiriman analitik, pembaruan UI.

Sintaksis dan penggunaan launch

Builder launch menerima CoroutineScope, CoroutineContext opsional, dan suspend-block. Job yang dikembalikan memungkinkan pembatalan coroutine, menunggu penyelesaiannya, atau memeriksa status.

val scope = CoroutineScope(Dispatchers.IO + SupervisorJob())
val job: Job = scope.launch(CoroutineStart.LAZY) {
    val data = fetchFromNetwork()
    saveToDatabase(data)
}
job.start()
job.join()

Parameter CoroutineStart.LAZY menunda eksekusi hingga pemanggilan eksplisit start() atau join(). Ini berguna untuk inisialisasi yang ditunda dan eksekusi bersyarat. Untuk eksekusi langsung standar, gunakan CoroutineStart.DEFAULT atau parameter dihilangkan.

async: komputasi paralel dengan hasil

async — builder yang mengembalikan Deferred<T> — janji asinkron dari hasil. Pemanggilan await() menangguhkan coroutine hingga hasil diperoleh, tanpa memblokir thread. Ini adalah mekanisme utama untuk tugas paralel dalam coroutine Kotlin.

Menjalankan dua permintaan secara paralel

async sangat efektif ketika beberapa operasi independen perlu dilakukan secara bersamaan. Berbeda dengan pemanggilan berurutan fungsi suspend, async menjalankan coroutine secara paralel, memperpendek total waktu eksekusi.

suspend fun fetchUserData(): UserData {
    val deferred1 = CoroutineScope(Dispatchers.IO).async { api.getProfile() }
    val deferred2 = CoroutineScope(Dispatchers.IO).async { api.getSettings() }
    val deferred3 = CoroutineScope(Dispatchers.IO).async { api.getNotifications() }
    return UserData(
        profile = deferred1.await(),
        settings = deferred2.await(),
        notifications = deferred3.await()
    )
}

Deferred mewarisi dari Job, sehingga async mendukung semua operasi siklus hidup: pembatalan, menunggu penyelesaian, penanganan pengecualian. Ketika scope dibatalkan, coroutine anak Deferred dibatalkan secara otomatis.

runBlocking: jembatan ke dunia blocking

runBlocking — satu-satunya builder yang memblokir thread saat ini hingga coroutine selesai. Builder ini membuat CoroutineScope baru dan menjalankan coroutine yang diberikan, memblokir thread pemanggil. Digunakan di titik masuk main(), dalam pengujian, dan saat integrasi dengan kode blocking.

Kapan runBlocking diperlukan

runBlocking dibenarkan dalam tiga skenario: titik masuk aplikasi (main), pengujian unit fungsi suspend, dan integrasi dengan pustaka berbasis callback di mana suspend tidak dapat digunakan. Dalam kode produksi Android, penggunaan runBlocking pada thread utama sangat tidak disarankan.

class CoroutineTest {
    @Test
    fun `test suspend function`() = runBlocking {
        val result = mySuspendFunction()
        assertEquals("expected", result)
    }
}

Untuk pengujian, disarankan menggunakan kotlinx-coroutines-test dengan TestCoroutineDispatcher daripada runBlocking — ini memberikan kontrol waktu dan menghindari pemblokiran di lingkungan pengujian.

Cara memilih builder yang tepat

Pemilihan Coroutine Builder tergantung pada hasil kembalian dan skenario eksekusi. Jika operasi tidak memerlukan pengembalian data — gunakan launch. Jika hasil operasi asinkron diperlukan — async. runBlocking terapkan hanya untuk bridging, dan produce ganti dengan Flow untuk aliran reaktif.

Rekomendasi praktis untuk Android

Dalam proyek Android yang menggunakan Kotlin Coroutines, pasangan utama builder adalah launch dan async. launch digunakan di ViewModel dan UseCases untuk menjalankan coroutine, sedangkan async — untuk permintaan paralel ke jaringan atau database. Pustaka modern (Ktor, Room) sudah mendukung fungsi suspend, yang meminimalkan kebutuhan penggunaan async secara langsung.

• launch — untuk fire-and-forget (logging, analitik, caching)
• async — untuk permintaan paralel dengan penggabungan hasil
• runBlocking — hanya di main() dan pengujian (bukan di produksi pada Main-thread)
• produce — ganti dengan Flow / SharedFlow / StateFlow