Struct Response 

pub struct Response { /* private fields */ }

Represents a parsed HTTP response.

Implementations

impl Response

pub fn new() -> Response

Creates a new instance of Response.

Returns

• Response - A new response instance with default values.

pub fn try_get_header<K>(&self, key: K) -> Option<VecDeque<String>>

where K: AsRef<str>,

Retrieves the value of a response header by its key.

Arguments

• AsRef<str> - The header’s key (must implement AsRef).

Returns

• OptionResponseHeadersValue - The optional header values.

pub fn try_get_header_front<K>(&self, key: K) -> Option<String>

where K: AsRef<str>,

Retrieves the first value of a response header by its key.

Arguments

• AsRef<str> - The header’s key (must implement AsRef).

Returns

• OptionResponseHeadersValueItem - The first header value if exists.

pub fn try_get_header_back<K>(&self, key: K) -> Option<String>

where K: AsRef<str>,

Retrieves the last value of a response header by its key.

Arguments

• AsRef<str> - The header’s key (must implement AsRef).

Returns

• OptionResponseHeadersValueItem - The last header value if exists.

pub fn has_header<K>(&self, key: K) -> bool

where K: AsRef<str>,

Checks if a header exists in the response.

Arguments

• AsRef<str> - The header key to check (must implement AsRef).

Returns

• bool - Whether the header exists.

pub fn has_header_value<K, V>(&self, key: K, value: V) -> bool

where K: AsRef<str>, V: AsRef<str>,

Checks if a header contains a specific value.

Arguments

• AsRef<str> - The header key to check (must implement AsRef).
• AsRef<str> - The value to search for (must implement AsRef).

Returns

• bool - Whether the header contains the value.

pub fn get_headers_length(&self) -> usize

Gets the number of headers in the response.

Returns

• usize - The count of unique header keys.

pub fn get_header_length<K>(&self, key: K) -> usize

where K: AsRef<str>,

Gets the number of values for a specific header key.

Arguments

• AsRef<str> - The header key to count (must implement AsRef).

Returns

• usize - The count of values for the header.

pub fn get_headers_values_length(&self) -> usize

Gets the total number of header values in the response.

This counts all values across all headers, so a header with multiple values will contribute more than one to the total count.

Returns

• usize - The total count of all header values.

pub fn get_body_string(&self) -> String

Retrieves the body content of the response as a UTF-8 encoded string.

This method uses String::from_utf8_lossy to convert the byte slice returned by self.get_body() as_ref a string. If the byte slice contains invalid UTF-8 sequences, they will be replaced with the Unicode replacement character ().

Returns

• String - The body content as a string.

pub fn get_body_json<T>(&self) -> Result<T, Error>

where T: DeserializeOwned,

Deserializes the body content of the response as_ref a specified type T.

This method first retrieves the body content as a byte slice using self.get_body(). It then attempts to deserialize the byte slice as_ref the specified type T using json_from_slice.

Arguments

• DeserializeOwned - The target type to deserialize as_ref (must implement DeserializeOwned).

Returns

• ResultJsonError<T> - The deserialization result.

pub fn set_header<K, V>(&mut self, key: K, value: V) -> &mut Response

where K: AsRef<str>, V: AsRef<str>,

Sets a header in the response, replacing any existing values.

This function replaces all existing values for a header with a single new value.

Arguments

• AsRef<str> - The header key (must implement AsRef).
• AsRef<str> - The header value (must implement AsRef).

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn add_header<K, V>(&mut self, key: K, value: V) -> &mut Response

where K: AsRef<str>, V: AsRef<str>,

Adds a header to the response.

This function appends a value to the response headers. If the header already exists, the new value will be added to the existing values.

Arguments

• AsRef<str> - The header key (must implement AsRef).
• AsRef<str> - The header value (must implement AsRef).

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn remove_header<K>(&mut self, key: K) -> &mut Response

where K: AsRef<str>,

Removes a header from the response.

This function removes all values for the specified header key.

Arguments

• AsRef<str> - The header key to remove (must implement AsRef).

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn remove_header_value<K, V>(&mut self, key: K, value: V) -> &mut Response

where K: AsRef<str>, V: AsRef<str>,

Removes a specific value from a header in the response.

This function removes only the specified value from the header. If the header has multiple values, only the matching value is removed. If this was the last value for the header, the entire header is removed.

Arguments

• AsRef<str> - The header key (must implement AsRef).
• AsRef<str> - The value to remove (must implement AsRef).

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn clear_headers(&mut self) -> &mut Response

Clears all headers from the response.

This function removes all headers, leaving the headers map empty.

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn set_body<T>(&mut self, body: T) -> &mut Response

where T: AsRef<[u8]>,

Sets the body of the response.

This method allows you to set the body of the response by converting the provided value as_ref a ResponseBody type. The body is updated with the converted value.

Arguments

• AsRef<[u8]> - The body content (must implement AsRef<u8>).

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn set_reason_phrase<T>(&mut self, reason_phrase: T) -> &mut Response

where T: AsRef<str>,

Sets the reason phrase of the response.

This method allows you to set the reason phrase of the response by converting the provided value as_ref a ResponseReasonPhrase type. The reason_phrase is updated with the converted value.

Arguments

• AsRef<str> - The reason phrase (must implement AsRef).

Returns

• &mut Self - A mutable reference to self for chaining.

pub fn build(&mut self) -> Vec<u8>

Builds the full HTTP response as a byte vector.

This method constructs the complete HTTP response, including the status line, headers, and body. It handles content encoding, content type, connection management, and content length.

Returns

• ResponseData - The complete HTTP response bytes.

pub fn get_string(&self) -> String

Converts the response to a formatted string representation.

This method provides a human-readable summary of the response, including its version, status code, reason phrase, headers, and body information.

Returns

A String containing formatted response details.

impl Response

pub fn get_version(&self) -> &HttpVersion

pub fn get_mut_version(&mut self) -> &mut HttpVersion

pub fn set_version(&mut self, val: HttpVersion) -> &mut Response

pub fn get_status_code(&self) -> &usize

pub fn get_mut_status_code(&mut self) -> &mut usize

pub fn set_status_code(&mut self, val: usize) -> &mut Response

pub fn get_reason_phrase(&self) -> &String

pub fn get_mut_reason_phrase(&mut self) -> &mut String

pub fn get_headers( &self, ) -> &HashMap<String, VecDeque<String>, BuildHasherDefault<Hasher>>

pub fn get_mut_headers( &mut self, ) -> &mut HashMap<String, VecDeque<String>, BuildHasherDefault<Hasher>>

pub fn get_body(&self) -> &Vec<u8>

pub fn get_mut_body(&mut self) -> &mut Vec<u8>

Trait Implementations

impl Clone for Response

fn clone(&self) -> Response

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Response

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

Formats the value using the given formatter.

impl Default for Response

Provides a default value for Response.

Returns a new Response instance with all fields initialized to their default values.

fn default() -> Response

Returns the “default value” for a type.

impl Display for Response

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

Formats the value using the given formatter.

impl PartialEq for Response

fn eq(&self, other: &Response) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Response

impl StructuralPartialEq for Response