跳到主要内容

事件系统

EventWatcher 是一个核心组件，提供了灵活的事件处理系统。它允许您在应用程序中创建、绑定和触发自定义事件。

概述​

EventWatcher 是一个泛型类，可用于处理任何类型的事件。它提供了一种简单高效的方式来实现应用程序中的事件驱动架构。

特性​

  • 事件绑定和解绑
  • 事件触发
  • 一次性事件监听器
  • 类型安全的事件名称
  • 泛型事件数据处理
  • 跨组件事件通信
  • 内存泄漏防护

示例​

事件绑定和触发​

// 创建事件监听器
const watcher = new EventWatcher();

// 绑定事件处理函数
watcher.bind('userLogin', (username) => {
  console.log(`用户 ${username} 已登录`);
});

// 触发事件
watcher.emit('userLogin', 'john_doe');

一次性事件监听器​

const watcher = new EventWatcher();

// 绑定一次性事件处理函数
watcher.once('initializationComplete', () => {
  console.log('初始化完成');
});

// 触发事件
watcher.emit('initializationComplete');

事件解绑​

const watcher = new EventWatcher();

// 绑定事件处理函数
const handler = (data) => console.log(data);
watcher.bind('dataReceived', handler);

// 解绑事件
watcher.unbind('dataReceived');

最佳实践​

  1. 类型安全

    • 使用 TypeScript 的泛型类型参数确保事件名称的类型安全
    • 定义事件类型以获得更好的代码补全和错误检查

  2. 事件命名

    • 使用清晰且一致的事件命名约定
    • 遵循特定领域的命名模式
    • 记录事件名称及其预期数据

  3. 内存管理

    • 当不再需要事件时，始终解绑事件以防止内存泄漏
    • 对于只应触发一次的事件使用一次性事件监听器
    • 在组件卸载或清理函数中清理事件监听器

  4. 错误处理

    • 在事件回调中实现适当的错误处理
    • 对容易出错的操作使用 try-catch 块
    • 优雅地处理事件触发错误

  5. 事件数据

    • 保持事件数据简单，避免传递大型对象
    • 使用 TypeScript 接口定义事件数据结构
    • 在处理前验证事件数据

相关组件​

  • Process：使用 EventWatcher 进行进程事件处理