Google Cloud's Pub / Sub عبارة عن ناقل رسائل موزع عالميًا يتوسع تلقائيًا حسب حاجتك. يمكنك إنشاء دالة تعالج أحداث Pub / Sub باستخدام functions.pubsub
.
قم بتشغيل دالة pub / sub
يمكنك تشغيل وظيفة عندما يتم إرسال رسالة Pub / Sub جديدة إلى موضوع معين. يجب عليك تحديد اسم موضوع Pub / Sub الذي تريده لتشغيل وظيفتك ، وتعيين الحدث داخل معالج الحدث onPublish()
:
exports.helloPubSub = functions.pubsub.topic('topic-name').onPublish((message) => { // ... });
الوصول إلى حمولة الرسالة الناقلة / الفرعية
يمكن الوصول إلى حمولة رسالة Pub / Sub من كائن Message
الذي تم إرجاعه إلى وظيفتك. بالنسبة للرسائل التي تحتوي على JSON في نص رسالة Pub / Sub ، فإن Firebase SDK لوظائف السحابة لها خاصية مساعدة لفك تشفير الرسالة. على سبيل المثال ، هذه رسالة منشورة بحمولة JSON بسيطة:
gcloud pubsub topics publish topic-name --message '{"name":"Xenia"}'
يمكنك الوصول إلى حمولة بيانات JSON مثل هذه عبر خاصية json
:
// Get the `name` attribute of the PubSub message JSON body. let name = null; try { name = message.json.name; } catch (e) { functions.logger.error('PubSub message was not JSON', e); }
يتم تضمين الحمولات الأخرى غير JSON في رسالة Pub / Sub كسلاسل مشفرة base64 في كائن الرسالة. لقراءة رسالة مثل ما يلي ، يجب عليك فك تشفير سلسلة base64 كما هو موضح:
gcloud pubsub topics publish topic-name --message 'MyMessage'
// Decode the PubSub Message body. const messageBody = message.data ? Buffer.from(message.data, 'base64').toString() : null;
سمات رسالة الوصول
يمكن إرسال رسالة Pub / Sub مع سمات البيانات المعينة في أمر النشر. على سبيل المثال ، يمكنك نشر رسالة بسمة name
:
gcloud pubsub topics publish topic-name --attribute name=Xenia
يمكنك قراءة هذه السمات من Message.attributes
:
// Get the `name` attribute of the message. const name = message.attributes.name;
قد تلاحظ أن بعض البيانات الأساسية مثل معرف الرسالة أو وقت نشر الرسالة غير متوفرة في Message.attributes
الرسائل. للتغلب على هذا ، يمكنك الوصول إلى سياق الحدث المشغل و context.eventId
للحدث context.timestamp
، والذي يمكنك من خلاله تحديد وقت نشر أي رسالة والتمييز بين رسالة وأخرى. فمثلا:
exports.myFunction = functions.pubsub.topic('topic1').onPublish((message, context) => {
console.log('The function was triggered at ', context.timestamp);
console.log('The unique ID for the event is', context.eventId);
});