Enum tide::http::conditional::ETag

pub enum ETag {
    Strong(String),
    Weak(String),
}

HTTP Entity Tags.

ETags provide an ID for a particular resource, enabling clients and servers to reason about caches and make conditional requests.

Specifications

• RFC 7232, section 2.3: ETag

Examples

use http_types::Response;
use http_types::conditional::ETag;

let etag = ETag::new("0xcafebeef".to_string());

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

let etag = ETag::from_headers(res)?.unwrap();
assert_eq!(etag, ETag::Strong(String::from("0xcafebeef")));

Variants

Strong(String)

An ETag using strong validation.

Weak(String)

An ETag using weak validation.

Implementations

impl ETag

pub fn new(s: String) -> ETag

Create a new ETag that uses strong validation.

pub fn new_weak(s: String) -> ETag

Create a new ETag that uses weak validation.

pub fn from_headers(headers: impl AsRef<Headers>) -> Result<Option<ETag>, Error>

Create a new instance from headers.

Only a single ETag per resource is assumed to exist. If multiple ETag headers are found the last one is used.

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

Sets the ETag header.

pub fn name(&self) -> HeaderName

Get the HeaderName.

pub fn value(&self) -> HeaderValue

Get the HeaderValue.

pub fn is_strong(&self) -> bool

Returns true if the ETag is a Strong value.

pub fn is_weak(&self) -> bool

Returns true if the ETag is a Weak value.

Trait Implementations

impl Clone for ETag

pub fn clone(&self) -> ETag

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ETag

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

Formats the value using the given formatter.

impl Display for ETag

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

Formats the value using the given formatter.

impl Eq for ETag

impl PartialEq<ETag> for ETag

pub fn eq(&self, other: &ETag) -> bool

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

pub fn ne(&self, other: &ETag) -> bool

This method tests for !=.

impl StructuralEq for ETag

impl StructuralPartialEq for ETag

impl ToHeaderValues for ETag

type Iter = IntoIter<HeaderValue>

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

pub fn to_header_values(&self) -> Result<<ETag as ToHeaderValues>::Iter, Error>

Converts this object to an iterator of resolved HeaderValues.