#Event

De server van NocoBase genereert events (gebeurtenissen) tijdens de levenscyclus van de applicatie, de levenscyclus van plugins en databasebewerkingen. Plugin-ontwikkelaars kunnen naar deze events luisteren om uitbreidingslogica, geautomatiseerde handelingen of aangepast gedrag te implementeren.

Het eventsysteem van NocoBase is hoofdzakelijk verdeeld in twee niveaus:

• app.on() - Events op applicatieniveau: Luister naar levenscyclus-events van de applicatie, zoals het starten, installeren of inschakelen van plugins.
• db.on() - Events op databaseniveau: Luister naar operationele events op datamodel-niveau, zoals het aanmaken, bijwerken of verwijderen van records.

Beide erven over van Node.js's EventEmitter en ondersteunen de standaard .on(), .off() en .emit() interfaces. NocoBase biedt ook uitgebreide ondersteuning voor emitAsync, dat wordt gebruikt om events asynchroon te activeren en te wachten tot alle listeners hun uitvoering hebben voltooid.

#Waar u event-listeners registreert

Event-listeners moeten over het algemeen worden geregistreerd in de beforeLoad()-methode van de plugin. Dit zorgt ervoor dat de events al klaar zijn tijdens de laadfase van de plugin en dat de daaropvolgende logica correct kan reageren.

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

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

    // Luister naar applicatie-events
    this.app.on('afterStart', () => {
      app.logger.info('NocoBase is gestart');
    });

    // Luister naar database-events
    this.db.on('afterCreate', (model) => {
      if (model.collectionName === 'posts') {
        app.logger.info(`Nieuw bericht: ${model.get('title')}`);
      }
    });
  }
}

#Luisteren naar applicatie-events app.on()

Applicatie-events worden gebruikt om veranderingen in de levenscyclus van de NocoBase-applicatie en plugins vast te leggen. Ze zijn geschikt voor initialisatielogica, resourceregistratie of het detecteren van plugin-afhankelijkheden.

#Veelvoorkomende event-types

Voorbeeld: Luisteren naar het opstart-event van de applicatie

app.on('afterStart', async () => {
  app.logger.info('🚀 NocoBase-service is gestart!');
});

Voorbeeld: Luisteren naar het laad-event van een plugin

app.on('afterLoadPlugin', ({ plugin }) => {
  app.logger.info(`Plugin ${plugin.name} is geladen`);
});

#Luisteren naar database-events db.on()

Database-events kunnen diverse gegevenswijzigingen op modelniveau vastleggen. Ze zijn geschikt voor auditing, synchronisatie, automatisch aanvullen en andere bewerkingen.

#Veelvoorkomende event-types

Voorbeeld: Luisteren naar het event na het aanmaken van gegevens

db.on('afterCreate', async (model, options) => {
  db.logger.info('Gegevens zijn aangemaakt!');
});

Voorbeeld: Luisteren naar het event vóór het bijwerken van gegevens

db.on('beforeUpdate', async (model, options) => {
  db.logger.info('Gegevens staan op het punt te worden bijgewerkt!');
});