rabbitmq消息队列——"Hello World!"

时间:2023-03-09 16:23:23
rabbitmq消息队列——"Hello World!"

RabbitMQ

一、”Hello World!”

1、简介:

RabbitMQ是一种消息中间件,主要思想很简单:接收消息并转发。你可以将它设想为一个邮局:你往里面发送邮件并确保邮件能实际运达,RabbitMQ好比这里的邮箱、邮局和邮递员的角色。

RabbitMQ和邮局的一个主要区别是,RabbitMQ仅仅接收、存储、转发这些数据包裹——message。

先来看下RabbitMQ中的一些关键术语:

a)、生产(者):除了发送什么意义都没有。一个发送消息的应用就是一个生产者,使用如下描述:

rabbitmq消息队列——"Hello World!"

b)、队列:储存消息的“容器”,可以储存任意多的message——本质上是一个无限长度的缓冲区,多个生产者可以将消息发送至同一队列,多个消费者也可以从同一队列中接收消息。队列使用如下描述,”queue_name”是该队列的名称:

rabbitmq消息队列——"Hello World!"

c)、消费(者):一个消费者就好比一个用来等待接收消息的程序。使用如下来描述:

rabbitmq消息队列——"Hello World!"

2、”Hello World!”(使用Go RabbitMQ客户端)

这节我们将使用Go写两个小程序:一个生产者用来发送单一消息,一个消费者用来接收这些消息并打印。图示如下:

rabbitmq消息队列——"Hello World!"

备注:这里使用“amqp”包,自行安装:
go get github.com/streadway/amqp

发送:

首先创建一个send.go和receiver.go分别用来发送和接收,发送方会链接RabbitMQ服务器、发送消息然后退出。

在send.go,首先导入相关包:

package main

import (
"fmt"
"log" "github.com/streadway/amqp"
)

再加一个出错处理类:

func failOnError(err error, msg string) {
if err != nil {
log.Fatalf("%s: %s", msg, err)
panic(fmt.Sprintf("%s: %s", msg, err))
}
}

连接到服务器:

conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")  //一般默认端口5672
failOnError(err, "Failed to connect to RabbitMQ")
defer conn.Close()

这里的conn对象是抽象了底层的socket链接,在conn的基础上我们可以创建多个channel(通道,一个conn可以创建多个channel,使用channel节省了tcp资源,后续的很多操作如:队列声明、消息声明发送、交换器声明等都是在channel基础上操作的),接下来是产生一个channel:

ch, err := conn.Channel()
failOnError(err, "Failed to open a channel")
defer ch.Close()

为了发送消息到队列,我们还应该声明一个队列,并将消息发送给它:

q, err := ch.QueueDeclare(
"hello", // name 队列名称
false, // durable 是否持久化,默认为false
false, // delete when unused 队列无订阅时是否自动删除队列
false, // exclusive 是否队列私有,私有后仅有一个应用可以连接
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare a queue") body := "hello" //消息主体
err = ch.Publish( //发送消息
"", // exchange //指定消息发送的交换器名称
q.Name, // routing key //路由键
false, // mandatory
false, // immediate
amqp.Publishing {
ContentType: "text/plain", //消息类型:文本消息
Body: []byte(body), //消息体,理论上可以发送任意类型数据,因为是byte类型
})
failOnError(err, "Failed to publish a message")

至此发送方代码完毕!

接收:

接收跟发送不同的是,接收端一直运行监听发送端消息发送并打印输出,接收端的模型如下:

rabbitmq消息队列——"Hello World!"

在这里,我们仍然使用send.go中的逻辑执行,首先是链接服务器,其次是声明channel和队列(可以防止接收端启动时发送端还没有启动的情况),主要代码如下:

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 usused
false, // exclusive
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare a queue")

这里声明的队列名称就是send.go中声明的队列,然后从该队列中读取消息并打印:

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) 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

至此,所有代码书写完毕,完整版代码如下:

发送:

package main

import (
"fmt"
"log" "github.com/streadway/amqp"
) func failOnError(err error, msg string) {
if err != nil {
log.Fatalf("%s:%s", msg, err)
panic(fmt.Sprintf("%s:%s", msg, err))
}
} func main() {
//链接rabbitMQ服务器
conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
failOnError(err, "fail to connect to rabbitmq server")
defer conn.Close() //声明一个channel
ch, err := conn.Channel()
failOnError(err, "fail to open a channel")
defer ch.Close() //根据channel声明一个队列
q, err := ch.QueueDeclare("queue_name", false, false, false, false, nil)
failOnError(err, "fail to define a queue") //使用channel直接发送消息至队列
body := "hello queue!"
err = ch.Publish("", q.Name, false, false, amqp.Publishing{
ContentType: "text/plain",
Body: []byte(body),
})
failOnError(err, "fail to publish the message")
}

接收:

// rabbitmq_1.receiver project main.go
package main import (
"fmt"
"log" "github.com/streadway/amqp"
) func main() {
//链接RabbitMQ服务器
conn, err := amqp.Dial("amqp://guest:guest@localhost:5672/")
failOnError(err, "Failed to connect to RabbitMQ")
defer conn.Close() //声明一个channel
ch, err := conn.Channel()
failOnError(err, "failed to open a channel")
defer ch.Close() //使用channel声明一个队列
q, err := ch.QueueDeclare("queue_name", false, false, false, false, nil)
failOnError(err, "failed to declare a queue") //注册一个消费者
msgs, err := ch.Consume(q.Name, "", true, false, false, false, nil)
failOnError(err, "failed to register a consumer") //定义一个never型chan,用于防止进程退出
var forever chan bool = make(chan bool, )
//开启一个channel,实时打印channel中的消息
go func() {
for d := range msgs {
log.Printf("received a message:%s", d.Body)
}
}() log.Printf("press Ctrl+c to exit!")
<-forever
} func failOnError(err error, msg string) {
if err != nil {
log.Fatalf("%s: %s", msg, err)
panic(fmt.Sprintf("%s: %s", msg, err))
}
}

rabbitmq消息队列——"Hello World!"

然后我们使用RabbitMQ自带的管理工具查看mq运行情况:

首先要开启管理工具:
rabbitmq-plugins enable rabbitmq_management

然后浏览器访问地址:http://localhost:15672/,这里输入默认用户名密码:guest/guest,进去后界面如下:

rabbitmq消息队列——"Hello World!"

rabbitmq消息队列——"Hello World!"

rabbitmq消息队列——"Hello World!"