Struct hyper::header::Origin

pub struct Origin(_);

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), header::Host (host/port)

Examples

use hyper::header::{Headers, Origin};

let mut headers = Headers::new();
headers.set(
    Origin::new("http", "hyper.rs", None)
);

use hyper::header::{Headers, Origin};

let mut headers = Headers::new();
headers.set(
    Origin::new("https", "wikipedia.org", Some(443))
);

Methods

impl Origin

pub fn new<S: Into<Cow<'static, str>>, H: Into<Cow<'static, str>>>(
    scheme: S,
    hostname: H,
    port: Option<u16>
) -> Origin

Creates a new Origin header.

pub fn null() -> Origin

Creates a Null Origin header.

pub fn is_null(&self) -> bool

Checks if Origin is Null.

pub fn scheme(&self) -> Option<&str>

The scheme, such as http or https.

use hyper::header::Origin;
let origin = Origin::new("https", "foo.com", Some(443));
assert_eq!(origin.scheme(), Some("https"));

pub fn host(&self) -> Option<&Host>

The host, such as Host { hostname: "hyper.rs".to_owned(), port: None}.

use hyper::header::{Origin,Host};
let origin = Origin::new("https", "foo.com", Some(443));
assert_eq!(origin.host(), Some(&Host::new("foo.com", Some(443))));

Trait Implementations

impl PartialEq for Origin

fn eq(&self, __arg_0: &Origin) -> bool

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

fn ne(&self, __arg_0: &Origin) -> bool

This method tests for !=.

impl Clone for Origin

fn clone(&self) -> Origin

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Origin

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

Formats the value using the given formatter.

impl Header for Origin

fn header_name() -> &'static str

Returns the name of the header field this belongs to.

fn parse_header(raw: &Raw) -> Result<Origin>

Parse a header from a raw stream of bytes.

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

Format a header to outgoing stream.

impl FromStr for Origin

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Origin>

Parses a string s to return a value of this type.

impl Display for Origin

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

Formats the value using the given formatter.