Struct MiddlewareChain 

pub struct MiddlewareChain { /* private fields */ }

中间件链 — 定义中间件执行顺序

业务期望顺序：order() 数组首元素最先执行。 调用方在 ServiceBuilder 上注册时需逆序调用 layer()（后注册先执行）。

Implementations

impl MiddlewareChain

pub fn new() -> Self

创建空链（无中间件）

pub fn default_chain() -> Self

创建默认链（使用 DEFAULT_ORDER）

pub fn php_global() -> Self

创建 PHP 全局链（使用 PHP_GLOBAL_ORDER，对齐 app/middleware.php）

pub fn push(self, kind: MiddlewareKind) -> Self

追加一个中间件到链尾（最后执行）

pub fn insert(self, index: usize, kind: MiddlewareKind) -> Result<Self, String>

在指定位置插入中间件

返回 Err(message) 如果位置越界。

pub fn remove(&mut self, index: usize) -> Option<MiddlewareKind>

移除并返回指定位置的中间件

返回 None 如果位置越界。

pub fn remove_kind(&mut self, kind: MiddlewareKind) -> usize

移除所有指定类型的中间件

返回被移除的数量。

pub fn remove_from(&mut self, kind: MiddlewareKind) -> usize

移除指定类型之后的所有中间件（含指定类型）

用于「公开 API 跳过 Auth 及之后中间件」场景。 返回被移除的数量；若 kind 不存在则不移除任何中间件，返回 0。

pub fn order(&self) -> &[MiddlewareKind]

返回中间件顺序（业务期望顺序，首元素最先执行）

pub fn service_builder_order(&self) -> Vec<MiddlewareKind>

返回 ServiceBuilder 注册顺序（业务期望顺序的逆序）

ServiceBuilder::layer 是「后注册先执行」，因此注册时需逆序。 调用方按此顺序调用 ServiceBuilder::layer(layer_xxx) 即可保证 业务期望顺序与实际执行顺序一致。

pub fn len(&self) -> usize

返回链长度

pub fn is_empty(&self) -> bool

链是否为空

pub fn contains(&self, kind: MiddlewareKind) -> bool

是否包含指定中间件

pub fn position(&self, kind: MiddlewareKind) -> Option<usize>

返回指定中间件的位置（首次出现）

pub fn has_duplicates(&self) -> bool

校验链中无重复中间件

重复中间件通常表示配置错误（如 Auth 注册两次），应避免。

Trait Implementations

impl Clone for MiddlewareChain

fn clone(&self) -> MiddlewareChain

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MiddlewareChain

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

Formats the value using the given formatter.

impl Default for MiddlewareChain

fn default() -> Self

Returns the “default value” for a type.

impl Display for MiddlewareChain

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

Formats the value using the given formatter.

impl Eq for MiddlewareChain

impl PartialEq for MiddlewareChain

fn eq(&self, other: &MiddlewareChain) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MiddlewareChain