#Olaylar

NocoBase'in sunucusu, uygulama yaşam döngüsü, eklenti yaşam döngüsü ve veritabanı işlemleri gibi çeşitli aşamalarda ilgili olayları tetikler. Eklenti geliştiricileri, bu olayları dinleyerek genişletme mantığı, otomatik işlemler veya özel davranışlar uygulayabilirler.

NocoBase'in olay sistemi temel olarak iki seviyeye ayrılır:

• app.on() - Uygulama Seviyesi Olayları: Uygulamanın başlatma, kurulum, eklentileri etkinleştirme gibi yaşam döngüsü olaylarını dinler.
• db.on() - Veritabanı Seviyesi Olayları: Veri modeli seviyesindeki kayıt oluşturma, güncelleme, silme gibi işlem olaylarını dinler.

Her ikisi de Node.js'in EventEmitter sınıfından miras alır ve standart .on(), .off(), .emit() arayüzlerini destekler. NocoBase ayrıca, olayları eşzamansız olarak tetiklemek ve tüm dinleyicilerin yürütmeyi tamamlamasını beklemek için emitAsync desteğini de genişletmiştir.

#Olay Dinleyicilerini Kaydetme Konumu

Olay dinleyicileri genellikle eklentinin beforeLoad() metodunda kaydedilmelidir. Bu, olayların eklenti yükleme aşamasında hazır olmasını ve sonraki mantığın doğru şekilde yanıt verebilmesini sağlar.

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

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

    // Uygulama olaylarını dinleyin
    this.app.on('afterStart', () => {
      app.logger.info('NocoBase başlatıldı');
    });

    // Veritabanı olaylarını dinleyin
    this.db.on('afterCreate', (model) => {
      if (model.collectionName === 'posts') {
        app.logger.info(`Yeni gönderi: ${model.get('title')}`);
      }
    });
  }
}

#Uygulama Olaylarını Dinleme app.on()

Uygulama olayları, NocoBase uygulamasının ve eklentilerinin yaşam döngüsü değişikliklerini yakalamak için kullanılır. Başlatma mantığı, kaynak kaydı veya eklenti bağımlılık tespiti gibi işlemler için uygundur.

#Tipik Olay Türleri

Örnek: Uygulama başlatma olayını dinleme

app.on('afterStart', async () => {
  app.logger.info('🚀 NocoBase servisi başlatıldı!');
});

Örnek: Eklenti yükleme olayını dinleme

app.on('afterLoadPlugin', ({ plugin }) => {
  app.logger.info(`Eklenti ${plugin.name} yüklendi`);
});

#Veritabanı Olaylarını Dinleme db.on()

Veritabanı olayları, model seviyesindeki çeşitli veri değişikliklerini yakalayabilir; denetim, senkronizasyon, otomatik doldurma gibi işlemler için uygundur.

#Tipik Olay Türleri

Örnek: Veri oluşturulduktan sonraki olayı dinleme

db.on('afterCreate', async (model, options) => {
  db.logger.info('Veri oluşturuldu!');
});

Örnek: Veri güncellenmeden önceki olayı dinleme

db.on('beforeUpdate', async (model, options) => {
  db.logger.info('Veri güncellenmek üzere!');
});