消息队列 RocketMQ 5.x版本提供顺序消息(FIFO消息)供您使用。在顺序消息模型中,您需要严格按照顺序来发布和消费消息。本文提供使用 GO SDK 收发顺序消息的示例代码供您参考。
顺序消息分为两类,全局顺序消息和分区顺序消息。区别仅为队列数量不同,代码没有区别。
注意顺序消息,需要在控制台申请顺序类型的topic以及顺序类型的group
发送顺序消息的示例代码如下。
package main import ( "context" "fmt" "log" "os" "strconv" "time" rmq_client "github.com/apache/rocketmq-clients/golang/v5" "github.com/apache/rocketmq-clients/golang/v5/credentials" ) /* * 设置为您从火山引擎消息队列 RocketMQ版控制台获取的接入点信息,类似“http://{INSTANCE_ID}.rocketmq.ivolces.com.com:8080”。 * 设置RocketMQ实例的AccessKey ID和AccessKey Secret。 */ const ( Topic = "xxxx" Endpoint = "rocketmq-xxxx:8080" AccessKey = "xxxx" SecretKey = "xxxx" ) func main() { // log to console os.Setenv("mq.consoleAppender.enabled", "true") rmq_client.ResetLogger() // In most case, you don't need to create many producers, singleton pattern is more recommended. producer, err := rmq_client.NewProducer(&rmq_client.Config{ Endpoint: Endpoint, Credentials: &credentials.SessionCredentials{ AccessKey: AccessKey, AccessSecret: SecretKey, }, }, rmq_client.WithTopics(Topic), ) if err != nil { log.Fatal(err) } // start producer err = producer.Start() if err != nil { log.Fatal(err) } // graceful stop producer defer producer.GracefulStop() for i := 0; i < 10; i++ { // new a message msg := &rmq_client.Message{ Topic: Topic, Body: []byte("this is a message : " + strconv.Itoa(i)), } // set keys and tag msg.SetKeys("a", "b") msg.SetTag("ab") // Message group decides the message delivery order. msg.SetMessageGroup("fifo") // send message in sync resp, err := producer.Send(context.TODO(), msg) if err != nil { log.Fatal(err) } for i := 0; i < len(resp); i++ { fmt.Printf("%#v\n", resp[i]) } // wait a moment time.Sleep(time.Second * 1) } }
订阅顺序消息的示例代码如下,要注意group一定是申请的顺序类型
package main import ( "context" "fmt" "log" "os" "time" rmq_client "github.com/apache/rocketmq-clients/golang/v5" "github.com/apache/rocketmq-clients/golang/v5/credentials" ) /* * 设置为您从火山引擎消息队列 RocketMQ版控制台获取的接入点信息,类似“http://{INSTANCE_ID}.rocketmq.ivolces.com.com:8080”。 * 设置RocketMQ实例的AccessKey ID和AccessKey Secret。 */ const ( Topic = "xxxx" ConsumerGroup = "xxxx" Endpoint = "rocketmq-xxxx:8080" AccessKey = "xxxx" SecretKey = "xxxx" ) var ( // maximum waiting time for receive func awaitDuration = time.Second * 5 // maximum number of messages received at one time maxMessageNum int32 = 16 // invisibleDuration should > 20s invisibleDuration = time.Second * 20 // receive messages in a loop ) func main() { // log to console os.Setenv("mq.consoleAppender.enabled", "true") rmq_client.ResetLogger() // In most case, you don't need to create many consumers, singleton pattern is more recommended. simpleConsumer, err := rmq_client.NewSimpleConsumer(&rmq_client.Config{ Endpoint: Endpoint, ConsumerGroup: ConsumerGroup, Credentials: &credentials.SessionCredentials{ AccessKey: AccessKey, AccessSecret: SecretKey, }, }, rmq_client.WithAwaitDuration(awaitDuration), rmq_client.WithSubscriptionExpressions(map[string]*rmq_client.FilterExpression{ Topic: rmq_client.SUB_ALL, }), ) if err != nil { log.Fatal(err) } // start simpleConsumer err = simpleConsumer.Start() if err != nil { log.Fatal(err) } // graceful stop simpleConsumer defer simpleConsumer.GracefulStop() go func() { for { fmt.Println("start receive message") mvs, err := simpleConsumer.Receive(context.TODO(), maxMessageNum, invisibleDuration) if err != nil { fmt.Println(err) } // ack message for _, mv := range mvs { simpleConsumer.Ack(context.TODO(), mv) fmt.Println(mv) } fmt.Println("wait a moment") fmt.Println() } }() // run for a while time.Sleep(100 * time.Minute) }