Struct Accept 

pub struct Accept(pub NonEmptySmallVec<7, QualityValue<Mime>>);

Accept header, defined in RFC7231

The Accept header field can be used by user agents to specify response media types that are acceptable. Accept header fields can be used to indicate that the request is specifically limited to a small set of desired types, as in the case of a request for an in-line image

ABNF

Accept = #( media-range [ accept-params ] )

media-range    = ( "*/*"
                 / ( type "/" "*" )
                 / ( type "/" subtype )
                 ) *( OWS ";" OWS parameter )
accept-params  = weight *( accept-ext )
accept-ext = OWS ";" OWS token [ "=" ( token / quoted-string ) ]

Example values

• audio/*; q=0.2, audio/basic
• text/plain; q=0.5, text/html, text/x-dvi; q=0.8, text/x-c

Examples

use std::iter::FromIterator;
use rama_http_headers::{Accept, specifier::QualityValue, HeaderMapExt};
use rama_http_types::mime;

let mut headers = rama_http_types::HeaderMap::new();

headers.typed_insert(
    Accept::new(
        QualityValue::new(mime::TEXT_HTML, Default::default()),
    )
);

use std::iter::FromIterator;
use rama_http_headers::{Accept, specifier::QualityValue, HeaderMapExt};
use rama_http_types::mime;

let mut headers = rama_http_types::HeaderMap::new();
headers.typed_insert(
    Accept::new(
        QualityValue::new(mime::APPLICATION_JSON, Default::default()),
    )
);

use std::iter::FromIterator;
use rama_utils::collections::non_empty_smallvec;
use rama_http_headers::{Accept, specifier::QualityValue, HeaderMapExt};
use rama_http_types::mime;

let mut headers = rama_http_types::HeaderMap::new();

headers.typed_insert(
    Accept(non_empty_smallvec![
        QualityValue::from(mime::TEXT_HTML),
        QualityValue::from("application/xhtml+xml".parse::<mime::Mime>().unwrap()),
        QualityValue::new(
            mime::TEXT_XML,
            900.into()
        ),
        QualityValue::from("image/webp".parse::<mime::Mime>().unwrap()),
        QualityValue::new(
            mime::STAR_STAR,
            800.into()
        ),
    ])
);

Tuple Fields

0: NonEmptySmallVec<7, QualityValue<Mime>>

Implementations

impl Accept

pub fn new(value: QualityValue<Mime>) -> Self

impl Accept

pub fn new_from_mime(mime: Mime) -> Self

pub fn star() -> Self

A constructor to easily create Accept: */*.

pub fn json() -> Self

A constructor to easily create Accept: application/json.

pub fn text() -> Self

A constructor to easily create Accept: text/*.

pub fn image() -> Self

A constructor to easily create Accept: image/*.

pub fn sort_quality_values(&mut self)

Sort (stable) the inner quality values by quality.

Trait Implementations

impl Clone for Accept

fn clone(&self) -> Accept

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Accept

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

Formats the value using the given formatter.

impl Eq for Accept

impl HeaderDecode for Accept

fn decode<'i, I>(values: &mut I) -> Result<Self, Error>

where I: Iterator<Item = &'i HeaderValue>,

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for Accept

fn encode<E: Extend<HeaderValue>>(&self, values: &mut E)

Encode this type to a HeaderValue, and add it to a container which has HeaderValue type as each element.

fn encode_to_value(&self) -> Option<HeaderValue>

Encode this header to HeaderValue.

impl PartialEq for Accept

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

impl TypedHeader for Accept

fn name() -> &'static HeaderName

The name of this header.