#इवेंट

NocoBase का सर्वर (Server) एप्लीकेशन के जीवनचक्र, प्लगइन के जीवनचक्र और डेटाबेस ऑपरेशंस जैसे विभिन्न चरणों में संबंधित इवेंट (घटनाएँ) ट्रिगर करता है। प्लगइन डेवलपर इन इवेंट्स को सुनकर एक्सटेंशन लॉजिक, ऑटोमेटेड ऑपरेशंस या कस्टम व्यवहार लागू कर सकते हैं।

NocoBase का इवेंट सिस्टम मुख्य रूप से दो स्तरों में विभाजित है:

• app.on() - एप्लीकेशन-स्तरीय इवेंट: एप्लीकेशन के जीवनचक्र इवेंट्स को सुनें, जैसे कि स्टार्ट होना, इंस्टॉल होना, प्लगइन को सक्षम करना आदि।
• db.on() - डेटाबेस-स्तरीय इवेंट: डेटा मॉडल स्तर पर होने वाले ऑपरेशंस इवेंट्स को सुनें, जैसे कि रिकॉर्ड बनाना, अपडेट करना, हटाना आदि।

ये दोनों Node.js के EventEmitter से इनहेरिट होते हैं और स्टैंडर्ड .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('डेटा अपडेट होने वाला है!');
});