Struct CanonicalHeader 

pub struct CanonicalHeader {
    pub name: [u8; 64],
    pub name_len: u8,
    pub value: [u8; 256],
    pub value_len: u16,
}

规范化请求头（固定容量，Copy 语义）

每个头部条目使用固定容量数组存储，避免堆分配。

Fields

name: [u8; 64]

头名称（最大 MAX_HEADER_NAME_LEN 字节）

name_len: u8

头名称实际长度

value: [u8; 256]

头值（最大 MAX_HEADER_VALUE_LEN 字节）

value_len: u16

头值实际长度

Implementations

impl CanonicalHeader

pub const fn empty() -> Self

创建空头部

pub fn reset(&mut self)

重置头部（清空内容） 用于对象池复用，避免重新创建对象的开销

pub fn from_bytes(name: &[u8], value: &[u8]) -> Option<Self>

从字节切片创建头部（fail-closed）

Arguments

• name - 头名称（必须不超过 MAX_HEADER_NAME_LEN）
• value - 头值（必须不超过 MAX_HEADER_VALUE_LEN）

Returns

• Some(CanonicalHeader) - 创建成功
• None - 名称或值超长（拒绝静默截断，防止截断后语义被篡改）

pub fn name_str(&self) -> &str

获取名称为字符串切片

pub fn value_str(&self) -> &str

获取值为字符串切片

pub fn is_empty(&self) -> bool

是否为空

Trait Implementations

impl Clone for CanonicalHeader

fn clone(&self) -> CanonicalHeader

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CanonicalHeader

impl Debug for CanonicalHeader

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

Formats the value using the given formatter.