Struct scrappy_http::http::header::Accept

pub struct Accept(pub Vec<QualityItem<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

extern crate mime;
use scrappy_http::Response;
use scrappy_http::http::header::{Accept, qitem};

let mut builder = Response::Ok();

builder.set(
    Accept(vec![
        qitem(mime::TEXT_HTML),
    ])
);

extern crate mime;
use scrappy_http::Response;
use scrappy_http::http::header::{Accept, qitem};

let mut builder = Response::Ok();

builder.set(
    Accept(vec![
        qitem(mime::APPLICATION_JSON),
    ])
);

extern crate mime;
use scrappy_http::Response;
use scrappy_http::http::header::{Accept, QualityItem, q, qitem};

let mut builder = Response::Ok();

builder.set(
    Accept(vec![
        qitem(mime::TEXT_HTML),
        qitem("application/xhtml+xml".parse().unwrap()),
        QualityItem::new(
            mime::TEXT_XML,
            q(900)
        ),
        qitem("image/webp".parse().unwrap()),
        QualityItem::new(
            mime::STAR_STAR,
            q(800)
        ),
    ])
);

Methods

impl Accept

pub fn star() -> Accept

A constructor to easily create Accept: */*.

pub fn json() -> Accept

A constructor to easily create Accept: application/json.

pub fn text() -> Accept

A constructor to easily create Accept: text/*.

pub fn image() -> Accept

A constructor to easily create Accept: image/*.

Trait Implementations

impl Clone for Accept

fn clone(&self) -> Accept

Returns a copy 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 Deref for Accept

type Target = Vec<QualityItem<Mime>>

The resulting type after dereferencing.

fn deref(&self) -> &Vec<QualityItem<Mime>>

Dereferences the value.

impl DerefMut for Accept

fn deref_mut(&mut self) -> &mut Vec<QualityItem<Mime>>

Mutably dereferences the value.

impl Display for Accept

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

Formats the value using the given formatter.

impl Header for Accept

fn name() -> HeaderName

Returns the name of the header field

fn parse<T>(msg: &T) -> Result<Self, ParseError> where
    T: HttpMessage, 

Parse a header

impl IntoHeaderValue for Accept

type Error = InvalidHeaderValue

The type returned in the event of a conversion error.

fn try_into(self) -> Result<HeaderValue, Self::Error>

Try to convert value to a Header value.

impl PartialEq<Accept> for Accept

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

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

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

This method tests for !=.

impl StructuralPartialEq for Accept