Struct Expires

pub struct Expires { /* private fields */ }

HTTP Expires header

Specifications

• RFC 7234, section 5.3: Expires

Examples

use http_types::Response;
use http_types::cache::Expires;
use std::time::{SystemTime, Duration};

let time = SystemTime::now() + Duration::from_secs(5 * 60);
let expires = Expires::new_at(time);

let mut res = Response::new(200);
expires.apply(&mut res);

let expires = Expires::from_headers(res)?.unwrap();

// HTTP dates only have second-precision.
let elapsed = time.duration_since(expires.expiration())?;
assert_eq!(elapsed.as_secs(), 0);

Implementations

impl Expires

pub fn new(dur: Duration) -> Self

Create a new instance of Expires.

pub fn new_at(instant: SystemTime) -> Self

Create a new instance of Expires from secs.

pub fn expiration(&self) -> SystemTime

Get the expiration time.

pub fn from_headers(headers: impl AsRef<Headers>) -> Result<Option<Self>>

Create an instance of Expires from a Headers instance.

pub fn apply(&self, headers: impl AsMut<Headers>)

Insert a HeaderName + HeaderValue pair into a Headers instance.

pub fn name(&self) -> HeaderName

Get the HeaderName.

pub fn value(&self) -> HeaderValue

Get the HeaderValue.

Trait Implementations

impl Debug for Expires

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

Formats the value using the given formatter.

impl Ord for Expires

fn cmp(&self, other: &Expires) -> 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 Expires

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

fn partial_cmp(&self, other: &Expires) -> 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 ToHeaderValues for Expires

type Iter = IntoIter<HeaderValue>

Returned iterator over header values which this type may correspond to.

fn to_header_values(&self) -> Result<Self::Iter>

Converts this object to an iterator of resolved HeaderValues.

impl Eq for Expires

impl StructuralPartialEq for Expires