docs: clarify task example ownership and failure boundaries
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
// 异步 UTF-8 文件读取:在 Console 调用 reader.read(绝对路径),后台 provider 只交付文本,VM worker 执行业务回调。
|
||||
// owner/key 相同的新读取替换旧任务;失败只记录 Task.error,不执行 apply。
|
||||
// owner/key 相同的新读取替换旧任务;provider 读取失败记录 Task.error、不执行 apply;apply 自身失败则遵循共享运行时停域规则。
|
||||
// 持有三个显示对象与当前任务;task 初值占位,第一次 read 后替换为真实 Task。
|
||||
class FileReader {
|
||||
// 这三个字段保存已构造的文字对象引用,回调更新同一业务对象,不创建一份新的页面或复制 Mount。
|
||||
@@ -11,6 +11,7 @@ class FileReader {
|
||||
// 仅成功时调用,result 在成功回调期间已可读;写原 TextBlock 触发显示刷新。
|
||||
function apply(self: FileReader): Unit {
|
||||
// 任务调度器在 I/O 成功且仍有交付资格时调用绑定的 apply;self 是原 reader,调用者无需另外传参。
|
||||
// 本例适用于不超过 TextBlock 16 KiB UTF-8 字节预算的文件;readText 自身允许至多 1 MiB,读取成功不保证这次控件赋值合法。
|
||||
self.output.text = self.task.result()
|
||||
}
|
||||
// 以 self 为 owner、file 为 key 启动读取,清空旧输出,并把状态/错误文字绑定到当前任务。
|
||||
|
||||
Reference in New Issue
Block a user