在 Node.js 中開始使用轉送混合式連線 WebSocket

• NET
• Node.js

在本快速入門中，您將建立 Node.js 傳送者與接收者應用程式，以使用 Azure 轉送中的混合式連線 WebSocket 來傳送和接收訊息。 若要對 Azure 轉送有整體上的了解，請參閱 Azure 轉送。

在本快速入門中，您會執行下列步驟：

1. 使用 Azure 入口網站建立轉送命名空間。
2. 使用 Azure 入口網站，在該命名空間中建立混合式連線。
3. 撰寫伺服器 (接聽端) 主控台應用程式來接收訊息。
4. 撰寫用戶端 (傳送端) 主控台應用程式來傳送訊息。
5. 執行應用程式。

必要條件

• Node.js。
• Azure 訂用帳戶。 如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。

建立命名空間

1. 登入 Azure 入口網站。

2. 選取左側功能表上的 [所有服務]。 選取 [整合]，並搜尋「轉送」，再將滑鼠移至 [轉送] 上方，然後選取 [建立]。

   

3. 在 [建立命名空間] 頁面上，遵循下列步驟：

   1. 選擇要在其中建立命名空間的 Azure 訂用帳戶。

   2. 針對資源群組，選擇將放置命名空間的現有資源群組，或是建立新的資源群組。

   3. 輸入轉送命名空間的名稱。

   4. 選取要用來裝載命名空間的區域。

   5. 選取頁面底部的 [檢閱 + 建立] 。

      

   6. 在 [檢閱 + 建立] 頁面上，選取 [建立]。

   7. 幾分鐘後，您會看到命名空間的 [轉送] 頁面。

      

取得管理認證

1. 在 [轉送] 頁面上，選取左側功能表上的 [共用存取原則]。 `

2. 在 [共用存取原則] 頁面上，選取 [RootManageSharedAccessKey]。

3. 在 [SAS 原則: RootManageSharedAccessKey] 下，選取 [主要連接字串] 旁的 [複製] 按鈕。 此動作會將連接字串複製到剪貼簿以供稍後使用。 將此值貼到記事本或一些其他暫存位置。

4. 重複前一個步驟，複製 [主要金鑰] 的值並貼到暫存位置以供稍後使用。

   

Create a hybrid connection

在命名空間的 [轉送] 頁面上，遵循下列步驟來建立混合式連線。

1. 在左側功能表的 [實體] 下，選取 [混合式連線]，然後選取 [+ 混合式連線]。

   

2. 在 [建立混合式連線] 頁面上，輸入混合式連線的名稱，然後選取 [建立]。

   

建立伺服器應用程式 (接聽程式)

為了接聽並接收來自轉送的訊息，請撰寫 Node.js 主控台應用程式。

建立 Node.js 應用程式

新增名為 listener.js 的 JavaScript 檔案。

新增轉寄套件

在您的專案資料夾中從 Node 命令提示字元執行 npm install hyco-ws。

撰寫一些程式碼來接收訊息

1. 在 listener.js 檔案的開頭處，新增下列常數。

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

2. 將下列常數新增至 listener.js 檔案，以取得混合式連線詳細資料。 將方括號中的預留位置取代為您在建立混合式連線時所取得的值。

   • const ns - 轉送命名空間。 務必使用完整命名空間名稱；例如，{namespace}.servicebus.windows.net。
   • const path - 混合式連線的名稱。
   • const keyrule - 預設為共用存取原則金鑰 RootManageSharedAccessKey 的名稱。
   • const key - 您稍早儲存之命名空間的主鍵。

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 的 JavaScript 檔案。

新增轉 封裝管理員 節點套件

在您的專案資料夾中從 Node 命令提示字元執行 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 檔案，以取得混合式連線詳細資料。 將方括號中的預留位置取代為您在建立混合式連線時所取得的值。

   • const ns - 轉送命名空間。 務必使用完整命名空間名稱；例如，{namespace}.servicebus.windows.net。
   • const path - 混合式連線的名稱。
   • const keyrule - 預設為共用存取原則金鑰 RootManageSharedAccessKey 的名稱。
   • const key - 您稍早儲存之命名空間的主鍵。

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();
           });
       }
   );
   

注意

本文中的範例程式代碼會使用 連接字串 向 Azure 轉寄命名空間進行驗證，讓教學課程保持簡單。 建議您在生產環境中使用Microsoft Entra ID 驗證，而不是使用 連接字串 或共用存取簽章，這更容易遭到入侵。 如需使用 Microsoft Entra 識別子驗證的詳細資訊和範例程式代碼，請參閱 使用 Microsoft Entra 識別符來驗證應用程式以存取 Azure 轉寄實體 ，並使用 Microsoft Entra ID 驗證受控識別以存取 Azure 轉寄資源。

執行應用程式

1. 執行伺服器應用程式：從 Node.js 命令提示字元中，鍵入 node listener.js。

2. 執行用戶端應用程式：從 Node.js 命令提示字元中，鍵入 node sender.js，然後輸入一些文字。

3. 確定伺服器應用程式主控台有將用戶端應用程式中所輸入的文字輸出。

   

恭喜您，您已經使用 Node.js 建立端對端混合式連線應用程式！

下一步

在本快速入門中，您已建立 Node.js 用戶端和使用 WebSocket 來傳送和接收訊息的伺服器應用程式。 Azure 轉送的混合式連線功能也支援使用 HTTP 來傳送和接收訊息。 若要了解如何搭配使用 HTTP 和 Azure 轉送混合式連線，請參閱 Node.js HTTP 快速入門。

在本快速入門中，您已使用 Node.js 來建立用戶端和伺服器應用程式。 若要了解如何使用 .NET Framework 撰寫用戶端和伺服器應用程式，請參閱 .NET WebSocket 快速入門或 .NET HTTP 快速入門。