Salta ai contenuti
Italiano

Task 与异步调用

Questa pagina non è disponibile nella lingua selezionata. Viene mostrata la documentazione inglese della stessa versione.

Questi contenuti non sono ancora disponibili nella tua lingua.

Task 是异步函数调用返回的一次性句柄。调用提交任务,工作可能在 await 前执行,但不保证立即开始或执行顺序;await 获取结果;T! 中的可恢复错误继续使用 ? 或 try/catch 处理。

保存为 tasks.ku,运行 ku run tasks.ku:

async fn Double(value: int): int! {
return ok(value * 2)
}
async fn main(): null! {
first = Double(20)
second = Double(21)
println((await first)?)
println((await second)?)
return ok(null)
}

预期依次输出 40 和 42。这个程序也属于 0.0.20 的受限 native Task 子集,可用 ku build --backend c tasks.ku -o tasks 构建;Windows 输出名使用 tasks.exe。它不是任意标准库都可异步调用的例子。

Owned 参数传入异步函数时转移所有权,需要保留来源时显式 clone。Task 只能 move,不能 clone,await 消费句柄一次。&name: T 只用于同步借用参数,异步函数不能声明借用参数;不能把借用保留到 await 之后。普通业务没有 task.spawn、Task.new、thread.spawn 或 detach 入口。

哪些操作可以等待

“哪些操作可以等待”章节

下表对应 0.0.20。默认 runner 使用解释器路径,native Task 是独立的有界 typed 子集。

操作 解释器 / 默认 runner 受限 native Task
async 调用与 await 支持一次性 Task 已列出的 primitive、字符串、平面数组、单层 Result 和函数值组合
整数毫秒 time.sleep(ms)? 通过 blocking worker 等待 driver timer 等待;不占文件后台 worker
文件与目录 对应解释器操作;不承诺全部操作都可挂起 read/try_read/write/try_write/exists/read_dir 使用固定后台池
TCP / TLS client 不提供对应 native client 局部 net.client/read/write/close 使用固定后台池;TLS 需要匹配 pack
HTTP 独立 HTTP I/O 线程,Ku handler 串行执行 支持受限请求/响应类型的具名 async HTTP handler;不提供通用 Task HTTP 客户端
数据库 不支持连库 支持具名 async HTTP handler 内的特定 PG query 挂起;不提供通用 Redis/MySQL 异步接口
JSON / 动态值 通用 JSON 编码与解码 仅支持编码含标量值的对象字面量;不支持通用 JSON 解码、任意动态堆组合或 Task 容器

文件、TCP 和 TLS 已进入系统调用或外部库的操作不能被强杀。后台池在操作实际完成并清理迟到结果后才归还资源。native Task 的连接和 bytes 只能由当前帧局部拥有,不能作为 Task 参数、返回值或容器元素。

解释器和 native Task 使用有界工作线程与队列。解释器 HTTP 使用单个 I/O owner,Ku handler 串行执行;native HTTP 将连接 I/O 与 handler 执行分开。完整 M:N 与通用网络可挂起调度仍未实现。HTTP、PG 和 JSON 各自较窄的合同见执行路径支持说明。

拥有者作用域退出时,仍持有且未完成的子任务收到取消请求。合法 move 同时转移清理责任;已完成但未 await 的结果也会释放。取消尝试执行 finally,嵌套清理共享默认一秒的绝对截止期限;预算到期不保证执行剩余用户语句。

取消和超时是控制终止,不是普通 Result,不能由 catch 作为业务错误捕获。取消清理期间不能新建 Task、await,或提交新的 timer、网络等待和 blocking job。已经开始的系统调用不能靠 Task 取消证明其副作用已撤销。

ku supervise 管理整个程序 worker,与 Task 句柄不同,见支持与进程限制。详细操作范围见 并发说明。