Struct HostRouter 

pub struct HostRouter { /* private fields */ }

Routes requests to different axum Routers based on the Host header.

Supports exact host matches (acme.com, app.acme.com) and single-level wildcard subdomains (*.acme.com). Both use HashMap lookups for O(1) matching.

Panics

The host and fallback methods panic if called after the HostRouter has been cloned or converted. Complete all route registration before passing the router to server::http() or cloning it.

The host method also panics on:

• Duplicate exact host patterns
• Duplicate wildcard suffixes
• Invalid wildcard patterns (suffix must contain at least one dot)

Example

use modo::server::HostRouter;
use axum::Router;

let app = HostRouter::new()
    .host("acme.com", Router::new())
    .host("app.acme.com", Router::new())
    .host("*.acme.com", Router::new())
    .fallback(Router::new());

Implementations

impl HostRouter

pub fn new() -> Self

Create a new empty HostRouter with no registered hosts and no fallback.

pub fn host(self, pattern: &str, router: Router) -> Self

Register a host pattern with a router.

Exact patterns (e.g. "acme.com", "app.acme.com") match the host literally. Wildcard patterns (e.g. "*.acme.com") match any single subdomain level.

Panics

• If an exact host is registered twice.
• If a wildcard suffix is registered twice.
• If a wildcard suffix contains no dot (e.g. "*.com").

pub fn fallback(self, router: Router) -> Self

Set a fallback router for requests whose host doesn’t match any pattern.

If no fallback is set, unmatched hosts receive a 404 response.

Trait Implementations

impl Clone for HostRouter

fn clone(&self) -> HostRouter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostRouter

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

Formats the value using the given formatter.

impl Default for HostRouter

fn default() -> Self

Returns the “default value” for a type.

impl From<HostRouter> for Router

fn from(host_router: HostRouter) -> Router

Converts to this type from the input type.