Net/docs/fastest.md

多个请求并发执行

1. 当某个请求成功时, 剩余请求将被自动取消
2. 全部错误时则会抛出最后一个请求错误作为结果

!!! Note "异常信息"

先失败的请求错误会被忽略, 但LogCat依然会输出异常

示例

scopeNetLife {

    // 同时发起四个网络请求
    val deferred = Get<String>("api0") // 错误接口
    val deferred1 = Get<String>("api1") // 错误接口
    val deferred2 = Get<String>("api")
    val deferred3 = Post<String>("api")

    // 只返回最快的请求结果
    tvFragment.text = fastest(deferred, deferred1, deferred2, deferred3)
}

取消剩余

上面的示例不会在获取到结果后取消剩余请求, 需设置同一请求分组才可以

scopeNetLife {
    // 同时发起四个网络请求
    val deferred2 = Get<String>("api") { setGroup("初始化") }
    val deferred3 = Post<String>("api") { setGroup("初始化") }
    val deferred = Get<String>("api0") { setGroup("初始化") } // 错误接口
    val deferred1 = Get<String>("api1") { setGroup("初始化") } // 错误接口

    // 只返回最快的请求结果
    tvFragment.text = fastest(listOf(deferred, deferred1, deferred2, deferred3), "初始化")
}

类型不一致

当需要返回结果, 但多接口返回数据类型不同, 使用transform转换为同一类型结果

scopeNetLife {

    val fastest = Post<String>("api").transform {
        Log.d("日志", "Post") // 如果该接口最快则会回调这里
        it // 这里可以返回其他数据结果
    }

    val fastest2 = Get<String>("api").transform {
        Log.d("日志", "Get") // 如果该接口最快则会回调这里
        it
    }

    tvFragment.text = fastest(fastest, fastest2)
}

只有最快返回结果的网络请求(或异步任务)的transform回调才会被执行到

捕获错误

scopeNetLife {
    val task = Get<String>("api2")
    val task1 = Get<String>("api2")
    val task2 = Get<String>("api2")

    val data = try {
        fastest(listOf(task, task1, task2))
    // 当task/task1/task2全部错误后才并发执行backupTask/backupTask1
    } catch (e: Exception) {
        val backupTask = Get<String>("api2")
        val backupTask1 = Get<String>("api")
        fastest(listOf(backupTask, backupTask1))
    }
}