Чӣ гуна имконпазирии боздошти иҷрои функсия бо модификатори suspend таъмин карда мешавад?

Механизм ба истодани функсия тавассути механизмҳои корутинҳо ва continuations таъмин мешавад.

1. Модификатори suspend: Ба компилятор нишон медиҳад, ки функсия метавонад истодаги шавад ва баъдтар боз оғоз ёбад, бидуни бастани сӯзишворӣ. Ин маънои онро надорад, ки ҳатман истодаги мешавад.

2. Трансформатсияи компилятор: Компилятор функсияи suspend-ро ба машинаи ҳолатҳо табдил медиҳад. Ин машина нуқтаи иҷрои ҳозираи функсия ва тағйирёбандаҳои маҳаллии онро пайгирӣ мекунад.

3. Continuations: Ҳангоми даъвати функсияи suspend, параметри пинҳон аз навъи Continuation дода мешавад. Ин объект Continuation дорои callback-и аст, ки пас аз анҷоми амали асинхронӣ, ки сабаби истодаги шудан шуд, даъват мешавад. Вай инчунин контексти иҷрои корутинро нигоҳ медорад (плангар, контексти вазифа ва ғайра).

4. Истодаги: Вақте ки функсияи suspend ба нуқтаи, ки бояд амали асинхронӣ анҷом дода шавад, мерасад (масалан, дархости шабакавӣ, хондани маълумот аз базаи додаҳо), ба ҷои бастани сӯзишворӣ, ҳолати ҳозираро (тағирёбандаҳои маҳаллии, нуқтаи иҷрои) мегирад, онро дар объект Continuation сабт мекунад ва назоратро ба коди даъваткунанда баргардон мекунад. Сӯзишворӣ барои иҷрои вазифаҳои дигар озод мешавад.

5. Бозгашт: Вақте ки амали асинхронӣ анҷом ёфт, ба он callback-и алоқаманд (ки дар Continuation нигоҳ дошта мешавад) даъват мешавад. Ин callback корутинро огоҳ мекунад, ки мумкин аст, ки боз оғоз шавад. Корутин аз ҳолати нигоҳ доштаашуда дар Continuation истифода мебарад, барои восеъ кардани контексти иҷроиш ва идома додан аз нуқтаи, ки дар он истодаги шуд.

// Мисол: функсияи suspend, ки таъхирро имитатсия мекунад
suspend fun fetchData(): String {
    // Ин ҷо истодаги рӯй медиҳад.
    // Корутин ҳолатро нигоҳ медорад ва сӯзишвориро озод мекунад.
    delay(1000) // функсияи suspend аз kotlinx.coroutines
    // Пас аз 1000 мс, callback-и `Continuation` даъват мешавад,
    // ва корутин аз ин нуқта идома медиҳад.
    return "Маълумот бор карда шуд"
}