Enum FramingHeadersMode

#[repr(u32)]
pub enum FramingHeadersMode {
    Automatic = 0,
    ManuallyFromHeaders = 1,
}

Determines how the framing headers (Content-Length/Transfer-Encoding) are set for a request or response.

Variants

Automatic = 0

Determine the framing headers automatically based on the message body, and discard any framing headers already set in the message. This is the default behavior.

In automatic mode, a Content-Length is used when the size of the body can be determined before it is sent. Requests/responses sent in streaming mode, where headers are sent immediately but the content of the body is streamed later, will receive a Transfer-Encoding: chunked to accommodate the dynamic generation of the body.

ManuallyFromHeaders = 1

Use the exact framing headers set in the message, falling back to Automatic if invalid.

In “from headers” mode, any Content-Length or Transfer-Encoding headers will be honored. You must ensure that those headers have correct values permitted by the HTTP/1.1 specification. If the provided headers are not permitted by the spec, the headers will revert to automatic mode and a log diagnostic will be issued about what was wrong. If a Content-Length is permitted by the spec, but the value doesn’t match the size of the actual body, the body will either be truncated (if it is too long), or the connection will be hung up early (if it is too short).

Trait Implementations

impl Clone for FramingHeadersMode

fn clone(&self) -> FramingHeadersMode

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FramingHeadersMode

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

Formats the value using the given formatter.

impl Default for FramingHeadersMode

fn default() -> Self

Returns the “default value” for a type.

impl Hash for FramingHeadersMode

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for FramingHeadersMode

fn cmp(&self, other: &FramingHeadersMode) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for FramingHeadersMode

fn eq(&self, other: &FramingHeadersMode) -> 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 PartialOrd for FramingHeadersMode

fn partial_cmp(&self, other: &FramingHeadersMode) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for FramingHeadersMode

impl Eq for FramingHeadersMode

impl StructuralPartialEq for FramingHeadersMode