Struct RequestHeader

pub struct RequestHeader { /* private fields */ }

Represents an HTTP request header.

This struct wraps a http::Request<()> to provide:

• Access to standard HTTP header fields
• Conversion from different request formats
• Body attachment capabilities
• Request metadata inspection

Implementations

impl RequestHeader

pub fn into_inner(self) -> Request<()>

Consumes the header and returns the inner Request<()>.

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

Attaches a body to this header, converting it into a full Request<T>.

This is typically used after header parsing to attach the parsed body.

pub fn method(&self) -> &Method

Returns a reference to the request’s HTTP method.

pub fn uri(&self) -> &Uri

Returns a reference to the request’s URI.

pub fn version(&self) -> Version

Returns the request’s HTTP version.

pub fn headers(&self) -> &HeaderMap

Returns a reference to the request’s headers.

pub fn need_body(&self) -> bool

Determines if this request requires a body based on its HTTP method.

Returns false for methods that typically don’t have bodies:

• GET
• HEAD
• DELETE
• OPTIONS
• CONNECT

Trait Implementations

impl AsMut<Request<()>> for RequestHeader

fn as_mut(&mut self) -> &mut Request<()>

Converts this type into a mutable reference of the (usually inferred) input type.

impl AsRef<Request<()>> for RequestHeader

fn as_ref(&self) -> &Request<()>

Converts this type into a shared reference of the (usually inferred) input type.

impl Debug for RequestHeader

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

Formats the value using the given formatter.

impl From<Parts> for RequestHeader

Converts request parts into a RequestHeader.

fn from(parts: Parts) -> Self

Converts to this type from the input type.

impl<'headers, 'buf> From<Request<'headers, 'buf>> for RequestHeader

Converts a parsed HTTP request into a RequestHeader.

This implementation handles the conversion from the low-level parsed request format into our RequestHeader type, setting up:

• HTTP method
• URI/path
• HTTP version
• Headers

fn from(req: Request<'headers, 'buf>) -> Self

Converts to this type from the input type.

impl From<Request<()>> for RequestHeader

Converts a bodyless request into a RequestHeader.

fn from(inner: Request<()>) -> Self

Converts to this type from the input type.