puniyu_handler

事件处理器模块

概述

puniyu_handler 是 puniyu 项目中负责事件处理的核心库。它提供了统一的事件处理器接口、消息事件处理实现以及处理器注册和管理机制。

核心组件

Handler Trait

事件处理器基础 trait，所有事件处理器都需要实现此 trait：

• handle(): 异步处理事件的方法
• name(): 返回处理器名称
• rank(): 返回处理器优先级（默认值为 5，数值越小优先级越高）

MessageHandler 结构体

消息事件处理器实现：

• 处理好友消息和群组消息事件
• 解析消息中的命令和参数
• 调用相应的命令处理器执行命令

命令处理机制

命令解析

使用 parse_command! 宏解析消息文本：

• 第一个单词作为命令名称
• --flag value 格式作为参数
• 支持无值参数

命令执行流程

1. 从消息中提取文本内容
2. 解析命令名称和参数
3. 从 CommandRegistry 获取命令定义
4. 构建 Bot 和 EventContext 实例
5. 查找注册的命令处理器
6. 按优先级顺序执行命令处理器
7. 根据 HandlerResult 决定是否继续执行其他处理器

处理器管理

HandlerRegistry 结构体

处理器注册表，提供处理器的注册和管理功能：

• register(): 注册处理器
• unregister(): 卸载处理器
• get_all(): 获取所有处理器
• get_with_name(): 根据名称获取处理器

HandlerStore 结构体

底层存储实现：

• 使用 RwLock<Vec<Arc<dyn Handler>>> 存储处理器
• 插入时自动按优先级排序
• 支持按名称查找和删除处理器

特性

• 异步处理: 所有处理器方法都是异步的
• 优先级排序: 处理器按优先级自动排序
• 线程安全: 使用 Arc 和 RwLock 确保线程安全
• 命令集成: 与 puniyu_command 紧密集成
• 参数解析: 自动解析命令参数并传递给命令处理器

许可证

本项目采用 LGPL 许可证。