Struct http::method::Method

pub struct Method(_);

The Request Method (VERB)

This type also contains constants for a number of common HTTP methods such as GET, POST, etc.

Currently includes 8 variants representing the 8 methods defined in RFC 7230, plus PATCH, and an Extension variant for all extensions.

Examples

use http::Method;

assert_eq!(Method::GET, Method::from_bytes(b"GET").unwrap());
assert!(Method::GET.is_idempotent());
assert_eq!(Method::POST.as_str(), "POST");

Methods

impl Method

pub const GET: Method

GET: Method = Method(Get)

GET

pub const POST: Method

POST: Method = Method(Post)

POST

pub const PUT: Method

PUT: Method = Method(Put)

PUT

pub const DELETE: Method

DELETE: Method = Method(Delete)

DELETE

pub const HEAD: Method

HEAD: Method = Method(Head)

HEAD

pub const OPTIONS: Method

OPTIONS: Method = Method(Options)

OPTIONS

pub const CONNECT: Method

CONNECT: Method = Method(Connect)

CONNECT

pub const PATCH: Method

PATCH: Method = Method(Patch)

PATCH

pub const TRACE: Method

TRACE: Method = Method(Trace)

TRACE

pub fn from_bytes(src: &[u8]) -> Result<Method, InvalidMethod>

Converts a slice of bytes to an HTTP method.

pub fn is_safe(&self) -> bool

Whether a method is considered "safe", meaning the request is essentially read-only.

See the spec for more words.

pub fn is_idempotent(&self) -> bool

Whether a method is considered "idempotent", meaning the request has the same result if executed multiple times.

See the spec for more words.

pub fn as_str(&self) -> &str

Return a &str representation of the HTTP method

Trait Implementations

impl Clone for Method

fn clone(&self) -> Method

Returns a copy of the value.

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

Performs copy-assignment from source.

impl PartialEq for Method

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

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

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

This method tests for !=.

impl Eq for Method

impl Hash for Method

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

Feeds this value into the given [Hasher].

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

Feeds a slice of this type into the given [Hasher].

impl AsRef<str> for Method

fn as_ref(&self) -> &str

Performs the conversion.

impl PartialEq<str> for Method

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

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

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

This method tests for !=.

impl<'a> PartialEq<&'a str> for Method

fn eq(&self, other: &&'a str) -> bool

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

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

This method tests for !=.

impl Debug for Method

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

Formats the value using the given formatter.

impl Display for Method

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

Formats the value using the given formatter.

impl Default for Method

fn default() -> Method

Returns the "default value" for a type.

impl<'a> HttpTryFrom<&'a [u8]> for Method

type Error = InvalidMethod

Associated error with the conversion this implementation represents.

fn try_from(t: &'a [u8]) -> Result<Self, Self::Error>

impl<'a> HttpTryFrom<&'a str> for Method

type Error = InvalidMethod

Associated error with the conversion this implementation represents.

fn try_from(t: &'a str) -> Result<Self, Self::Error>

impl FromStr for Method

type Err = InvalidMethod

The associated error which can be returned from parsing.

fn from_str(t: &str) -> Result<Self, Self::Err>

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

impl HttpTryFrom<Method> for Method

type Error = Error

Associated error with the conversion this implementation represents.

fn try_from(t: Self) -> Result<Self, Self::Error>