Struct MultiAppDispatcher 

pub struct MultiAppDispatcher { /* private fields */ }

多应用调度器

用于注册多个应用的 Router，并按路径前缀或域名分发。

Implementations

impl MultiAppDispatcher

pub fn new() -> Self

创建空的调度器

pub fn register(&mut self, name: impl Into<String>, router: Router)

注册一个应用（无域名绑定）

参数

• name：应用名（必须与 PHP app_map 中的 key 一致）
• router：该应用的 axum::Router

pub fn register_with_domain( &mut self, name: impl Into<String>, domain: impl Into<String>, router: Router, )

注册一个应用（带域名绑定）

对齐 PHP domain_bind。

参数

• name：应用名
• domain：绑定的域名（如 oapc.example.com）
• router：该应用的 axum::Router

pub fn dispatch_by_path(&self, uri: &str) -> Option<&str>

按路径前缀分发

解析 URI 的第一段（如 /oapc/customer/index → oapc）， 如果该段对应已注册的应用名，则返回应用名。

参数

• uri：请求 URI（如 /oapc/customer/index?id=1）

返回

• Some(app_name)：路径前缀匹配到已注册应用
• None：未匹配（应该走默认应用 index）

pub fn dispatch_by_domain(&self, host: &str) -> Option<&str>

按域名分发

对齐 PHP domain_bind：如果请求的 Host 头匹配到某个应用的 domain， 则返回该应用名。

参数

• host：Host 头（如 oapc.example.com:8801 或 oapc.example.com）

返回

• Some(app_name)：域名匹配到已注册应用
• None：未匹配

pub fn get(&self, name: &str) -> Option<&AppEntry>

获取应用条目

pub fn len(&self) -> usize

获取已注册应用数量

pub fn is_empty(&self) -> bool

是否为空

pub fn app_names(&self) -> Vec<&str>

列出所有应用名

pub fn build(&self) -> Router

构建整合的主 Router

将每个应用的 Router 用 axum::Router::nest 嵌套到主 Router， 路径前缀为 /{app_name}。

注意

域名绑定（domain_bind）需要在反向代理（Nginx）层处理， 将不同域名的请求转发到不同的应用路径前缀。

Trait Implementations

impl Debug for MultiAppDispatcher

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

Formats the value using the given formatter.

impl Default for MultiAppDispatcher

fn default() -> MultiAppDispatcher

Returns the “default value” for a type.