Enum actix_web::http::header::IfRange[][src]

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

If-Range header, defined in RFC7233

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_http::Response;
use actix_http::http::header::{EntityTag, IfRange};

let mut builder = Response::Ok();
builder.set(IfRange::EntityTag(EntityTag::new(
    false,
    "xyzzy".to_owned(),
)));
use actix_http::Response;
use actix_http::http::header::IfRange;
use std::time::{Duration, SystemTime};

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

Variants

EntityTag(EntityTag)

Tuple Fields

The entity-tag the client has of the resource

Date(HttpDate)

Tuple Fields

The date when the client retrieved the resource

Trait Implementations

Returns a copy of the value. Read more

Performs copy-assignment from source. Read more

Formats the value using the given formatter. Read more

Formats the value using the given formatter. Read more

Returns the name of the header field

Parse a header

The type returned in the event of a conversion error.

Try to convert value to a Header value.

This method tests for self and other values to be equal, and is used by ==. Read more

This method tests for !=.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more

Immutably borrows from an owned value. Read more

Mutably borrows from an owned value. Read more

Performs the conversion.

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Performs the conversion.

Should always be Self

The resulting type after obtaining ownership.

Creates owned data from borrowed data, usually by cloning. Read more

🔬 This is a nightly-only experimental API. (toowned_clone_into)

Uses borrowed data to replace owned data, usually by cloning. Read more

Converts the given value to a String. Read more

The type returned in the event of a conversion error.

Performs the conversion.

The type returned in the event of a conversion error.

Performs the conversion.

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more