组件¶
本文给出 Cullinan 当前主要运行时组件的高层地图。
如果你想确认自动发现与注册到底保证什么，请先看框架语义规则。简而言之：Cullinan 只保证模块导入阶段执行到的模块顶层装饰器组件，不保证稍后才创建出来的局部类定义。
运行时概览¶
1. 应用编排层¶
- 职责：模块图发现、归属解析、运行时激活、draining 与活动应用查询
- 主包：
cullinan.application - 关键 API：
Application、module、Application.current()、Runtime
2. 核心容器¶
- 职责：依赖注册、解析、作用域、生命周期、请求上下文
- 主包：
cullinan.core - 关键 API：
ApplicationContext、Definition、ScopeType、Inject、InjectByName
3. 服务层¶
- 职责：业务逻辑与受框架管理的长生命周期服务
- 主包：
cullinan.core（@service），高级Service/registry helper 位于cullinan.core.services - 关键 API：
service、Service
4. 控制器层¶
- 职责：路由声明与处理器方法
- 主包：
cullinan.web.controller - 关键 API：
controller、get_api、post_api、response_build
5. Web Runtime¶
- 职责：标准化请求/响应模型、路由、分发、中间件、异常处理
- 主包：
cullinan.web.gateway - 关键 API：
WebRequest、WebResponse、Router、Dispatcher、MiddlewarePipeline、WebRuntime
6. 适配器层¶
- 职责：把 Web Runtime 绑定到具体服务器环境
- 主包：
cullinan.transport.adapter - 关键 API：
WebAdapter、TornadoAdapter、ASGIAdapter - 定位：位于 Cullinan 语义化 Web 门面之后的后端集成层
7. 参数与模型绑定¶
- 职责：把 path/query/body/header/file 输入映射为处理器参数
- 主包：
cullinan.web.params - 关键 API：
Path、Query、Body、Header、File