【翻译】kotlin协程核心库文档(三)—— 编写挂起函数

github原文地址

原创翻译,转载请保留或注明出处:https://www.jianshu.com/p/e0ad1e9fc32a

编写挂起函数


本节涵盖了编写挂起函数的各种方式

默认按顺序

假设我们有两个定义好的挂起函数,这些函数做一些有用的事比如远程调用、计算之类。我们只是假设它们是有用的,但实际上为了这个示例的目的,每个函数内只是延迟了一秒钟:

suspend fun doSomethingUsefulOne(): Int {
    delay(1000L) // pretend we are doing something useful here
    return 13
}

suspend fun doSomethingUsefulTwo(): Int {
    delay(1000L) // pretend we are doing something useful here, too
    return 29
}

如果我们需要按顺序调用它们,我们该怎么做——首先调用doSomethingUsefulOne然后是doSomethingUsefulTwo,并计算结果总和?在实践中,我们使用第一个函数的结果来决定是否调用第二个函数或如何调用它。

我们只是使用正常的顺序调用,因为协程中的代码与常规代码一样,默认情况下是连续的,以下示例通过测量执行两个挂起函数的总时间来演示:

fun main(args: Array<String>) = runBlocking<Unit> {
    val time = measureTimeMillis {
        val one = doSomethingUsefulOne()
        val two = doSomethingUsefulTwo()
        println("The answer is ${one + two}")
    }
    println("Completed in $time ms")
}

获取完整代码 here

输出如下:

The answer is 42
Completed in 2017 ms

并发使用异步

如果doSomethingUsefulOnedoSomethingUsefulTwo的调用之间不存在依赖关系,而且我们希望通过同时执行两者以更迅速的获取结果?这种情况下异步可以帮助你。

概念上,asynclaunch 很像。它开启了一个单独的协程,它是一个与所有其他协程同时工作的轻量级线程。区别在于launch会返回一个个 Job 并且不会携带任何结果值,而async会返回一个 Deferred ——这是一个轻量、非阻塞的future,表示它承诺会稍后提供结果。你可以在一个延迟值上使用.await()用来获取其最终结果,但Deferred也是一个Job,因此如果需要你可以取消它。

fun main(args: Array<String>) = runBlocking<Unit> {
    val time = measureTimeMillis {
        val one = async { doSomethingUsefulOne() }
        val two = async { doSomethingUsefulTwo() }
        println("The answer is ${one.await() + two.await()}")
    }
    println("Completed in $time ms")
}

获取完整代码 here

输出如下:

The answer is 42
Completed in 1017 ms

可以看到速度是之前的两倍,因为我们同时执行了两个协程。请注意,协程的并发执行总是显式的。

延迟启动异步

async 存在一个延迟设置,具体使用:以 CoroutineStart.LAZY 为值设置可选参数start。只有在它的结果被需要、awaitstart 被调用才会启动协程。运行以下示例,以区分在这个可选项下与前一个示例的不同:

fun main(args: Array<String>) = runBlocking<Unit> {
    val time = measureTimeMillis {
        val one = async(start = CoroutineStart.LAZY) { doSomethingUsefulOne() }
        val two = async(start = CoroutineStart.LAZY) { doSomethingUsefulTwo() }
        println("The answer is ${one.await() + two.await()}")
    }
    println("Completed in $time ms")
}

获取完整代码 here

输出如下:

The answer is 42
Completed in 2017 ms

所以我们回到顺序执行了,因为我们第一次启动并等待one的结果,接着又启动并等待two的结果,这并不是惰性的合理用例。当值的计算涉及挂起函数时,它是被设计为标准lazy函数的替代品。

异步风格函数

我们可以使用异步协程构建器,来定义调用了doSomethingUsefulOnedoSomethingUsefulTwo的异步风格函数。使用Async后缀命名这类函数是一种很好的风格,突出显示他们只启动异步计算的事实,并且需要使用得到的延迟值来获取结果。

// The result type of somethingUsefulOneAsync is Deferred<Int>
fun somethingUsefulOneAsync() = async {
    doSomethingUsefulOne()
}

// The result type of somethingUsefulTwoAsync is Deferred<Int>
fun somethingUsefulTwoAsync() = async {
    doSomethingUsefulTwo()
}

要注意一点,这些xxxAsync函数不是挂起函数。他们可以在任何地方使用,然而他们的使用总是暗示他们的行为与调用者代码的异步(这里意味着并发)执行。

如下示例显示了他们在协程外的使用:

// note, that we don't have `runBlocking` to the right of `main` in this example
fun main(args: Array<String>) {
    val time = measureTimeMillis {
        // we can initiate async actions outside of a coroutine
        val one = somethingUsefulOneAsync()
        val two = somethingUsefulTwoAsync()
        // but waiting for a result must involve either suspending or blocking.
        // here we use `runBlocking { ... }` to block the main thread while waiting for the result
        runBlocking {
            println("The answer is ${one.await() + two.await()}")
        }
    }
    println("Completed in $time ms")
}

获取完整代码 here

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,172评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,346评论 3 389
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,788评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,299评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,409评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,467评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,476评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,262评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,699评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,994评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,167评论 1 343
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,827评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,499评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,149评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,387评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,028评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,055评论 2 352

推荐阅读更多精彩内容