UD5工具箱
使用教程
本教程将引导您逐步使用发布订阅模式演示平台的全部功能。通过实际操作，您将深入理解发布订阅模式的核心概念和使用技巧。
第一步：了解界面布局
打开演示平台后，您会看到几个主要区域：顶部是功能控制区，包含事件类型选择和操作按钮；中间是事件发布和订阅的操作区域；右侧是订阅关系矩阵可视化面板；底部是事件日志面板和 EventBus 实现代码展示区。建议先花一两分钟浏览整个界面，了解各区域的功能定位。界面设计力求直观，大部分功能都可以通过点击按钮来触发。
第二步：创建事件订阅
首先，从顶部的事件类型列表中选择一个事件类型（例如 user.login）。然后点击对应的订阅按钮，系统会创建一个新的订阅者。您可以在订阅者配置中设置订阅的事件类型、是否使用通配符、是否为一次性订阅等参数。创建成功后，矩阵可视化面板中对应的交叉点会变为已订阅状态。建议尝试创建多个不同类型的订阅，观察矩阵的变化。
第三步：发布事件
订阅创建完成后，尝试发布事件来触发订阅者。您可以使用快捷发布按钮快速发送预定义数据，也可以手动输入 JSON 格式的事件数据进行更灵活的测试。发布事件后，注意观察以下变化：事件日志面板会记录这次发布活动、被触发的订阅者会有视觉反馈（如高亮或动画效果）、如果是通配符订阅，所有匹配的订阅者都会被触发。通过反复发布不同类型的事件，您可以清楚地观察到事件的定向传播机制。
第三步：观察订阅关系矩阵
订阅关系矩阵是理解事件系统拓扑结构的有力工具。矩阵的每一行代表一个事件类型，每一列代表一个订阅者。当某个订阅者订阅了某个事件类型时，对应的交叉点会显示为已连接状态。通过矩阵，您可以快速识别：哪些事件类型有活跃的订阅者、哪些订阅者关注了最多事件、是否存在未被任何订阅者监听的事件类型等。这对于大型项目中的事件架构设计非常有参考价值。
第四步：测试一次性订阅
创建一个使用 once 模式的订阅，然后连续发布两次相同的事件。第一次发布时，订阅者会正常响应并显示数据；第二次发布时，订阅者不再响应，因为它在首次触发后已自动取消订阅。通过对比 on 和 once 的行为差异，理解它们在不同场景下的适用性。once 特别适合处理一次性的异步回调场景。
第五步：运行自动演示
点击自动演示按钮，系统会按照预设脚本自动执行一系列订阅和发布操作。自动演示过程中，您可以观察事件在系统中的完整传播流程。演示结束后，事件日志中会留下完整的操作记录，您可以逐一回顾每一步操作的效果。自动演示是快速建立整体认知的好方法，建议在手动操作之前或之后运行一次。
第六步：学习实现代码
在代码展示区域，您可以查看 EventBus 的完整 JavaScript 实现。重点关注 on 方法如何管理订阅者列表、emit 方法如何遍历触发订阅者、off 方法如何取消订阅、以及 once 方法如何实现一次性订阅的逻辑。理解这些核心实现后，您可以将代码复制到自己的项目中使用，或者基于此实现进行扩展以满足特定需求。