ابدأ باستخدام WebSockets لاتصالات الترحيل المختلطة في Node.js

هل هذه الصفحة مفيدة؟

هل لديك ملاحظات إضافية؟

سيتم إرسال الملاحظات إلى Microsoft: بالضغط على الزر «إرسال»، سيتم استخدام ملاحظاتك لتحسين منتجات Microsoft وخدماتها. نهج الخصوصية.

• NET
• Node.js

في هذه البداية السريعة، يمكنك إنشاء Node.js تطبيقات المرسل والمستقبل التي ترسل وتتلقى الرسائل باستخدام اتصالات مختلطة WebSockets في Azure Relay. للتعرف على Azure Relay بشكل عام، راجع Azure Relay.

في هذه البداية السريعة، يمكنك اتخاذ الخطوات التالية:

1. إنشاء مساحة اسم ترحيل باستخدام مدخل Azure.
2. قم بإنشاء اتصال مختلط في مساحة الاسم هذه باستخدام مدخل Azure.
3. اكتب تطبيق وحدة تحكم خادم (مستمع) لتلقي الرسائل.
4. اكتب تطبيق وحدة تحكم عميل (مرسل) لإرسال الرسائل.
5. تشغيل التطبيقات.

المتطلبات الأساسية

• ⁧⁩Node.js⁧⁩.
• اشتراك Azure. إذا لم يكن لديك حساب، فقم بإنشاء حساب مجاني قبل أن تبدأ.

إنشاء مساحة اسم

1. سجل الدخول إلى مدخل Azure.

2. حدد Create a resource. ومن ثم، حدد ترحيل>التكامل. إذا لم تطلع على الترحيل المذكور في القائمة، فحدد الاطلاع على الكل في الزاوية العلوية اليمنى.

3. حدد إنشاء، ثم أدخل اسم namespace في حقل الاسم. يتحقق مدخل Azure لمعرفة ما إذا كان الاسم متوفراً.

4. بالنسبة إلى Subscription، اختر اشتراك Azure لإنشاءnamespace.

5. بالنسبة لـ "مجموعة الموارد"، اختر مجموعة موارد موجودة حيث توجد namespace، أو إنشاء مجموعة موارد جديدة.

6. حدد البلد أو المنطقة التي يجب استضافة namespace فيها.

   

7. حدد Create. يقوم النظام الآن بإنشاء namespace وتمكينها. بعد بضع دقائق، يُوفر النظام الموارد لحسابك.

الحصول على بيانات اعتماد الإدارة

1. حدد جميع الموارد، ثم حدد اسم namespace الذي تم إنشاؤه حديثاً.

2. حدد سياسات الوصول المشترك.

3. في إطارسياسات الوصول المشترك، حدد RootManageSharedAccessKey.

4. في إطار سياسةSAS: RootManageSharedAccessKey، حدد زر نسخ سلسلة الاتصال الأساسية. يقوم هذا الإجراء بنسخ سلسلة الاتصال إلى الحافظة لاستخدامها لاحقاً. لصق هذه القيمة في المفكرة أو بعض المواقع المؤقتة الأخرى.

5. كرر الخطوة السابقة، وهي نسخ قيمة المفتاح الأساسي ولصقها إلى موقع مؤقت للاستخدام لاحقاً.

   

إنشاء اتصال مختلط

تأكد من أنك قمت بالفعل بإنشاء مساحة اسم ترحيل.

1. تسجيل الدخول إلى ⁧مدخل Microsoft Azure⁧.

2. في القائمة اليمنى، حدد ⁧⁩جميع الموارد⁧⁩.

3. حدد مساحة الاسم حيث تريد إنشاء الاتصال المختلط. في هذه الحالة ، هو mynewns.

4. ضمن مساحة اسم الترحيل، حدد الاتصالات المختلطة.

   

5. في نافذة نظرة عامة على مساحة الاسم، حدد + اتصال مختلط

   

6. ضمن إنشاء اتصال مختلط، أدخل قيمة لاسم الاتصال المختلط. اترك القيم الافتراضية الأخرى.

   

7. حدد Create.

إنشاء تطبيق خادم (مستمع)

للاستماع إلى الرسائل وتلقيها من Relay، اكتب تطبيق وحدة تحكم Node.js.

إنشاء تطبيق Node.js

إنشاء ملف جافا سكريبت جديد يسمى listener.js.

إضافة حزمة NPM التتابع

تشغيل npm install hyco-ws من موجه أوامر عقدة في مجلد المشروع الخاص بك.

اكتب بعض التعليمات البرمجية لتلقي الرسائل

1. أضف الثابت التالي إلى أعلى listener.js الملف.

   const WebSocket = require('hyco-ws');
   

2. أضف الثوابت التالية إلى listener.js الملف للحصول على تفاصيل الاتصال المختلط. استبدل العناصر النائبة بين قوسين بالقيم التي حصلت عليها عند إنشاء الاتصال المختلط.

   1. const ns - مساحة اسم التتابع. تأكد من استخدام اسم مساحة الاسم المؤهل بالكامل ؛ على سبيل المثال، {namespace}.servicebus.windows.net.
   2. const path - اسم الاتصال الهجين.
   3. const keyrule - اسم مفتاح SAS.
   4. const key - قيمة مفتاح SAS.

3. قم بإضافة التعليمة listener.js البرمجية التالية إلى الملف:

   var wss = WebSocket.createRelayedServer(
   {
       server : WebSocket.createRelayListenUri(ns, path),
       token: WebSocket.createRelayToken('http://' + ns, keyrule, key)
   }, 
   function (ws) {
       console.log('connection accepted');
       ws.onmessage = function (event) {
           console.log(event.data);
       };
       ws.on('close', function () {
           console.log('connection closed');
       });       
   });
   
   console.log('listening');
   
   wss.on('error', function(err) {
       console.log('error' + err);
   });
   

   في ما يلي الشكل الذي يجب أن يبدو عليه ملف listener.js:

   const WebSocket = require('hyco-ws');
   
   const ns = "{RelayNamespace}";
   const path = "{HybridConnectionName}";
   const keyrule = "{SASKeyName}";
   const key = "{SASKeyValue}";
   
   var wss = WebSocket.createRelayedServer(
       {
           server : WebSocket.createRelayListenUri(ns, path),
           token: WebSocket.createRelayToken('http://' + ns, keyrule, key)
       }, 
       function (ws) {
           console.log('connection accepted');
           ws.onmessage = function (event) {
               console.log(event.data);
           };
           ws.on('close', function () {
               console.log('connection closed');
           });       
   });
   
   console.log('listening');
   
   wss.on('error', function(err) {
       console.log('error' + err);
   });
   

إنشاء تطبيق عميل (مرسل)

لإرسال رسائل إلى الترحيل، اكتب تطبيق وحدة تحكم Node.js.

إنشاء تطبيق Node.js

إنشاء ملف جافا سكريبت جديد يسمى sender.js.

إضافة حزمة NPM التتابع

تشغيل npm install hyco-ws من موجه أوامر عقدة في مجلد المشروع الخاص بك.

اكتب بعض التعليمات البرمجية لإرسال الرسائل

1. أضف ما يلي constants إلى أعلى sender.js الملف.

   const WebSocket = require('hyco-ws');
   const readline = require('readline')
       .createInterface({
           input: process.stdin,
           output: process.stdout
       });;
   

2. أضف الثوابت التالية إلى sender.js الملف للحصول على تفاصيل الاتصال المختلط. استبدل العناصر النائبة بين قوسين بالقيم التي حصلت عليها عند إنشاء الاتصال المختلط.

   1. const ns - مساحة اسم التتابع. تأكد من استخدام اسم مساحة الاسم المؤهل بالكامل ؛ على سبيل المثال، {namespace}.servicebus.windows.net.
   2. const path - اسم الاتصال الهجين.
   3. const keyrule - اسم مفتاح SAS.
   4. const key - قيمة مفتاح SAS.

3. قم بإضافة التعليمة sender.js البرمجية التالية إلى الملف:

   WebSocket.relayedConnect(
       WebSocket.createRelaySendUri(ns, path),
       WebSocket.createRelayToken('http://'+ns, keyrule, key),
       function (wss) {
           readline.on('line', (input) => {
               wss.send(input, null);
           });
   
           console.log('Started client interval.');
           wss.on('close', function () {
               console.log('stopping client interval');
               process.exit();
           });
       }
   );
   

   في ما يلي الشكل الذي يجب أن يبدو عليه ملف sender.js:

   const WebSocket = require('hyco-ws');
   const readline = require('readline')
       .createInterface({
           input: process.stdin,
           output: process.stdout
       });;
   
   const ns = "{RelayNamespace}";
   const path = "{HybridConnectionName}";
   const keyrule = "{SASKeyName}";
   const key = "{SASKeyValue}";
   
   WebSocket.relayedConnect(
       WebSocket.createRelaySendUri(ns, path),
       WebSocket.createRelayToken('http://'+ns, keyrule, key),
       function (wss) {
           readline.on('line', (input) => {
               wss.send(input, null);
           });
   
           console.log('Started client interval.');
           wss.on('close', function () {
               console.log('stopping client interval');
               process.exit();
           });
       }
   );
   

تشغيل التطبيقات

1. قم بتشغيل تطبيق الخادم: من نوع node listener.jsموجه الأوامر Node.js .

2. قم بتشغيل تطبيق العميل: من نوع node sender.jsموجه الأوامر Node.js ، وأدخل بعض النص.

3. تأكد من أن وحدة تحكم تطبيق الخادم تقوم بإخراج النص الذي تم إدخاله في تطبيق العميل.

   

تهانينا ، لقد قمت بإنشاء تطبيق اتصالات هجينة من طرف إلى طرف باستخدام Node.js!

الخطوات التالية

في هذه البداية السريعة، قمت بإنشاء Node.js تطبيقات العميل والخادم التي استخدمت WebSockets لإرسال الرسائل وتلقيها. تدعم ميزة "الاتصالات المختلطة" في Azure Relay أيضا استخدام HTTP لإرسال الرسائل وتلقيها. لمعرفة كيفية استخدام HTTP مع اتصالات Azure Relay المختلطة، راجع Node.js التشغيل السريع ل HTTP.

في هذه البداية السريعة، استخدمت Node.js لإنشاء تطبيقات العميل والخادم. لمعرفة كيفية كتابة تطبيقات العميل والخادم باستخدام .NET Framework، راجع التشغيل السريع .NET WebSockets أو بدء التشغيل السريع .NET HTTP.