Struct HttpResponse 

pub struct HttpResponse {
    pub status_code: u16,
    pub reason_phrase: String,
    pub version: String,
    pub headers: HashMap<String, Vec<String>>,
    pub body: Option<Vec<u8>>,
}

HTTP 响应结构体

表示一个完整的 HTTP 响应，包含状态码、reason phrase、版本、headers 和可选的 body。 支持多值 headers (如 Set-Cookie)。

Fields

status_code: u16

状态码 (如 200, 404, 301)

reason_phrase: String

原因短语 (如 OK, Not Found, Moved Permanently)

version: String

HTTP 版本 (如 “HTTP/1.1”)

headers: HashMap<String, Vec<String>>

响应 headers (支持多值)

body: Option<Vec<u8>>

可选的响应体

Implementations

impl HttpResponse

pub fn from_bytes(data: &[u8]) -> Result<Self>

从原始字节解析 HTTP 响应

解析符合 HTTP/1.1 规范的响应数据，包括状态行、headers 和 body。 支持多值 headers (通过逗号分隔或多个同名 header)。

Arguments

• data - 原始 HTTP 响应字节

Returns

解析后的 HttpResponse，或错误信息

Errors

返回错误如果响应格式无效或无法解析

pub fn header(&self, name: &str) -> Option<&String>

获取指定 header 的第一个值

Arguments

• name - header 名称 (不区分大小写)

Returns

第一个 header 值的引用，如果不存在则返回 None

pub fn header_all(&self, name: &str) -> Vec<String>

获取指定 header 的所有值

对于 Set-Cookie 等可能多次出现的 header 特别有用。

Arguments

• name - header 名称 (不区分大小写)

Returns

包含所有匹配值的向量

pub fn content_length(&self) -> Option<u64>

获取 Content-Length header 的值

Returns

内容长度 (u64)，如果不存在或解析失败则返回 None

pub fn is_redirect(&self) -> bool

检查是否为重定向响应 (3xx)

Returns

如果状态码在 300-399 范围内返回 true

pub fn location(&self) -> Option<Url>

获取 Location header 并解析为 URL

对于重定向响应特别有用。如果是相对 URL，会基于当前请求 URL 进行解析。

Returns

解析后的绝对 URL，如果不存在或解析失败则返回 None

pub fn decoded_body(&self) -> Result<Vec<u8>>

使用流式解码器获取解码后的 body

根据 HTTP 响应的 Content-Encoding 和 Transfer-Encoding headers 自动选择合适的解码器， 对响应体进行解码。支持 GZip、Chunked、BZip2 等编码格式。

遵循 RFC 7230 Section 3.3.1 规范：Transfer-Encoding 优先于 Content-Encoding。

Returns

解码后的原始数据，或错误信息。如果没有 body 则返回空向量。

Errors

• 如果编码格式无效或数据损坏
• 如果解码过程中发生 I/O 错误

Examples

let response = /* HTTP response with Content-Encoding: gzip */;
let decoded = response.decoded_body()?;
// decoded 包含解压后的原始数据

Trait Implementations

impl Clone for HttpResponse

fn clone(&self) -> HttpResponse

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpResponse

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

Formats the value using the given formatter.