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<(), Error>

Formats the value using the given formatter.

impl ForwardHeader for Via

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

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

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

impl FromIterator<ViaElement> for Via

fn from_iter<T>(iter: T) -> Via

where T: IntoIterator<Item = ViaElement>,

Creates a value from an iterator.

impl HeaderDecode for Via

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

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

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for Via

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

where E: Extend<HeaderValue>,

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) -> <Via as IntoIterator>::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 TypedHeader for Via

fn name() -> &'static HeaderName

The name of this header.

impl Eq for Via

impl StructuralPartialEq for Via