导语
在了解本篇文章之前,先复习以下知识点,如果你对RabbitMQ还不了解,请先查看RabbitMQ系列笔记介绍篇这篇文章。
- 生产者:发送消息的程序
- 队列:消息的中转站
- 消费者:接收消息的程序 在以上生产者同样也可以是消费者,消费者也可以是生产者,只需实现响应的发布订阅就行,本篇文章会从最简单的例子讲起。
小试牛刀
连接我们的RabbitMQ服务器
在连接我们的服务器之前,首先需要启动一个RabbitMQ服务器,这里推荐用docker容器快速启动,启动之后我们就可以在浏览器中访问服务器,获得可视化的界面,如图所示:
现在让我们用Golang代码进行连接,首先需要获得相应的包使用go get命令
代码语言:javascript复制go get github.com/streadway/amqp
写一个通用的错误处理函数
代码语言:javascript复制// 错误检查代码
func failOnError(err error, msg string) {
if err != nil {
log.Fatalf("%s:%s", msg, err)
panic(fmt.Sprintf("%s:%s", msg, err))
}
}
连接我们的服务器,在下面的代码中,首先我们使用Dial函数,用我们的账号密码,进行拨号获得一个TCP连接。
代码语言:javascript复制conn, err := amqp.Dial("amqp://admin:admin@192.168.10.252:5672")
failOnError(err, "Failed to connect to RabbitMQ")
defer conn.Close()
创建通道
有了连接我们需要创建一个通道,又称之为信道,信道是建立在“真实的”TCP 连接内的虚拟连接,AMQP 命令都是通过信道发送出去的,每条信道都会被指派一个唯一的ID(AMQP库会帮你记住ID的),不论是发布消息、订阅队列或者接收消息,这些动作都是通过信道来完成的。
代码语言:javascript复制ch, err := conn.Channel()
failOnError(err, "Failed to open a channel")
defer ch.Close()
申请队列
在发送消息之前我们需要用信道申请一个队列,存放我们的消息,具体的参数解释,请看代码注释
代码语言:javascript复制q, err := ch.QueueDeclare(
"hello", //队列的名字
true, //是否持久化
false, //对列没有用到的时候是否删除
false, //是否设置排他,true为是。如果设置为排他,则队列仅对首次声明他的连接可见,并在连接断开时自动删除
false, //是否非阻塞,true表示是。阻塞:表示创建交换器的请求发送后,阻塞等待RMQ Server返回信息
nil, //arguments
)
在上面中需要注意的是持久化的设置,这里的持久化设置为true,当我们重启我们的服务器时,我们的队列仍然存在,因为服务会把持久化的queue存放在硬盘上,但是消息的持久化,还需要在发送消息的时候进行设置。
发送消息
在这段代码中需要注意的是对消息的持久化设置,将这行代码去掉,即代表对消息不进行持久化。在发送消息的时候需要指定交换器和队列的名字,这样消费者才能准确的收到消息从该队列中。
代码语言:javascript复制body := "Hello"
err = ch.Publish(
"", //发送到交换机的名字
q.Name, // 路由,即队列的名字
false, //mandatory
false, //immediate
amqp.Publishing{
DeliveryMode: amqp.Persistent, //消息的持久化
ContentType: "text/plain",
Body: []byte(body),
},
)
消费者发送消息
在写以下的代码中最好新建一个消费者的文件,这个消费者程序,同样需要连接我们的服务器,和创建信道,申请队列,要保证和上面的代码完全一致。现在我们来看如何进行消费:
代码语言:javascript复制msgs, err := ch.Consume(
q.Name, //队列的名称
"", //消费者的名称
false, // 是否自动应答
false, //是否排他
false, // 如果设置为true,则生产者与消费者不能是同一连接
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to register a consumer")
forever := make(chan bool)
go func() {
for d := range msgs {
log.Printf("Received a message : %s", d.Body)
// 开始手动应答
d.Acknowledger.Ack(d.DeliveryTag, true)
}
}()
log.Printf(" [*] Waiting for messages, To exit press CTRL C")
<-forever
上面代码中需要注意的是消费需要指定队列的名字,是否设置自动应答,这里推荐false我们使用了d.Acknowledger.Ack(d.DeliveryTag, true)进行手动应答,防止消息丢失,只有确保我们收到消息,才应该告诉服务器,将这条消息进行删除,另外需要注意的是,我们创建了一个协程来持续消费消息,只要生产者生产消息,发送到相应的队列,我们就可以对消息进行打印,为防止main函数的主进程提前结束,我们使用forever这个通道进行阻塞,只有强制结束程序,forever才会释放阻塞。
运行效果
生产者发送4条消息
可视化界面显示
消费者收消息
最终可视化界面显示