#Sự kiện

Máy chủ (Server) của NocoBase kích hoạt các sự kiện (Event) tương ứng trong các giai đoạn như vòng đời ứng dụng, vòng đời plugin và các thao tác cơ sở dữ liệu. Các nhà phát triển plugin có thể lắng nghe các sự kiện này để triển khai logic mở rộng, các thao tác tự động hoặc hành vi tùy chỉnh.

Hệ thống sự kiện của NocoBase được chia thành hai cấp độ chính:

• app.on() - Sự kiện cấp ứng dụng: Lắng nghe các sự kiện vòng đời của ứng dụng, như khởi động, cài đặt, bật plugin, v.v.
• db.on() - Sự kiện cấp cơ sở dữ liệu: Lắng nghe các sự kiện thao tác ở cấp độ mô hình dữ liệu, như tạo, cập nhật, xóa bản ghi, v.v.

Cả hai đều kế thừa từ EventEmitter của Node.js, hỗ trợ sử dụng các giao diện chuẩn .on(), .off(), .emit(). NocoBase cũng mở rộng hỗ trợ emitAsync, được dùng để kích hoạt sự kiện không đồng bộ và chờ tất cả các trình lắng nghe hoàn thành việc thực thi.

#Vị trí đăng ký trình lắng nghe sự kiện

Các trình lắng nghe sự kiện thường nên được đăng ký trong phương thức beforeLoad() của plugin để đảm bảo các sự kiện đã sẵn sàng trong giai đoạn tải plugin và logic tiếp theo có thể phản hồi chính xác.

import { Plugin } from '@nocobase/server';

export default class PluginHelloServer extends Plugin {
  async beforeLoad() {

    // Lắng nghe sự kiện ứng dụng
    this.app.on('afterStart', () => {
      app.logger.info('NocoBase đã khởi động');
    });

    // Lắng nghe sự kiện cơ sở dữ liệu
    this.db.on('afterCreate', (model) => {
      if (model.collectionName === 'posts') {
        app.logger.info(`Bài viết mới: ${model.get('title')}`);
      }
    });
  }
}

#Lắng nghe sự kiện ứng dụng app.on()

Các sự kiện ứng dụng được dùng để nắm bắt các thay đổi trong vòng đời của ứng dụng và plugin NocoBase, phù hợp cho việc khởi tạo logic, đăng ký tài nguyên hoặc kiểm tra phụ thuộc của plugin, v.v.

#Các loại sự kiện phổ biến

Ví dụ: Lắng nghe sự kiện khởi động ứng dụng

app.on('afterStart', async () => {
  app.logger.info('🚀 Dịch vụ NocoBase đã khởi động!');
});

Ví dụ: Lắng nghe sự kiện tải plugin

app.on('afterLoadPlugin', ({ plugin }) => {
  app.logger.info(`Plugin ${plugin.name} đã được tải`);
});

#Lắng nghe sự kiện cơ sở dữ liệu db.on()

Các sự kiện cơ sở dữ liệu có thể nắm bắt nhiều thay đổi dữ liệu khác nhau ở cấp độ mô hình, phù hợp cho các thao tác như kiểm toán, đồng bộ hóa, tự động điền, v.v.

#Các loại sự kiện phổ biến

Ví dụ: Lắng nghe sự kiện sau khi tạo dữ liệu

db.on('afterCreate', async (model, options) => {
  db.logger.info('Dữ liệu đã được tạo!');
});

Ví dụ: Lắng nghe sự kiện trước khi cập nhật dữ liệu

db.on('beforeUpdate', async (model, options) => {
  db.logger.info('Dữ liệu sắp được cập nhật!');
});