Enum IfRange 

pub enum IfRange {
    Date(HeaderValue),
    ETag(HeaderValue),
}

A typed HTTP If-Range header.

Per RFC 9110 Section 13.1.5, If-Range can contain either an HTTP-date or an entity-tag. When present alongside a Range header, the server must evaluate the validator against the current representation:

• If the validator matches, the Range is honored (206 Partial Content).
• If the validator does not match, the Range is ignored and the full representation is served (200 OK).

Variants

Date(HeaderValue)

An HTTP-date validator (the raw header value, to be compared with Last-Modified).

ETag(HeaderValue)

An entity-tag validator (the raw header value, to be compared with ETag).

Implementations

impl IfRange

pub fn evaluate( &self, range: HttpRange, last_modified: Option<&HeaderValue>, etag: Option<&HeaderValue>, ) -> Option<HttpRange>

Evaluates the If-Range condition and returns the HttpRange only if the condition holds.

• range: the parsed Range header value.
• last_modified: the current Last-Modified header of the representation.
• etag: the current ETag header of the representation.

Returns Some(range) if the validator matches (the range should be honored), or None if it does not (the full representation should be served).

Per RFC 9110 Section 13.1.5, the comparison uses the raw header values:

• For dates, the If-Range value must be an exact byte-for-byte match of the Last-Modified header value.
• For entity-tags, the If-Range value must be a strong comparison match against the ETag header value. Weak entity-tags never match.

Trait Implementations

impl Clone for IfRange

fn clone(&self) -> IfRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IfRange

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

Formats the value using the given formatter.

impl FromStr for IfRange

type Err = InvalidIfRange

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<S> OptionalFromRequestParts<S> for IfRange

where S: Send + Sync,

Available on crate feature axum only.

type Rejection = Infallible

If the extractor fails, it will use this “rejection” type.

async fn from_request_parts( parts: &mut Parts, _state: &S, ) -> Result<Option<Self>, Self::Rejection>

Perform the extraction.

impl PartialEq for IfRange

fn eq(&self, other: &IfRange) -> 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 TryFrom<&HeaderValue> for IfRange

type Error = InvalidIfRange

The type returned in the event of a conversion error.

fn try_from(value: &HeaderValue) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for IfRange

impl StructuralPartialEq for IfRange