Struct PluginManager 

pub struct PluginManager { /* private fields */ }

插件管理器 - 初始化后不可变

设计理念

• 初始化阶段: 使用 PluginManagerBuilder 注册和配置插件
• 运行时阶段: 插件列表完全只读，零锁开销
• 性能优化: 预计算排序结果，避免运行时重复计算

性能对比

旧实现 (使用 RwLock):

• get_sorted_plugins(): 需要获取 2 个读锁 → ~500ns
• 高并发场景存在锁竞争

新实现 (无锁):

• get_sorted_plugins(): 直接返回 Arc → ~50ns (10x 提升)
• 零锁竞争，完美并发扩展

示例

use mf_state::plugin::{PluginManagerBuilder, Plugin};

// 初始化阶段
let mut builder = PluginManagerBuilder::new();
builder.register_plugin(plugin1)?;
builder.register_plugin(plugin2)?;
let manager = builder.build()?;

// 运行时阶段（零开销）
let plugins = manager.get_sorted_plugins_sync();

Implementations

impl PluginManager

pub fn new() -> Self

创建空的插件管理器（用于测试）

pub async fn get_sorted_plugins(&self) -> Vec<Arc<Plugin>>

获取排序后的插件列表（异步接口，兼容现有代码）

性能

• 旧版本: 需要 2 个 RwLock 读锁 (~500ns)
• 新版本: 直接返回 Arc 克隆 (~50ns)

注意

虽然这是异步函数，但实际是纯内存操作，不会阻塞。 保留异步签名是为了兼容现有的异步调用链。

pub fn get_sorted_plugins_sync(&self) -> &[Arc<Plugin>]

获取排序后的插件列表（同步接口，推荐使用）

返回切片引用，避免不必要的克隆。

示例

for plugin in manager.get_sorted_plugins_sync() {
    plugin.apply(...).await?;
}

pub async fn is_initialized(&self) -> bool

检查初始化状态（异步接口，兼容现有代码）

使用原子操作，无锁开销 (~5ns)。

pub fn is_initialized_sync(&self) -> bool

检查初始化状态（同步接口，推荐使用）

pub fn plugin_count(&self) -> usize

获取插件总数

pub fn get_plugin(&self, name: &str) -> Option<&Arc<Plugin>>

根据名称获取插件

性能

HashMap 查找: O(1)，约 10-20ns

pub fn has_plugin(&self, name: &str) -> bool

检查插件是否存在

Trait Implementations

impl Clone for PluginManager

fn clone(&self) -> PluginManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PluginManager

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

Formats the value using the given formatter.

impl Default for PluginManager

fn default() -> Self

Returns the “default value” for a type.