Enum RouteState 

pub enum RouteState<T> {
    NoSubRoute,
    SubRoute(T),
    ParseFailed {
        remaining_path: String,
        attempted_patterns: Vec<String>,
        closest_match: Option<ClosestMatch>,
    },
}

路由状态枚举

用于替代 Option，提供更明确的路由解析状态信息 支持 serde 序列化/反序列化

Variants

NoSubRoute

没有子路由（预期的叶子节点）

表示当前路由是一个叶子节点，不应该有子路由

SubRoute(T)

有子路由

表示成功解析到子路由

ParseFailed

解析失败

表示尝试解析子路由时失败，包含详细的调试信息

Fields

remaining_path: String

剩余的路径

attempted_patterns: Vec<String>

尝试匹配的模式列表

closest_match: Option<ClosestMatch>

最接近的匹配信息（可选）

Implementations

impl<T> RouteState<T>

RouteState 的实用方法实现

pub fn no_sub_route() -> Self

创建一个没有子路由的状态

pub fn sub_route(sub_router: T) -> Self

创建一个有子路由的状态

pub fn parse_failed<S: Into<String>>( remaining_path: S, attempted_patterns: Vec<String>, closest_match: Option<ClosestMatch>, ) -> Self

创建一个解析失败的状态

pub fn is_no_sub_route(&self) -> bool

检查是否没有子路由

pub fn is_sub_route(&self) -> bool

检查是否有子路由

pub fn is_parse_failed(&self) -> bool

检查是否解析失败

pub fn as_sub_route(&self) -> Option<&T>

获取子路由的引用（如果存在）

pub fn as_sub_route_mut(&mut self) -> Option<&mut T>

获取子路由的可变引用（如果存在）

pub fn into_option(self) -> Option<T>

将 RouteState 转换为 Option（向后兼容）

pub fn from_option(option: Option<T>) -> Self

从 Option 创建 RouteState（向后兼容）

pub fn map<U, F>(self, f: F) -> RouteState<U>

where F: FnOnce(T) -> U,

映射子路由类型

pub fn debug_info(&self) -> Option<RouteDebugInfo>

获取调试信息（如果是解析失败状态）

Trait Implementations

impl<T: Clone> Clone for RouteState<T>

fn clone(&self) -> RouteState<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for RouteState<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for RouteState<T>

fn eq(&self, other: &RouteState<T>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: PartialEq> StructuralPartialEq for RouteState<T>