Struct Via

pub struct Via(/* private fields */);

The Via general header is added by proxies, both forward and reverse.

This header can appear in the request or response headers. It is used for tracking message forwards, avoiding request loops, and identifying the protocol capabilities of senders along the request/response chain.

It is recommended to use the Forwarded header instead if you can.

More info can be found at https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Via.

Syntax

Via: [ <protocol-name> "/" ] <protocol-version> <host> [ ":" <port> ]
Via: [ <protocol-name> "/" ] <protocol-version> <pseudonym>

Example values

• 1.1 vegur
• HTTP/1.1 GWA
• 1.0 fred, 1.1 p.example.net
• HTTP/1.1 proxy.example.re, 1.1 edge_1
• 1.1 2e9b3ee4d534903f433e1ed8ea30e57a.cloudfront.net (CloudFront)

Trait Implementations

impl Clone for Via

fn clone(&self) -> Via

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Via

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

Formats the value using the given formatter.

impl ForwardHeader for Via

fn try_from_forwarded<'a, I>(input: I) -> Option<Self>

where I: IntoIterator<Item = &'a ForwardedElement>,

Try to convert the given iterator of ForwardedElement into the header.

impl Header for Via

fn name() -> &'static HeaderName

The name of this header.

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

Decode this type from an iterator of HeaderValues.

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) -> HeaderValue

Encode this Header to HeaderValue.

impl IntoIterator for Via

type Item = ForwardedElement

The type of the elements being iterated over.

type IntoIter = ViaIterator

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Via

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

impl StructuralPartialEq for Via