Struct Origin 

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

The Origin header.

The Origin header is a version of the Referer header that is used for all HTTP fetches and POSTs whose CORS flag is set. This header is often used to inform recipients of the security context of where the request was initiated.

Following the spec, https://fetch.spec.whatwg.org/#origin-header, the value of this header is composed of a String (scheme), Host (host/port)

Examples

use rama_http_headers::Origin;

let origin = Origin::NULL;

Implementations

impl Origin

pub const NULL: Origin

The literal null Origin header.

pub fn is_null(&self) -> bool

Checks if Origin is null.

pub fn scheme(&self) -> &str

Get the “scheme” part of this origin.

pub fn hostname(&self) -> Cow<'_, str>

Get the “hostname” part of this origin.

pub fn port(&self) -> Option<u16>

Get the “port” part of this origin.

pub fn try_from_parts( scheme: &str, host: &str, port: impl Into<Option<u16>>, ) -> Result<Origin, InvalidOrigin>

Tries to build a Origin from three parts, the scheme, the host and an optional port.

pub fn try_from_header_value(value: &HeaderValue) -> Option<Origin>

Try to parse an Origin header value.

Returns None for invalid origins, including values with a path other than /, query, or fragment.

Trait Implementations

impl Clone for Origin

fn clone(&self) -> Origin

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Origin

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

Formats the value using the given formatter.

impl Display for Origin

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

Formats the value using the given formatter.

impl Eq for Origin

impl Hash for Origin

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl HeaderDecode for Origin

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

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

Decode this type from an iterator of HeaderValues.

impl HeaderEncode for Origin

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

Encode this header to HeaderValue.

impl PartialEq for Origin

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

impl TypedHeader for Origin

fn name() -> &'static HeaderName

The name of this header.