Struct Builder

pub struct Builder { /* private fields */ }

A builder for constructing Request objects.

The Builder allows setting the HTTP method, version, URL, and headers before building the final Request with a body.

Implementations

impl Builder

pub fn new() -> Self

Creates a new Builder with default values:

• GET method
• HTTP/1.1 version
• URL set to “/”
• Empty headers

pub fn version(self, version: Version) -> Self

Sets the HTTP version of the request.

Parameters

• version: The HTTP version to set (e.g., Version::Http1_1).

Returns

The updated Builder.

pub fn version_mut(&mut self) -> Option<&mut Version>

Returns a mutable reference to the HTTP version.

pub fn method(self, method: Method) -> Self

Sets the HTTP method of the request.

Parameters

• method: The HTTP method to set (e.g., Method::POST).

Returns

The updated Builder.

pub fn method_mut(&mut self) -> Option<&mut Method>

Returns a mutable reference to the HTTP method.

pub fn extensions_mut(&mut self) -> Option<&mut Extensions>

Returns a mutable reference to the extensions.

pub fn uri<T>(self, uri: T) -> Self

where T: TryInto<Uri>, T::Error: Into<InvalidUri>,

Sets the URL of the request.

Parameters

• url: The URL to set.

Returns

The updated Builder.

pub fn uri_mut(&mut self) -> Option<&mut Uri>

Returns a mutable reference to the URL.

pub fn headers(&self) -> Option<&Headers>

Returns a reference to the headers being set in the Builder.

pub fn headers_mut(&mut self) -> Option<&mut Headers>

Returns a mutable reference to the headers being set in the Builder.

pub fn insert_header<K, V>(self, name: K, value: V) -> Self

where K: TryInto<HeaderName>, K::Error: Into<InvalidHeaderName>, V: TryInto<HeaderValue>, V::Error: Into<InvalidHeaderValue>,

Inserts a header into the request.

If the header already exists, it is replaced.

Parameters

• key: The name of the header.
• value: The value of the header.

Returns

The updated Builder.

pub fn append_header<K, V>(self, name: K, value: V) -> Self

where K: TryInto<HeaderName>, K::Error: Into<InvalidHeaderName>, V: TryInto<HeaderValue>, V::Error: Into<InvalidHeaderValue>,

Appends a value to an existing header in the request.

If the header does not exist, it is created.

Parameters

• key: The name of the header.
• value: The value to append.

Returns

The updated Builder.

pub fn body<T>(self, body: T) -> Result<Request<T>, InvalidRequest>

Builds the final Request with the provided body.

Parameters

• body: The content to include in the request body.

Returns

A Request with the method, version, URL, headers, and body.

Trait Implementations

impl Default for Builder

fn default() -> Self

Returns the “default value” for a type.