Expand description
Zenith API - 公开API与类型定义
本 crate 定义 Zenith 框架的所有公开类型、特征和接口, 是外部程序依赖的唯一入口点。
§设计原则
- 热路径零堆分配:使用固定容量数组替代 String/Vec
- Copy 语义:所有核心类型支持 Copy,避免昂贵的 Clone
- 编译期安全:类型系统保证所有权唯一
Modules§
- normalize
- 规范化引擎
Structs§
- Body
Stream - Body 流(单消费者,借用语义,零拷贝)
- Canonical
Header - 规范化请求头(固定容量,Copy 语义)
- Canonical
Request - 统一规范化请求
- Canonical
Response - 统一规范化响应
- Method
Parse Error - Method 解析错误
Enums§
Constants§
- MAX_
AUTHORITY_ LEN - 最大授权主机长度(字节)
- MAX_
BODY_ LEN - 最大响应 Body 长度(字节) 小于此值的 Body 使用栈上固定数组,超过时使用堆分配
- MAX_
HEADER_ COUNT - 最大头部数量
- MAX_
HEADER_ NAME_ LEN - 最大头部名称长度(字节)
- MAX_
HEADER_ VALUE_ LEN - 最大头部值长度(字节) RFC 7230 建议整个头部块最小 8KB,单个值通常不超过 256 字节
- MAX_
PATH_ LEN - 最大路径长度(字节)
- MAX_
QUERY_ LEN - 最大查询字符串长度(字节)
Traits§
- Service
- 服务注册特征
- Service
Factory - 服务工厂特征