Struct Request 

pub struct Request { /* private fields */ }

Available on crate features icap and std only.

An owned, validated ICAP request head and encapsulated prefix.

Implementations

impl Request

pub fn new( line: RequestLine<'_>, headers: &[Header<'_>], encapsulated: Option<EncapsulatedParts>, ) -> Result<Request, BuildError>

Encode an ICAP request without Preview.

pub fn with_preview( line: RequestLine<'_>, headers: &[Header<'_>], encapsulated: EncapsulatedParts, preview: Preview, ) -> Result<Request, BuildError>

Encode an ICAP request with an explicit Preview limit.

pub const fn method(&self) -> MethodKind

Return the lifetime-free request method.

pub const fn preview(&self) -> Option<Preview>

Return the Preview limit, when enabled.

pub const fn encapsulated(&self) -> Option<&EncapsulatedParts>

Return the encapsulated metadata, when present.

pub fn try_with_original_body_len(self, len: u64) -> Result<Request, BuildError>

Declare the exact length of the original HTTP entity body.

This is local client metadata and is not encoded on the wire. It lets the client validate use-original-body in an early 206 response, before the complete original body has been sent.

pub fn try_set_original_body_len( &mut self, len: u64, ) -> Result<&mut Request, BuildError>

Declare the exact length of the original HTTP entity body.

This is local client metadata and is not encoded on the wire. It lets the client validate use-original-body in an early 206 response, before the complete original body has been sent.

pub const fn original_body_len(&self) -> Option<u64>

Return the declared exact original HTTP entity-body length.

pub const fn allows_204(&self) -> bool

Return whether a 204 response was negotiated outside Preview.

pub const fn allows_206(&self) -> bool

Return whether the Partial Content extension was negotiated.

pub const fn allows_icap_trailers(&self) -> bool

Return whether the request offers negotiated outer ICAP trailers.

pub const fn head_bytes(&self) -> &Bytes

Return the encoded ICAP head.

pub const fn should_close(&self) -> bool

Return whether this message asks to close the connection.

pub fn parse_head<'headers>( &self, slots: &'headers mut [HeaderSlot], ) -> Result<RequestHead<'headers, '_>, ParseError>

Decode the owned head into caller-provided header slots.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.