Struct CanonicalResponse 

pub struct CanonicalResponse {
    pub status_code: u16,
    /* private fields */
}

统一规范化响应

所有HTTP协议处理后的统一响应结构。

设计特点

• 零堆分配：小 Body 使用栈上固定数组，超过 MAX_BODY_LEN 时才使用堆
• Copy 语义：仅当 Body 超过栈容量时放弃 Copy

Fields

status_code: u16

状态码

Implementations

impl CanonicalResponse

pub const fn new(status_code: u16) -> CanonicalResponse

创建响应（零堆分配）

pub const fn ok() -> CanonicalResponse

创建简单的成功响应

pub const fn error(status_code: u16) -> CanonicalResponse

创建简单的错误响应

pub fn reset(&mut self)

重置响应（保留状态码，清空其他字段） 用于对象池复用，避免重新创建对象的开销

pub fn header_count(&self) -> u8

获取头部数量

pub fn add_header( &mut self, name: &[u8], value: &[u8], ) -> Result<(), &'static str>

添加头部

安全

拒绝包含 \r 或 \n 的头部名称和值，防止 HTTP 响应拆分攻击。

pub fn set_body(&mut self, body: impl Into<Vec<u8>>)

设置 Body

性能

• Body 长度 <= MAX_BODY_LEN：使用栈上缓冲区，零堆分配
• Body 长度 > MAX_BODY_LEN：使用堆分配

pub fn body(&self) -> &[u8]

获取 Body 引用

pub fn headers_iter(&self) -> &[CanonicalHeader]

获取头部迭代器

pub fn find_header(&self, name: &str) -> Option<&CanonicalHeader>

按名称查找头部（ASCII 大小写不敏感，RFC 7230 §3.2）

Trait Implementations

impl Clone for CanonicalResponse

fn clone(&self) -> CanonicalResponse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CanonicalResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for CanonicalResponse

fn default() -> CanonicalResponse

Returns the “default value” for a type.