pub enum IfRange {
EntityTag(EntityTag),
Date(HttpDate),
}
Expand description
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§
source§impl Header for IfRange
impl Header for IfRange
source§fn name() -> HeaderName
fn name() -> HeaderName
source§fn parse<T>(msg: &T) -> Result<Self, ParseError>where
T: HttpMessage,
fn parse<T>(msg: &T) -> Result<Self, ParseError>where
T: HttpMessage,
source§impl PartialEq for IfRange
impl PartialEq for IfRange
source§impl TryIntoHeaderValue for IfRange
impl TryIntoHeaderValue for IfRange
§type Error = InvalidHeaderValue
type Error = InvalidHeaderValue
source§fn try_into_value(self) -> Result<HeaderValue, Self::Error>
fn try_into_value(self) -> Result<HeaderValue, Self::Error>
impl Eq for IfRange
impl StructuralPartialEq for IfRange
Auto Trait Implementations§
impl Freeze for IfRange
impl RefUnwindSafe for IfRange
impl Send for IfRange
impl Sync for IfRange
impl Unpin for IfRange
impl UnwindSafe for IfRange
Blanket Implementations§
source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
source§default unsafe fn clone_to_uninit(&self, dst: *mut T)
default unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§impl<Q, K> Equivalent<K> for Q
impl<Q, K> Equivalent<K> for Q
source§fn equivalent(&self, key: &K) -> bool
fn equivalent(&self, key: &K) -> bool
key
and return true
if they are equal.