Enum IfRange

pub enum IfRange {
    EntityTag(EntityTag),
    Date(HttpDate),
}

If-Range header, defined in RFC 7233 §3.2

If a client has a partial copy of a representation and wishes to have an up-to-date copy of the entire representation, it could use the Range header field with a conditional GET (using either or both of If-Unmodified-Since and If-Match.) However, if the precondition fails because the representation has been modified, the client would then have to make a second request to obtain the entire current representation.

The If-Range header field allows a client to "short-circuit" the second request. Informally, its meaning is as follows: if the representation is unchanged, send me the part(s) that I am requesting in Range; otherwise, send me the entire representation.

ABNF

If-Range = entity-tag / HTTP-date

Example Values

• Sat, 29 Oct 1994 19:43:31 GMT
• \"xyzzy\"

Examples

use actix_web::HttpResponse;
use actix_web::http::header::{EntityTag, IfRange};

let mut builder = HttpResponse::Ok();
builder.insert_header(
    IfRange::EntityTag(
        EntityTag::new(false, "abc".to_owned())
    )
);

use std::time::{Duration, SystemTime};
use actix_web::{http::header::IfRange, HttpResponse};

let mut builder = HttpResponse::Ok();
let fetched = SystemTime::now() - Duration::from_secs(60 * 60 * 24);
builder.insert_header(
    IfRange::Date(fetched.into())
);

Variants

EntityTag(EntityTag)

The entity-tag the client has of the resource.

Date(HttpDate)

The date when the client retrieved the resource.

Trait Implementations

impl Clone for IfRange

fn clone(&self) -> IfRange

Returns a copy 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 Display for IfRange

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

Formats the value using the given formatter.

impl Header for IfRange

fn name() -> HeaderName

Returns the name of the header field.

fn parse<T>(msg: &T) -> Result<Self, ParseError>

where T: HttpMessage,

Parse the header from a HTTP message.

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 TryIntoHeaderValue for IfRange

type Error = InvalidHeaderValue

The type returned in the event of a conversion error.

fn try_into_value(self) -> Result<HeaderValue, Self::Error>

Try to convert value to a HeaderValue.

impl Eq for IfRange

impl StructuralPartialEq for IfRange