Что означает suspend-функция в Kotlin корутинах? Объяснение для новичков

Что такое suspend-функция: простое объяснение

Представьте, что вы готовите сложное блюдо. Обычная функция — это как рецепт, который нужно выполнить от начала до конца, не отвлекаясь. Suspend-функция — это рецепт, в котором есть пометка "поставьте тесто подниматься на 1 час". Пока тесто поднимается, вы можете заняться другими делами (помыть посуду, почитать книгу), а потом вернуться и продолжить готовку.

В мире программирования suspend-функция — это функция, которая может приостановить своё выполнение, не блокируя поток, и возобновить его позже. Это ключевое отличие от обычных блокирующих операций (например, Thread.sleep()), которые занимают поток и не дают ему делать ничего другого.

Как это работает под капотом?

Когда компилятор Kotlin видит ключевое слово suspend, он преобразует функцию в конечный автомат (state machine). Каждая точка приостановки (например, вызов другой suspend-функции или delay()) становится состоянием. Вот упрощённая схема:

// Исходная suspend-функция
suspend fun fetchUserData(): String {
    println("Начинаем загрузку...")
    delay(1000)        // Точка приостановки
    println("Загрузка завершена!")
    return "User data"
}

// Пример того, как это выглядит внутри (сильно упрощено)
// Компилятор создаёт нечто похожее:
fun fetchUserData(continuation: Continuation<String>): Any? {
    val state = continuation.state
    when (state) {
        0 -> {
            println("Начинаем загрузку...")
            continuation.state = 1
            return delay(1000, continuation) // Приостановка!
        }
        1 -> {
            println("Загрузка завершена!")
            return "User data" // Возвращаем результат
        }
        else -> throw IllegalStateException()
    }
}

Почему нельзя вызвать из обычной функции?

Обычная функция не имеет доступа к Continuation (объекту, который хранит состояние и позволяет возобновить выполнение). Когда вы вызываете suspend-функцию, вы должны находиться внутри контекста корутины, который предоставляет этот Continuation. Если вы попытаетесь вызвать её из обычной функции, компилятор выдаст ошибку, потому что некуда сохранить состояние приостановки.

Что происходит с потоком?

Вот самый важный момент: когда корутина доходит до точки приостановки (например, delay(1000)), поток не блокируется. Он освобождается и может выполнять другие корутины. Через 1 секунду корутина "просыпается" и продолжает выполнение на любом доступном потоке (не обязательно на том же самом).

Пример с несколькими корутинами:

suspend fun fetchUserData(id: Int): String {
    delay(1000) // Поток освобождается!
    return "User $id data"
}

fun main() = runBlocking {
    launch { println(fetchUserData(1)) } // Корутина 1
    launch { println(fetchUserData(2)) } // Корутина 2
    println("Обе корутины запущены")
}
// Вывод:
// Обе корутины запущены
// (через 1 секунду)
// User 1 data
// User 2 data

Обратите внимание: обе корутины выполнились параллельно на одном потоке! Если бы мы использовали Thread.sleep(), то сначала выполнилась бы первая корутина, потом вторая, и это заняло бы 2 секунды. С корутинами — 1 секунда.

Как правильно вызвать suspend-функцию?

Есть три способа:

• Из другой suspend-функции — самый простой случай
• Из корутины (через launch, async или runBlocking)
• Из main() с помощью runBlocking — для тестов и простых примеров

Исправленный пример:

fun main() = runBlocking { // Создаём контекст корутины
    val data = fetchUserData() // Теперь можно!
    println(data)
}

suspend fun fetchUserData(): String {
    delay(1000)
    return "User data"
}

Итог

Suspend-функция — это не просто "асинхронная функция". Это функция, которая может приостанавливаться, не блокируя поток, и возобновляться позже. Это позволяет писать асинхронный код, который выглядит как синхронный, без коллбэков и сложных цепочек.

// Kotlin стиль
suspend fun loadData(): String {
    return fetchFromNetwork() // Просто вызываем, без await
}

// JavaScript стиль
async function loadData() {
    return await fetchFromNetwork(); // Нужен await
}