Expand description
进程运行时:运行时状态、运行时资源与运行时编排。
三者都描述「正在运行的这个进程」,与请求处理、存储访问无关,故同 crate:
| 模块 | 内容 | feature |
|---|---|---|
app_state | AppState:服务标识、运行标志、并发计数、启动时间 | 始终编译 |
ctx | task-local 请求上下文 CTX / Context | 始终编译 |
process | 进程 CPU / 内存 / 文件描述符 / 磁盘读写采样 | process-info |
hook | 启动前 / 关闭后钩子:register_task + run_before_tasks / run_after_tasks | 始终编译 |
scheduler | cron 定时任务:[register_job_task] + run_scheduler_jobs | scheduler |
hook 管「启动/关闭各跑一次」,scheduler 管「按 cron 周期性反复跑」。
与 tibba-job(Postgres 异步任务队列)的分工:本 crate 是进程内编排,
不落库、不跨进程重试。
两个可选 feature 默认关闭:sysinfo 与 tokio-cron-scheduler 传递依赖较重,
只用 AppState / CTX / 钩子的下游不必为其付出编译代价。
Structs§
Statics§
- CTX
- Tokio task-local 变量,存储当前请求的追踪上下文,生命周期与请求任务绑定。
Traits§
- Task
- 生命周期钩子 trait,用于在应用启动/关闭时执行自定义逻辑。
Functions§
- register_
task - 注册一个具名钩子任务。同名任务重复注册时,新任务会覆盖旧任务。
- run_
after_ tasks - 按优先级降序执行所有已注册的
after钩子(应用关闭后调用)。 任务错误仅记日志,所有任务都会被执行;本函数始终返回Ok(())。 - run_
before_ tasks - 按优先级升序执行所有已注册的
before钩子(应用启动前调用)。 任一任务返回错误时立即停止并向上传播。
Type Aliases§
- BoxFuture
- 装箱的异步 Future,用于 trait object 场景下的异步方法返回类型。