Struct RequestHead 

pub struct RequestHead { /* private fields */ }

A canonical, transport-independent HTTP request head.

Carries the method, request target, HTTP version, and headers from an HTTP request. Immutable after construction.

Hyper independence

No Hyper type appears in this struct or its public API. Downstream code can inspect requests using only public eggserve types.

Construction

Build through validated constructors or from the runtime adapter (Hyper → canonical conversion).

Implementations

impl RequestHead

pub fn new( method: Method, target: RequestTarget, version: HttpVersion, headers: HeaderBlock, ) -> Self

Create a new request head.

Prefer using Self::try_from_hyper for converting from Hyper requests. This constructor is for direct construction in tests or downstream code that already has validated components.

pub fn method(&self) -> &Method

Returns the request method.

pub fn target(&self) -> &RequestTarget

Returns the request target.

pub fn version(&self) -> HttpVersion

Returns the HTTP version.

pub fn headers(&self) -> &HeaderBlock

Returns the header block.

pub fn is_head(&self) -> bool

Returns true if this is a HEAD request.

pub fn is_get(&self) -> bool

Returns true if this is a GET request.

pub fn permits_static_resolution(&self) -> bool

Returns true if the method permits static file resolution.

pub fn try_from_hyper<B>(req: &Request<B>) -> Result<Self, RequestHeadError>

Convert a Hyper request into a canonical RequestHead.

Extracts method, URI, version, and headers from the Hyper request without consuming the body. The conversion is fallible and typed: malformed or unsupported input is rejected before handlers.

Errors

Returns RequestHeadError if the request target, version, or headers are invalid.

Trait Implementations

impl Clone for RequestHead

fn clone(&self) -> RequestHead

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestHead

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

Formats the value using the given formatter.