Enum Method 

pub enum Method {
    Get,
    Head,
    Post,
    Put,
    Delete,
    Connect,
    Options,
    Trace,
    Patch,
    Query,
    Other(ByteStr),
}

An HTTP request method.

Well-known methods are unit variants, so dispatch is a discriminant comparison rather than a string comparison. Unrecognized methods carry a ByteStr slice of the read buffer.

Variants

Get

GET

Head

HEAD

Post

POST

Put

PUT

Delete

DELETE

Connect

CONNECT

Options

OPTIONS

Trace

TRACE

Patch

PATCH

Query

QUERY — a safe method that carries a request body.

Other(ByteStr)

Any other valid method token.

Implementations

impl Method

pub fn from_bytes(token: &[u8]) -> Option<Method>

Match a method token against the well-known set.

Returns None when the token is not well-known; the caller then builds Method::Other from the read buffer. Keeping Bytes out of this signature is what makes the function trivially unit-testable.

Methods are case-sensitive (RFC 9110 section 9.1), so this compares exactly. Dispatching on length first means most calls do one integer comparison and one short memcmp.

pub fn as_str(&self) -> &str

The method token as a string.

pub fn is_safe(&self) -> bool

Whether this method is safe per RFC 9110 section 9.2.1.

Unrecognized methods are conservatively treated as unsafe.

pub fn expects_response_body(&self) -> bool

Whether a response to this method may carry a body.

HEAD responses carry headers only, including the Content-Length the equivalent GET would have produced (RFC 9112 section 6.3).

Trait Implementations

impl Clone for Method

fn clone(&self) -> Method

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Method

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

Formats the value using the given formatter.

impl Display for Method

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

Formats the value using the given formatter.

impl Eq for Method

impl From<&str> for Method

fn from(token: &str) -> Method

Parse a method token, falling back to Method::Other.

Infallible on purpose: this exists so armature-core’s constructors can take impl Into<Method> and keep every existing HttpRequest::new("GET") call site compiling. An invalid token is not rejected here — it is carried as Other and answered by routing, which is where a 405 belongs.

impl From<HttpMethod> for Method

fn from(m: HttpMethod) -> Self

Converts to this type from the input type.

impl From<String> for Method

fn from(token: String) -> Method

Converts to this type from the input type.

impl Hash for Method

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 PartialEq for Method

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<&str> for Method

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

Equality operator ==.

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

Inequality operator !=.

impl PartialEq<str> for Method

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Method

impl TryFrom<&Method> for HttpMethod

type Error = UnroutableMethod

The type returned in the event of a conversion error.

fn try_from(m: &Method) -> Result<Self, Self::Error>

Performs the conversion.