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. The effective host is resolved from the Forwarded (RFC 7239), X-Forwarded-Host, or Host header, in that order; the value is lowercased and any trailing :port is stripped before matching.

HostRouter implements Into<axum::Router> and can therefore be passed directly to http().

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:

• Empty host patterns
• Duplicate exact host patterns
• Duplicate wildcard suffixes
• Malformed wildcard patterns (must be *.suffix where the suffix contains at least one dot; a bare * or *.com is rejected)

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. The pattern is trimmed, lowercased, and stripped of any :port suffix before registration.

Panics

• If self has already been cloned or converted to an axum::Router.
• If the pattern is empty after trimming.
• If a bare * or a leading * not followed by . is supplied.
• If an exact host is registered twice.
• If a wildcard suffix is registered twice.
• If a wildcard suffix is empty or 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.

Panics

Panics if self has already been cloned or converted to an axum::Router.

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.