Struct Method 

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

A validated HTTP method.

Standard methods (GET, HEAD, POST, PUT, DELETE, PATCH, OPTIONS, TRACE, CONNECT) are recognized. Extension methods are preserved without information loss.

Case sensitivity

HTTP methods are case-sensitive per RFC 9110 section 9.1. Method preserves the original casing.

Validation

A valid method is a non-empty sequence of visible ASCII characters (code points 0x21–0x7E) excluding separators. This matches the token production in RFC 9110.

Implementations

impl Method

pub fn new(value: impl Into<String>) -> Result<Self, MethodError>

Create a validated method from a string.

Errors

Returns MethodError if the string is empty or contains invalid characters.

pub fn get() -> Self

Create a Method for GET.

pub fn head() -> Self

Create a Method for HEAD.

pub fn post() -> Self

Create a Method for POST.

pub fn put() -> Self

Create a Method for PUT.

pub fn delete() -> Self

Create a Method for DELETE.

pub fn patch() -> Self

Create a Method for PATCH.

pub fn options() -> Self

Create a Method for OPTIONS.

pub fn trace() -> Self

Create a Method for TRACE.

pub fn connect() -> Self

Create a Method for CONNECT.

pub fn as_str(&self) -> &str

Returns the method as a string slice.

pub fn is_get(&self) -> bool

Returns true if this is GET.

pub fn is_head(&self) -> bool

Returns true if this is HEAD.

pub fn is_safe(&self) -> bool

Returns true if the method is safe (does not modify resources).

Safe methods are GET, HEAD, OPTIONS, and TRACE per RFC 9110 section 9.2.1.

pub fn is_idempotent(&self) -> bool

Returns true if the method is idempotent.

Idempotent methods are GET, HEAD, PUT, DELETE, and OPTIONS per RFC 9110 section 9.2.2. TRACE is also idempotent by definition.

pub fn permits_static_resolution(&self) -> bool

Returns true if this method permits static file resolution.

The built-in static service only supports GET and HEAD. This method provides a policy helper without conflating method identity with server policy.

Trait Implementations

impl AsRef<str> for Method

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

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

Formats the value using the given formatter.

impl Display for Method

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

Formats the value using the given formatter.

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, 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