RabbitMQ是一个消息代理:它接收和转发消息。你可以把它看作邮局,当你把要发送的邮件放在邮箱中,你可以确定最终会将邮件发送到你的收件人手中。下面先了解下RabbitMQ中的一些术语。
注意: 生产者、消费者和代理不必放在同一主机上,应用程序也可以既是生产者又是消费者。
下面的例子中,有两个简单程序。一个是生产者发送消息,一个是消费者接收消息并打印。RabbitMQ支持多种协议,后面的例子中都使用AMQP 0-9-1
协议。它是一种开发的通用的消息传递协议。为了使用amqp客户端,首先通过命令go get github.com/streadway/amqp
安装amqp
。
在send.go文件中定义消息发布者,receive.go文件定义消息消费者。发布者将会连接RabbitMQ,发送一个消息,然后退出。
package main
import (
"github.com/streadway/amqp"
"log"
)
// failOnError用来检查每个amqp调用的返回结果
func failOnError(err error, msg string) {
if err != nil {
log.Fatalf("%s: %s", msg, err)
}
}
func main() {
// 连接RabbitMQ服务器,返回一个connection。它抽象了socket连接
conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
failOnError(err, "Failed to connect to RabbitMQ")
defer conn.Close()
// 创建通道,任务在这里面完成
ch, err := conn.Channel()
failOnError(err, "Failed to open a channel")
defer ch.Close()
// 必须声明一个队列供我们发送,然后我们可以向队列发布消息
// 声明队列是幂等的,只有在它不存在的情况下才会创建它
q, err := ch.QueueDeclare(
"hello", // name
false, // durable
false, // delete when unused
false, // exclusive
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare a queue")
// 消息内容是一个字节数组,因此你可以编码任何内容
body := "Hello World!"
err = ch.Publish(
"", // exchange
q.Name, // routing key
false, // mandatory
false, // immediate
amqp.Publishing{
ContentType: "text/plain",
Body: []byte(body),
})
log.Printf(" [x] Sent %s", body)
failOnError(err, "Failed to publish a message")
}
package main
import (
"log"
"github.com/streadway/amqp"
)
func failOnError(err error, msg string) {
if err != nil {
log.Fatalf("%s: %s", msg, err)
}
}
func main() {
conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
failOnError(err, "Failed to connect to RabbitMQ")
defer conn.Close()
ch, err := conn.Channel()
failOnError(err, "Failed to open a channel")
defer ch.Close()
// 在这里也声明了队列,因为我们可能在发布者发布之前启动消费者,
// 所以希望在尝试使用消息之前,确保队列存在
q, err := ch.QueueDeclare(
"hello", // name
false, // durable
false, // delete when unused
false, // exclusive
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare a queue")
msgs, err := ch.Consume(
q.Name, // queue
"", // consumer
true, // auto-ack
false, // exclusive
false, // no-local
false, // no-wait
nil, // args
)
failOnError(err, "Failed to register a consumer")
forever := make(chan bool)
// 告诉服务器从队列中传递消息,因为它会异步的向我们发送消息
// 在goroutine中读取来在通道(amqp::Consume返回)的消息
go func() {
for d := range msgs {
log.Printf("Received a message: %s", d.Body)
}
}()
log.Printf(" [*] Waiting for messages. To exit press CTRL+C")
<-forever
}
运行上面两个程序(前提是安装了RabbitMQ以及在localhost:5672上运行),消费者将通过RabbitMQ打印从发布者处获得的消息。消费者将继续运行,等待消息,或者使用ctrl+c
停止。