Skip to main content

Crate zenith_api

Crate zenith_api 

Source
Expand description

Zenith API - 公开API与类型定义

本 crate 定义 Zenith 框架的所有公开类型、特征和接口, 是外部程序依赖的唯一入口点。

§设计原则

  • 热路径零堆分配:使用固定容量数组替代 String/Vec
  • Copy 语义:所有核心类型支持 Copy,避免昂贵的 Clone
  • 编译期安全:类型系统保证所有权唯一

Modules§

normalize
规范化引擎

Structs§

BodyStream
Body 流(单消费者,借用语义,零拷贝)
CanonicalHeader
规范化请求头(固定容量,Copy 语义)
CanonicalRequest
统一规范化请求
CanonicalResponse
统一规范化响应
MethodParseError
Method 解析错误

Enums§

Method
请求方法枚举
Protocol
协议类型枚举
Transport
传输层类型枚举

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
服务注册特征
ServiceFactory
服务工厂特征