Struct headers::Upgrade

pub struct Upgrade(_);

Upgrade header, defined in RFC7230

The Upgrade header field is intended to provide a simple mechanism for transitioning from HTTP/1.1 to some other protocol on the same connection. A client MAY send a list of protocols in the Upgrade header field of a request to invite the server to switch to one or more of those protocols, in order of descending preference, before sending the final response. A server MAY ignore a received Upgrade header field if it wishes to continue using the current protocol on that connection. Upgrade cannot be used to insist on a protocol change.

ABNF

Upgrade          = 1#protocol

protocol         = protocol-name ["/" protocol-version]
protocol-name    = token
protocol-version = token

Example values

• HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11

Note

In practice, the Upgrade header is never that complicated. In most cases, it is only ever a single value, such as "websocket".

Examples

use headers::Upgrade;

let ws = Upgrade::websocket();

Implementations

impl Upgrade

pub fn websocket() -> Upgrade

Constructs an Upgrade: websocket header.

Trait Implementations

impl Clone for Upgrade

pub fn clone(&self) -> Upgrade

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Upgrade

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

Formats the value using the given formatter.

impl Header for Upgrade

pub fn name() -> &'static HeaderName

The name of this header.

pub fn decode<'i, I>(values: &mut I) -> Result<Self, Error> where
    I: Iterator<Item = &'i HeaderValue>, 

Decode this type from an iterator of HeaderValues.

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

Encode this type to a HeaderMap.

impl PartialEq<Upgrade> for Upgrade

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

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

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

This method tests for !=.

impl StructuralPartialEq for Upgrade