定时器与后台任务：时间维度的脚本

本章导读

41.1 引入

服务的"时间维度"需求很朴素：过期清理、周期统计、延迟重试、超时剔除。XServer 的答案是一个一次性定时器——刻意不提供周期版本（见 41.3 的重排模式），因为周期语义与代际生命周期有微妙的交互，显式重排让每一步都可控。定时器绑定创建它的代（ch30 讲过作废语义），回调在引擎线程执行——可以安全调用宿主 API。

41.2 定时器与代

static void OnCleanup(void* pUserData) { ... }

/* ServiceInit 里：30 秒后触发一次 */
uint64 iTimer = xsTimerAfter(pHost, 30000, OnCleanup, NULL);
/* 返回 0 = 失败；非零 ID 可 Cancel */

/* 代绑定三律：*/
/* 1. 创建线程的"当前代"被捕获——回调访问的静态变量必属该代   */
/* 2. 换代 → 旧代定时器全部作废（不会打进新代）              */
/* 3. 新代要继续 → Init 里重新挂（周期任务因此显式化）        */

这个设计消灭了一整类 bug："旧代的定时器摸了新代的静态变量"。代价是你要接受"定时器不跨代"——而跨代延续本就该走 Swap（ch28）。

41.3 周期任务模式

static XS_HostInfo* g_pHostForTick;  /* Init 记录（回调拿不到 host）*/

static void OnTick(void* pUserData)
{
    DoPeriodicWork();                      /* 快活：统计/清理/探测 */
    /* 重排下一次（当前代仍活着才能挂上） */
    (void)xsTimerAfter(g_pHostForTick, 5000, OnTick, NULL);
}
/* ServiceInit：g_pHostForTick = pHost; xsTimerAfter(pHost, 5000, OnTick, NULL); */

自重排的好处全在"换代自动停"：旧代最后一次触发后不再重排（新代 Init 挂新的），任务天然跟着代走——不需要取消逻辑。注意重排放在任务逻辑之后：任务抛错时你可以选择不再重排（停摆也是一种策略）。

41.4 后台线程边界

定时回调跑在引擎线程——必须短（第 3 章契约：拖住 worker 就是拖住所有请求）。长活（批量计算、外部调用、大文件处理）放独立线程，然后面对经典问题：后台线程能不能调宿主/xrt API？

标准结构是任务队列：后台线程做重活，完成后把结果投递回引擎（定时器轮询结果或队列唤醒），由引擎线程碰连接与响应——方向永远清晰：重活出去、结果回来、IO 归引擎。

41.5 契约

• 短快线：定时回调短平快；长活进后台线程 + 结果投递。
• 代际线：定时器不跨代；周期任务自重排；延续状态走 Swap。
• IO 线：连接与视图只在引擎线程碰；后台线程经任务队列交接。

常见错误

编程练习