通过 Azure 服务总线发送消息 | SendMessage 和 ScheduleMessage

在本节中，我们将简要讨论通过服务总线池跨 Azure 主题传输数据的数据传输方法。我们可以发送普通消息或基于时间表的消息。我们将逐一介绍这两种基本类型的消息传递。

Azure 服务总线： Microsoft Azure 服务总线是云上完全托管的企业集成消息传递服务，用于将云中运行的任何应用程序、设备和服务连接到任何其他应用程序或服务。该平台充当云上和任何设备上的应用程序的消息传递骨干。

它是如何工作的？使用消息在不同的应用程序和服务之间传输数据。消息为二进制格式，可以包含 JSON、XML 或仅包含文本。这些消息被放置到应用程序所连接的服务总线上，以便所有或特定用户连接到这个应用程序上，通过套接字服务连接打开可以接收通过服务总线传输的数据。

消息类型：通过 Azure 服务总线传输的数据消息可以分为两种主要类型，即数据需要按特定计划发送还是需要立即发送。在这里，我们将详细讨论这两个消息传递过程。其中每一个都有自己特定的方法来调用消息传递过程。

立即发送消息： send()函数调用将消息发送到当前发送方连接到的 Azure 服务总线。此方法进行非异步调用。您还有一个异步版本来提高性能。

原型：

send( IMessage message )

示例代码：

public static async sendMessage(content: Message): Promise {
   
    const serviceConnection = AzureServiceBus.createConnection();
      
    const client = serviceConnection.createQueueClient(""
                    + process.env.AZURE_SERVICEBUS_QUEUE);
      
    const sender = client.createSender();
    let response = "";
   
    try {
        const scheduledEnqueueTimeUtc 
            = moment().utc().add(1, "m").toDate();
          
        await sender.send( {body: JSON.stringify(content),
                        label: "MyTopic"});
          
        await client.close();
    } catch (error) {
           
    } finally {
        await serviceConnection.close();
    }
   
    return resp;
}

计划消息：此方法将基于计时器的消息发送到调用发件人所连接的 Azure 服务总线。它将消息排入总线以预定时间消息，将消息传递到接收端。这是当前的异步过程，以获得更好的性能。

原型：

scheduleMessage( IMessage message, Instant scheduledEnqueueTimeUtc )

示例代码：

public static async sendScheduleMessage(
        content: Message): Promise {
   
    const serviceConnection = 
            AzureServiceBus.createConnection();
      
    const client = serviceConnection.createQueueClient(
            "" + process.env.AZURE_SERVICEBUS_QUEUE);
      
    const sender = client.createSender();
    let response = "";
   
    try {
        const scheduledEnqueueTimeUtc 
            = moment().utc().add(1, "m").toDate();
          
        const sequenceId = await sender.scheduleMessage(
            scheduledEnqueueTimeUtc,
            {body: JSON.stringify(content),
            label: "MyTopic"});
          
        response = sequenceId.toString();
        await client.close();
    } catch (error) {
           
    } finally {
        await serviceConnection.close();
    }
   
    return resp;
}

这将引发一个问题，即 sequenceId 值将变为“未定义”。 Azure 门户提供了一个修复，即需要对消息进行编码，然后将其放入服务总线中，以便获取正确的 sequenceId。

错误修复：

import { DefaultDataTransformer }
            from "@azure/amqp-common";
...
...
  
const dt = new DefaultDataTransformer();
  
const sequenceId = await sender.scheduleMessage(
        scheduledEnqueueTimeUtc,
        {body: dt.encode(JSON.stringify(content)),
        label: "MyTopic"});
  
response = sequenceId.toString();

现在您将收到正确的 sequenceId，如果将来需要，您可以使用以下代码段来取消消息。

CancelMessage：此方法使用 scheduleMessage 调用删除了早期放置在服务总线中的消息。我们需要将调用期间返回的 sequenceNumber 作为此方法调用的唯一参数发送。如果消息已经传递，那么我们会收到一个错误 MessageNotFound ，需要在 catch 中处理。

原型：

cancelScheduledMessage( long sequenceNumber )

因此，我们已经介绍了如何使用上述两种方法进行数据通信，并通过调度或非调度方式放置数据请求。