sdk/com.m8test.script.core.api.coroutines/Deferred

Deferred

代表一个延迟计算的结果，是 Job 的一个可返回值的特化版本。

它类似于其他语言中的 Promise 或 Future。Deferred 接口的设计支持优雅的链式调用，允许你将多个异步操作串联起来，形成清晰、线性的代码流，从而避免“回调地狱”。

Parameters

延迟计算结果的类型。

Functions

abstract fun also(block: (ERROR CLASS: Symbol not found for kotlinx.coroutines.Job) -> Unit): ObjectWrapper<ERROR CLASS: Symbol not found for kotlinx.coroutines.Job>

对 ObjectWrapper 调用给定的 block 函数，并返回 ObjectWrapper 本身。

apply

abstract fun apply(block: ERROR CLASS: Symbol not found for kotlinx.coroutines.Job.() -> Unit): ObjectWrapper<ERROR CLASS: Symbol not found for kotlinx.coroutines.Job>

对 ObjectWrapper 调用给定的 block 函数，并返回 ObjectWrapper 本身。

cancel

abstract fun cancel(message: String?)

取消此任务，并可选择提供一个原因。

getContext

abstract fun getContext(): ScriptContext

获取脚本上下文对象 ScriptContext.

getOrigin

abstract override fun getOrigin(): ERROR CLASS: Symbol not found for kotlinx.coroutines.Deferred<T>

获取底层的 Kotlin Deferred 实例。

invokeOnCompletion

abstract fun invokeOnCompletion(handler: (Throwable?) -> Unit): DisposableHandle

注册一个在任务完成时（正常结束、被取消或失败）调用的回调函数。

isActive

abstract fun isActive(): Boolean

检查此任务是否仍在活动中（即尚未完成也未被取消）。

isCancelled

abstract fun isCancelled(): Boolean

检查此任务是否已被取消。

isCompleted

abstract fun isCompleted(): Boolean

检查此任务是否已经完成（无论成功、失败或取消）。

let

abstract fun <R> let(block: (ERROR CLASS: Symbol not found for kotlinx.coroutines.Job) -> R): ObjectWrapper<R>?

对 ObjectWrapper 调用给定的 block 函数，并返回 block 函数的结果包装在 ObjectWrapper 中。

onComplete

abstract fun onComplete(handler: () -> Unit): Deferred<T>

注册一个在延迟计算完成时（无论成功、失败还是取消）都会执行的回调。

onError

abstract fun onError(handler: (Throwable) -> Unit): Deferred<T>

注册一个在延迟计算失败（即协程抛出异常）时执行的回调。

run

abstract fun <R> run(block: ERROR CLASS: Symbol not found for kotlinx.coroutines.Job.() -> R): ObjectWrapper<R>?

对 ObjectWrapper 调用给定的 block 函数，并返回 block 函数的结果包装在 ObjectWrapper 中。

setOrigin

abstract fun setOrigin(origin: ERROR CLASS: Symbol not found for kotlinx.coroutines.Job)

设置原始对象

start

abstract fun start(): Boolean

启动一个以懒惰模式（CoroutineStart.LAZY）创建的协程。

takeIf

abstract fun takeIf(predicate: (ERROR CLASS: Symbol not found for kotlinx.coroutines.Job) -> Boolean): ObjectWrapper<ERROR CLASS: Symbol not found for kotlinx.coroutines.Job>?

如果 ObjectWrapper 满足给定的 predicate，则返回 ObjectWrapper 本身，否则返回 null 包装在 ObjectWrapper? 中。

takeUnless

abstract fun takeUnless(predicate: (ERROR CLASS: Symbol not found for kotlinx.coroutines.Job) -> Boolean): ObjectWrapper<ERROR CLASS: Symbol not found for kotlinx.coroutines.Job>?

如果 ObjectWrapper 不满足给定的 predicate，则返回 ObjectWrapper 本身，否则返回 null 包装在 ObjectWrapper? 中。

then

abstract fun <R> then(handler: (CoroutineScope, T) -> Deferred<R>): Deferred<R>

注册一个转换函数，该函数接收当前 Deferred 的成功结果，并返回 另一个 Deferred。新返回的 Deferred 将代表整个链的下一个状态。

toDeferred

abstract fun toDeferred(): Deferred<Unit>

将此 Job 转换为一个 Deferred。