Cursor rule

1---
2description: 事件(Event)
3globs: 
4---
5# 事件(Event)
6 
7事件是开发过程中经常使用到的功能，我们经常利用它来做一些解耦的操作。如：更新了用户信息，其他需要更新相关信息的操作自行监听更新等
8 
9## 新建监听
10 
11```ts
12import { Provide, Scope, ScopeEnum } from "@midwayjs/core";
13import { CoolEvent, Event } from "@cool-midway/core";
14 
15/**
16 * 接收事件
17 */
18@CoolEvent()
19export class DemoEvent {
20  /**
21   * 根据事件名接收事件
22   * @param msg
23   * @param a
24   */
25  @Event("updateUser")
26  async updateUser(msg, a) {
27    console.log("ImEvent", "updateUser", msg, a);
28  }
29}
30```
31 
32## 发送事件
33 
34```ts
35import { Get, Inject, Provide } from "@midwayjs/core";
36import {
37  CoolController,
38  BaseController,
39  CoolEventManager,
40} from "@cool-midway/core";
41 
42/**
43 * 事件
44 */
45@CoolController()
46export class DemoEventController extends BaseController {
47  @Inject()
48  coolEventManager: CoolEventManager;
49 
50  /**
51   * 发送事件
52   */
53  @Get("/send")
54  public async send() {
55    this.coolEventManager.emit("updateUser", { a: 1 }, 12);
56  }
57}
58```
59 
60## 多进程通信
61 
62当你的项目利用如`pm2`等工具部署为 cluster 模式的时候，你的项目会有多个进程，这时候你的事件监听和发送只会在当前进程内有效，如果你需要触发到所有或者随机一个进程，需要使用多进程通信，这里我们提供了一个简单的方式来实现多进程通信。
63 
64需要根据你的业务需求来使用该功能！！！
65 
66```ts
67import { Get, Inject, Provide } from "@midwayjs/core";
68import {
69  CoolController,
70  BaseController,
71  CoolEventManager,
72} from "@cool-midway/core";
73 
74/**
75 * 事件
76 */
77@Provide()
78@CoolController()
79export class DemoEventController extends BaseController {
80  @Inject()
81  coolEventManager: CoolEventManager;
82 
83  @Post("/global", { summary: "全局事件，多进程都有效" })
84  async global() {
85    await this.coolEventManager.globalEmit("demo", false, { a: 2 }, 1);
86    return this.ok();
87  }
88}
89```
90 
91**globalEmit**
92 
93```ts
94/**
95 * 发送全局事件
96 * @param event 事件
97 * @param random 是否随机一个
98 * @param args 参数
99 * @returns
100 */
101globalEmit(event: string, random?: boolean, ...args: any[])
102```
103