#אירועים

השרת של NocoBase מפעיל אירועים מתאימים במהלך מחזור חיי היישום, מחזור חיי התוסף ופעולות מסד נתונים. מפתחי תוספים יכולים להאזין לאירועים אלה כדי ליישם לוגיקה מורחבת, פעולות אוטומטיות או התנהגויות מותאמות אישית.

מערכת האירועים של NocoBase מחולקת בעיקר לשתי רמות:

• app.on() - אירועים ברמת היישום: מאזינים לאירועי מחזור חיי היישום, כגון הפעלה, התקנה, הפעלת תוספים ועוד.
• db.on() - אירועים ברמת מסד הנתונים: מאזינים לאירועי פעולה ברמת מודל הנתונים, כגון יצירה, עדכון או מחיקת רשומות.

שניהם יורשים מ-EventEmitter של Node.js, ותומכים בשימוש בממשקי .on(), .off() ו-.emit() הסטנדרטיים. NocoBase גם הרחיבה את התמיכה ב-emitAsync, המשמש להפעלת אירועים באופן אסינכרוני ולהמתנה להשלמת ביצוע כל המאזינים.

#היכן לרשום מאזיני אירועים

מאזיני אירועים נרשמים בדרך כלל בשיטת beforeLoad() של התוסף, מה שמבטיח שהאירועים יהיו מוכנים כבר בשלב טעינת התוסף, ושהלוגיקה העוקבת תוכל להגיב כראוי.

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

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

    // האזנה לאירועי יישום
    this.app.on('afterStart', () => {
      app.logger.info('NocoBase הופעל');
    });

    // האזנה לאירועי מסד נתונים
    this.db.on('afterCreate', (model) => {
      if (model.collectionName === 'posts') {
        app.logger.info(`פוסט חדש: ${model.get('title')}`);
      }
    });
  }
}

#האזנה לאירועי יישום app.on()

אירועי יישום משמשים ללכידת שינויים במחזור החיים של יישום NocoBase ושל התוספים שלו, והם מתאימים ללוגיקת אתחול, רישום משאבים או זיהוי תלויות תוספים.

#סוגי אירועים נפוצים

דוגמה: האזנה לאירוע הפעלת יישום

app.on('afterStart', async () => {
  app.logger.info('🚀 שירות NocoBase הופעל!');
});

דוגמה: האזנה לאירוע טעינת תוסף

app.on('afterLoadPlugin', ({ plugin }) => {
  app.logger.info(`התוסף ${plugin.name} נטען`);
});

#האזנה לאירועי מסד נתונים db.on()

אירועי מסד נתונים יכולים ללכוד שינויים שונים בנתונים ברמת המודל, והם מתאימים לפעולות כמו ביקורת, סנכרון, מילוי אוטומטי ועוד.

#סוגי אירועים נפוצים

דוגמה: האזנה לאירוע לאחר יצירת נתונים

db.on('afterCreate', async (model, options) => {
  db.logger.info('הנתונים נוצרו!');
});

דוגמה: האזנה לאירוע לפני עדכון נתונים

db.on('beforeUpdate', async (model, options) => {
  db.logger.info('הנתונים עומדים להתעדכן!');
});