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 {:#access-pub/sub}
يمكن الوصول إلى حمولة رسالة Pub/Sub من كائن Message
الذي تم إرجاعه إلى وظيفتك. بالنسبة للرسائل التي تحتوي على JSON في نص رسالة Pub/Sub، تحتوي Firebase SDK for Cloud Functions على خاصية مساعدة لفك تشفير الرسالة. على سبيل المثال، إليك رسالة منشورة بحمولة 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;
الوصول إلى سمات الرسالة {:#access-message}
يمكن إرسال رسالة 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
. للتغلب على هذه المشكلة، يمكنك الوصول إلى هذه التفاصيل في EventContext
الخاص بالحدث. على سبيل المثال:
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);
});