Struct ServeMux 

pub struct ServeMux { /* private fields */ }

HTTP request multiplexer. Port of Go’s http.ServeMux (Go 1.22+).

Matching rules:

1. More-specific patterns beat less-specific ones (method + host > host > path).
2. Literal path segments beat wildcard segments; wildcards beat tail wildcards.
3. Exact path beats trailing-slash subtree of the same length.
4. Among equally-specific patterns, longer paths win.
5. A pattern matching path but not method returns 405 Method Not Allowed.

Implementations

impl ServeMux

pub fn new() -> Self

pub fn handle(&self, pattern: &str, handler: impl Handler + 'static)

Register a handler for the given pattern.

Pattern syntax: [METHOD ][HOST]/PATH

Example	Meaning
/	subtree catch-all (old-style)
/api/v2/	subtree prefix
/items/{id}	single wildcard segment
/files/{path...}	tail wildcard (matches rest of path)
GET /api/users	method-restricted exact route
example.com/	host-restricted subtree
GET example.com/{id}	method + host + wildcard

pub fn handle_func<F>(&self, pattern: &str, f: F)

where F: Fn(&mut dyn ResponseWriter, &mut Request) + Send + Sync + 'static,

Register a function as a handler.

pub fn match_handler(&self, path: &str) -> Option<Arc<dyn Handler>>

Find the best matching handler for a bare path (no method/host filtering). Retained for backward compatibility; prefer the full serve_http path for new code.

Trait Implementations

impl Default for ServeMux

fn default() -> Self

Returns the “default value” for a type.

impl Handler for ServeMux

fn serve_http(&self, w: &mut dyn ResponseWriter, r: &mut Request)