前提條件

您已完成以下操作：

• 安裝Go SDK。更多信息，請參見準備環(huán)境。

• 創(chuàng)建資源。代碼中涉及的資源信息，例如實例、Topic和Group ID等，需要在控制臺上提前創(chuàng)建。更多信息，請參見創(chuàng)建資源。

• 獲取阿里云訪問密鑰AccessKey ID和AccessKey Secret。更多信息，請參見創(chuàng)建AccessKey。

發(fā)送普通消息

發(fā)送普通消息的示例代碼如下。

package main

import (
    "fmt"
    "time"
    "strconv"
    "os"

    "github.com/aliyunmq/mq-http-go-sdk"
)

func main() {
    // 設置HTTP協(xié)議客戶端接入點，進入消息隊列RocketMQ版控制臺實例詳情頁面的接入點區(qū)域查看。
    endpoint := "${HTTP_ENDPOINT}"
    // 請確保環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET已設置。
    // AccessKey ID，阿里云身份驗證標識。
    accessKey := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
    // AccessKey Secret，阿里云身份驗證密鑰。
    secretKey := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
    // 消息所屬的Topic，在消息隊列RocketMQ版控制臺創(chuàng)建。
    topic := "${TOPIC}"
    // Topic所屬的實例ID，在消息隊列RocketMQ版控制臺創(chuàng)建。
    // 若實例有命名空間，則實例ID必須傳入；若實例無命名空間，則實例ID傳入null空值或字符串空值。實例的命名空間可以在消息隊列RocketMQ版控制臺的實例詳情頁面查看。
    instanceId := "${INSTANCE_ID}"

    client := mq_http_sdk.NewAliyunMQClient(endpoint, accessKey, secretKey, "")

    mqProducer := client.GetProducer(instanceId, topic)
    // 循環(huán)發(fā)送4條消息。
    for i := 0; i < 4; i++ {
        var msg mq_http_sdk.PublishMessageRequest

        msg = mq_http_sdk.PublishMessageRequest{
        MessageBody: "hello mq!",         //消息內(nèi)容。
        MessageTag:  "",                  // 消息標簽。
        Properties:  map[string]string{}, // 消息屬性。
        }
        // 設置消息的Key。
        msg.MessageKey = "MessageKey"
        // 設置消息自定義屬性。
        msg.Properties["a"] = strconv.Itoa(i)

        ret, err := mqProducer.PublishMessage(msg)

        if err != nil {
            fmt.Println(err)
            return
        } else {
            fmt.Printf("Publish ---->\n\tMessageId:%s, BodyMD5:%s, \n", ret.MessageId, ret.MessageBodyMD5)
        }
        time.Sleep(time.Duration(100) * time.Millisecond)
    }
}

訂閱普通消息

訂閱普通消息的示例代碼如下。

package main

import (
    "fmt"
    "github.com/gogap/errors"
    "strings"
    "time"
    "os"

    "github.com/aliyunmq/mq-http-go-sdk"
)

func main() {
    // 設置HTTP協(xié)議客戶端接入點，進入消息隊列RocketMQ版控制臺實例詳情頁面的接入點區(qū)域查看。
    endpoint := "${HTTP_ENDPOINT}"
    // 請確保環(huán)境變量ALIBABA_CLOUD_ACCESS_KEY_ID、ALIBABA_CLOUD_ACCESS_KEY_SECRET已設置。
    // AccessKey ID，阿里云身份驗證標識。
    accessKey := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")
    // AccessKey Secret，阿里云身份驗證密鑰。
    secretKey := os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
    // 消息所屬的Topic，在消息隊列RocketMQ版控制臺創(chuàng)建。
    //不同消息類型的Topic不能混用，例如普通消息的Topic只能用于收發(fā)普通消息，不能用于收發(fā)其他類型的消息。
    topic := "${TOPIC}"
    // Topic所屬的實例ID，在消息隊列RocketMQ版控制臺創(chuàng)建。
    // 若實例有命名空間，則實例ID必須傳入；若實例無命名空間，則實例ID傳入null空值或字符串空值。實例的命名空間可以在消息隊列RocketMQ版控制臺的實例詳情頁面查看。
    instanceId := "${INSTANCE_ID}"
    // 您在控制臺創(chuàng)建的Group ID。
    groupId := "${GROUP_ID}"

    client := mq_http_sdk.NewAliyunMQClient(endpoint, accessKey, secretKey, "")

    mqConsumer := client.GetConsumer(instanceId, topic, groupId, "")

    for {
        endChan := make(chan int)
        respChan := make(chan mq_http_sdk.ConsumeMessageResponse)
        errChan := make(chan error)
        go func() {
            select {
            case resp := <-respChan:
                {
                    // 處理業(yè)務邏輯。
                    var handles []string
                    fmt.Printf("Consume %d messages---->\n", len(resp.Messages))
                    for _, v := range resp.Messages {
                        handles = append(handles, v.ReceiptHandle)
                        fmt.Printf("\tMessageID: %s, PublishTime: %d, MessageTag: %s\n"+
                            "\tConsumedTimes: %d, FirstConsumeTime: %d, NextConsumeTime: %d\n"+
                            "\tBody: %s\n"+
                            "\tProps: %s\n",
                            v.MessageId, v.PublishTime, v.MessageTag, v.ConsumedTimes,
                            v.FirstConsumeTime, v.NextConsumeTime, v.MessageBody, v.Properties)
                    }

                    // NextConsumeTime前若不確認消息消費成功，則消息會被重復消費。
                    // 消息句柄有時間戳，同一條消息每次消費拿到的都不一樣。
                    ackerr := mqConsumer.AckMessage(handles)
                    if ackerr != nil {
                        // 某些消息的句柄可能超時，會導致消息消費狀態(tài)確認不成功。
                        fmt.Println(ackerr)
                        if errAckItems, ok := ackerr.(errors.ErrCode).Context()["Detail"].([]mq_http_sdk.ErrAckItem); ok {
                           for _, errAckItem := range errAckItems {
                             fmt.Printf("\tErrorHandle:%s, ErrorCode:%s, ErrorMsg:%s\n",
                               errAckItem.ErrorHandle, errAckItem.ErrorCode, errAckItem.ErrorMsg)
                           }
                        } else {
                           fmt.Println("ack err =", ackerr)
                        }
                        time.Sleep(time.Duration(3) * time.Second)
                    } else {
                        fmt.Printf("Ack ---->\n\t%s\n", handles)
                    }

                    endChan <- 1
                }
            case err := <-errChan:
                {
                    // Topic中沒有消息可消費。
                    if strings.Contains(err.(errors.ErrCode).Error(), "MessageNotExist") {
                        fmt.Println("\nNo new message, continue!")
                    } else {
                        fmt.Println(err)
                        time.Sleep(time.Duration(3) * time.Second)
                    }
                    endChan <- 1
                }
            case <-time.After(35 * time.Second):
                {
                    fmt.Println("Timeout of consumer message ??")
                    endChan <- 1
                }
            }
        }()

        // 長輪詢消費消息，網(wǎng)絡超時時間默認為35s。
        // 長輪詢表示如果Topic沒有消息，則客戶端請求會在服務端掛起3s，3s內(nèi)如果有消息可以消費則立即返回響應。
        mqConsumer.ConsumeMessage(respChan, errChan,
            3, // 一次最多消費3條（最多可設置為16條）。
            3, // 長輪詢時間3s（最多可設置為30s）。
        )
        <-endChan
    }
}