Tous les produits
Search
Centre de documentation

ApsaraMQ for RocketMQ:Envoi et réception de messages planifiés et différés

Dernière mise à jour :Aug 09, 2026

Cette rubrique fournit des exemples de code pour envoyer et recevoir des messages planifiés et différés avec le SDK client HTTP pour Node.js.

Informations générales

  • Les messages différés sont remis par les brokers ApsaraMQ for RocketMQ aux consommateurs après un délai spécifique.

  • Les messages planifiés sont remis par les brokers ApsaraMQ for RocketMQ aux consommateurs à un moment précis.

La configuration du code est identique pour les messages planifiés et les messages différés via HTTP. Ces deux types de messages sont remis aux consommateurs après un certain délai, selon les attributs du message.

Pour plus d'informations, consultez la section Messages planifiés et messages différés.

Prérequis

Avant de commencer, effectuez les opérations suivantes :

  • Installez le SDK pour Node.js. Pour plus d'informations, consultez la section Configuration de l'environnement Node.js.

  • Créez dans la console ApsaraMQ for RocketMQ les ressources à spécifier dans le code : instances, topics et groupes de consommateurs. Pour plus d'informations, consultez la section Création de ressources.

  • Obtenez la paire AccessKey de votre compte Alibaba Cloud. Pour plus d'informations, consultez la section Création d'une AccessKey.

Envoi de messages planifiés et différés

L'exemple de code suivant montre comment envoyer des messages planifiés et différés avec le SDK client HTTP pour Node.js :

const {
  MQClient,
  MessageProperties
} = require('@aliyunmq/mq-http-sdk');

// The HTTP endpoint. You can obtain the endpoint in the HTTP Endpoint section of the Instance Details page in the ApsaraMQ for RocketMQ console. 
const endpoint = "${HTTP_ENDPOINT}";
// Make sure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID and ALIBABA_CLOUD_ACCESS_KEY_SECRET are configured. 
// The AccessKey ID that is used for authentication. 
const accessKeyId = process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'];
// The AccessKey secret that is used for authentication. 
const accessKeySecret = process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'];// The AccessKey ID that is used for authentication. 
const accessKeyId = "${ACCESS_KEY}";
// The AccessKey secret that is used for authentication. 
const accessKeySecret = "${SECRET_KEY}";

var client = new MQClient(endpoint, accessKeyId, accessKeySecret);

// The topic in which the message is produced. You must create the topic in the ApsaraMQ for RocketMQ console. 
const topic = "${TOPIC}";
// The ID of the instance to which the topic belongs. You must create the instance in the ApsaraMQ for RocketMQ console. 
// If the instance has a namespace, specify the ID of the instance. If the instance does not have a namespace, set the instanceId parameter to null or an empty string. You can obtain the namespace of the instance on the Instance Details page in the ApsaraMQ for RocketMQ console. 
const instanceId = "${INSTANCE_ID}";

const producer = client.getProducer(instanceId, topic);

(async function(){
  try {
    // Cyclically send four messages. 
    for(var i = 0; i < 4; i++) {
      let res;
      msgProps = new MessageProperties();
      // The custom attributes of the message. 
      msgProps.putProperty("a", i);
      // The message key. 
      msgProps.messageKey("MessageKey");
      // The period of time after which the broker delivers the message to the consumer. In this example, the broker delivers the message to the consumer after a delay of 10 seconds. Set this parameter to a timestamp in milliseconds. 
      // If you want to send a scheduled message, set the parameter to the time difference between the scheduled point in time and the current point in time. 
      msgProps.startDeliverTime(Date.now() + 10 * 1000);
      // The body and tag of the message. 
      res = await producer.publishMessage("hello mq. timer msg!", "TagA", msgProps);
      console.log("Publish message: MessageID:%s,BodyMD5:%s", res.body.MessageId, res.body.MessageBodyMD5);
    }

  } catch(e) {
    // Specify the logic that you want to use to resend or persist the message if the message fails to be sent and needs to be sent again. 
    console.log(e)
  }
})();

Abonnement aux messages planifiés et différés

L'exemple de code suivant montre comment s'abonner aux messages planifiés et différés avec le SDK client HTTP pour Node.js :

   const {
     MQClient
   } = require('@aliyunmq/mq-http-sdk');

   // HTTP endpoint of your ApsaraMQ for RocketMQ instance.
   const endpoint = "<http-endpoint>";
   // Read credentials from environment variables.
   const accessKeyId = process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'];
   const accessKeySecret = process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'];

   const client = new MQClient(endpoint, accessKeyId, accessKeySecret);

   // Topic to consume from.
   const topic = "<topic>";
   // Consumer group ID. Create this in the console first.
   const groupId = "<group-id>";
   // Instance ID. Set to null or "" if the instance has no namespace.
   const instanceId = "<instance-id>";

   const consumer = client.getConsumer(instanceId, topic, groupId);

   (async function () {
     while (true) {
       try {
         // consumeMessage(batchSize, pollingSeconds)
         //   batchSize:      max messages per request (1-16)
         //   pollingSeconds: long-polling timeout in seconds (max 30)
         const res = await consumer.consumeMessage(3, 3);

         if (res.code === 200) {
           console.log("Consume messages, requestId: %s", res.requestId);

           const handles = res.body.map((message) => {
             console.log(
               "\tMessageId:%s, Tag:%s, PublishTime:%d, NextConsumeTime:%d, " +
               "FirstConsumeTime:%d, ConsumedTimes:%d, Body:%s, Props:%j, MessageKey:%s, Prop-A:%s",
               message.MessageId,
               message.MessageTag,
               message.PublishTime,
               message.NextConsumeTime,
               message.FirstConsumeTime,
               message.ConsumedTimes,
               message.MessageBody,
               message.Properties,
               message.MessageKey,
               message.Properties.a
             );
             return message.ReceiptHandle;
           });

           // Acknowledge consumed messages. If the broker does not receive
           // an ACK before NextConsumeTime, the message is delivered again.
           const ackRes = await consumer.ackMessage(handles);
           if (ackRes.code !== 204) {
             // If the handle of the message times out, the broker fails to receive an ACK.
             console.log("Ack failed:");
             const failHandles = ackRes.body.map((error) => {
               console.log(
                 "\tErrorHandle:%s, Code:%s, Reason:%s",
                 error.ReceiptHandle, error.ErrorCode, error.ErrorMessage
               );
               return error.ReceiptHandle;
             });
             handles.forEach((handle) => {
               if (failHandles.indexOf(handle) < 0) {
                 console.log("\tSucHandle:%s", handle);
               }
             });
           } else {
             console.log("Ack succeeded, requestId: %s\n\t", ackRes.requestId, handles.join(','));
           }
         }
       } catch (e) {
         if (e.Code && e.Code.indexOf("MessageNotExist") > -1) {
           // No messages available -- long polling continues on next iteration.
           console.log("No new messages. requestId: %s, Code: %s", e.RequestId, e.Code);
         } else {
           console.log(e);
         }
       }
     }
   })();