收發(fā)普通消息
更新時(shí)間：
普通消息是指云消息隊(duì)列 RocketMQ 版中無(wú)特性的消息，區(qū)別于有特性的定時(shí)和延時(shí)消息、順序消息和事務(wù)消息。本文提供使用HTTP協(xié)議下的C# SDK收發(fā)普通消息的示例代碼。
前提條件
您已完成以下操作：
安裝C# SDK。更多信息，請(qǐng)參見(jiàn)準(zhǔn)備環(huán)境。
創(chuàng)建資源。代碼中涉及的資源信息，例如實(shí)例、Topic和Group ID等，需要在控制臺(tái)上提前創(chuàng)建。更多信息，請(qǐng)參見(jiàn)創(chuàng)建資源。
獲取阿里云訪問(wèn)密鑰AccessKey ID和AccessKey Secret。更多信息，請(qǐng)參見(jiàn)創(chuàng)建AccessKey。
發(fā)送普通消息
發(fā)送普通消息的示例代碼如下。
using System;
using System.Collections.Generic;
using System.Threading;
using Aliyun.MQ.Model;
using Aliyun.MQ.Model.Exp;
using Aliyun.MQ.Util;
namespace Aliyun.MQ.Sample
{
public class ProducerSample
{
// 設(shè)置HTTP協(xié)議客戶端接入點(diǎn)，進(jìn)入消息隊(duì)列RocketMQ版控制臺(tái)實(shí)例詳情頁(yè)面的接入點(diǎn)區(qū)域查看。
private const string _endpoint = "${HTTP_ENDPOINT}";
// 請(qǐng)確保環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET已設(shè)置。
// AccessKey ID，阿里云身份驗(yàn)證標(biāo)識(shí)。
private const string _accessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID");
// AccessKey Secret，阿里云身份驗(yàn)證密鑰。
private const string _secretAccessKey = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// 消息所屬的Topic，在消息隊(duì)列RocketMQ版控制臺(tái)創(chuàng)建。
private const string _topicName = "${TOPIC}";
// Topic所屬的實(shí)例ID，在消息隊(duì)列RocketMQ版控制臺(tái)創(chuàng)建。
// 若實(shí)例有命名空間，則實(shí)例ID必須傳入；若實(shí)例無(wú)命名空間，則實(shí)例ID傳入null空值或字符串空值。實(shí)例的命名空間可以在消息隊(duì)列RocketMQ版控制臺(tái)的實(shí)例詳情頁(yè)面查看。
private const string _instanceId = "${INSTANCE_ID}";
private static MQClient _client = new Aliyun.MQ.MQClient(_accessKeyId, _secretAccessKey, _endpoint);
static MQProducer producer = _client.GetProducer(_instanceId, _topicName);
static void Main(string[] args)
{
try
{
// 循環(huán)發(fā)送4條消息。
for (int i = 0; i < 4; i++)
{
TopicMessage sendMsg;
// 消息內(nèi)容。
sendMsg = new TopicMessage("hello mq");
// 設(shè)置消息的自定義屬性。
sendMsg.PutProperty("a", i.ToString());
// 設(shè)置消息的Key。
sendMsg.MessageKey = "MessageKey";
TopicMessage result = producer.PublishMessage(sendMsg);
Console.WriteLine("publis message success:" + result);
}
}
catch (Exception ex)
{
Console.Write(ex);
}
}
}
}訂閱普通消息
訂閱普通消息的示例代碼如下。
using System;
using System.Collections.Generic;
using System.Threading;
using Aliyun.MQ.Model;
using Aliyun.MQ.Model.Exp;
using Aliyun.MQ;
namespace Aliyun.MQ.Sample
{
public class ConsumerSample
{
// 設(shè)置HTTP協(xié)議客戶端接入點(diǎn)，進(jìn)入消息隊(duì)列RocketMQ版控制臺(tái)實(shí)例詳情頁(yè)面的接入點(diǎn)區(qū)域查看。
private const string _endpoint = "${HTTP_ENDPOINT}";
// 請(qǐng)確保環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET已設(shè)置。
// AccessKey ID，阿里云身份驗(yàn)證標(biāo)識(shí)。
private const string _accessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID");
// AccessKey Secret，阿里云身份驗(yàn)證密鑰。
private const string _secretAccessKey = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// 消息所屬的Topic，在消息隊(duì)列RocketMQ版控制臺(tái)創(chuàng)建。
private const string _topicName = "${TOPIC}";
// Topic所屬的實(shí)例ID，在消息隊(duì)列RocketMQ版控制臺(tái)創(chuàng)建。
// 若實(shí)例有命名空間，則實(shí)例ID必須傳入；若實(shí)例無(wú)命名空間，則實(shí)例ID傳入null空值或字符串空值。實(shí)例的命名空間可以在消息隊(duì)列RocketMQ版控制臺(tái)的實(shí)例詳情頁(yè)面查看。
private const string _instanceId = "${INSTANCE_ID}";
// 您在消息隊(duì)列RocketMQ版控制臺(tái)創(chuàng)建的Group ID。
private const string _groupId = "${GROUP_ID}";
private static MQClient _client = new Aliyun.MQ.MQClient(_accessKeyId, _secretAccessKey, _endpoint);
static MQConsumer consumer = _client.GetConsumer(_instanceId, _topicName, _groupId, null);
static void Main(string[] args)
{
// 在當(dāng)前線程循環(huán)消費(fèi)消息，建議多開(kāi)個(gè)幾個(gè)線程并發(fā)消費(fèi)消息。
while (true)
{
try
{
// 長(zhǎng)輪詢消費(fèi)消息。
// 長(zhǎng)輪詢表示如果Topic沒(méi)有消息,則請(qǐng)求會(huì)在服務(wù)端掛起3s，3s內(nèi)如果有消息可以消費(fèi)則立即返回客戶端。
List<Message> messages = null;
try
{
messages = consumer.ConsumeMessage(
3, // 一次最多消費(fèi)3條（最多可設(shè)置為16條）。
3 // 長(zhǎng)輪詢時(shí)間3秒（最多可設(shè)置為30秒）。
);
}
catch (Exception exp1)
{
if (exp1 is MessageNotExistException)
{
Console.WriteLine(Thread.CurrentThread.Name + " No new message, " + ((MessageNotExistException)exp1).RequestId);
continue;
}
Console.WriteLine(exp1);
Thread.Sleep(2000);
}
if (messages == null)
{
continue;
}
List<string> handlers = new List<string>();
Console.WriteLine(Thread.CurrentThread.Name + " Receive Messages:");
// 處理業(yè)務(wù)邏輯。
foreach (Message message in messages)
{
Console.WriteLine(message);
Console.WriteLine("Property a is:" + message.GetProperty("a"));
handlers.Add(message.ReceiptHandle);
}
// Message.nextConsumeTime前若不確認(rèn)消息消費(fèi)成功，則消息會(huì)被重復(fù)消費(fèi)。
// 消息句柄有時(shí)間戳，同一條消息每次消費(fèi)拿到的都不一樣。
try
{
consumer.AckMessage(handlers);
Console.WriteLine("Ack message success:");
foreach (string handle in handlers)
{
Console.Write("\t" + handle);
}
Console.WriteLine();
}
catch (Exception exp2)
{
// 某些消息的句柄可能超時(shí)，會(huì)導(dǎo)致消息消費(fèi)狀態(tài)確認(rèn)不成功。
if (exp2 is AckMessageException)
{
AckMessageException ackExp = (AckMessageException)exp2;
Console.WriteLine("Ack message fail, RequestId:" + ackExp.RequestId);
foreach (AckMessageErrorItem errorItem in ackExp.ErrorItems)
{
Console.WriteLine("\tErrorHandle:" + errorItem.ReceiptHandle + ",ErrorCode:" + errorItem.ErrorCode + ",ErrorMsg:" + errorItem.ErrorMessage);
}
}
}
}
catch (Exception ex)
{
Console.WriteLine(ex);
Thread.Sleep(2000);
}
}
}
}
}文檔內(nèi)容是否對(duì)您有幫助？