topic交換器(主題交換器)
發(fā)送到topic交換器
的消息不能具有隨意的routing_key
——它必須是單詞列表,以點(diǎn)分隔。這些詞可以是任何東西,但通常它們指定與消息相關(guān)的某些功能。一些有效的routing_key
示例:“stock.usd.nyse”
,“nyse.vmw”
,“quick.orange.rabbit”
。routing_key
中可以包含任意多個(gè)單詞,最多255個(gè)字節(jié)。
綁定鍵也必須采用相同的形式。topic交換器
背后的邏輯類似于direct交換器
——用特定路由鍵發(fā)送的消息將傳遞到所有匹配綁定鍵綁定的隊(duì)列。但是,綁定鍵有兩個(gè)重要的特殊情況: - *
(星號(hào))可以代替一個(gè)單詞。 - #
(井號(hào))可以替代零個(gè)或多個(gè)單詞。
通過(guò)下面這個(gè)示例可以很容易看明白這一點(diǎn):
在這個(gè)例子中,我們將發(fā)送一些都是描述動(dòng)物的信息。將使用包含三個(gè)詞(兩個(gè)點(diǎn))的路由密鑰發(fā)送消息。路由鍵中的第一個(gè)單詞將描述速度,第二個(gè)是顏色,第三個(gè)是種類:“<speed>.<colour>.<species>”
。
我們創(chuàng)建了三個(gè)綁定關(guān)系:Q1與綁定鍵“ * .orange. * ”綁定,Q2與“* .* .rabbit”和“l(fā)azy.#”綁定。
這些綁定可以總結(jié)為:
- Q1對(duì)所有橙色動(dòng)物都感興趣
- Q2想接收有關(guān)兔子(rabbit)的一切消息,以及有關(guān)懶惰(lazy)動(dòng)物的一切消息。
路由鍵設(shè)置為“quick.orange.rabbit”
的消息將傳遞到兩個(gè)隊(duì)列。消息“l(fā)azy.orange.elephant”
也將發(fā)送給他們兩個(gè)。另一方面,“quick.orange.fox”
將僅進(jìn)入第一個(gè)隊(duì)列,而“l(fā)azy.brown.fox”
將僅進(jìn)入第二個(gè)隊(duì)列。即使“l(fā)azy.pink.rabbit”
與兩個(gè)綁定匹配(匹配Q2的兩個(gè)綁定),也只會(huì)傳遞到第二個(gè)隊(duì)列一次。 “quick.brown.fox”
與任何綁定都不匹配,因此將被丟棄。
如果我們打破約定并發(fā)送一個(gè)或四個(gè)單詞的消息,例如“orange”
或“quick.orange.male.rabbit”
,會(huì)發(fā)生什么?好吧,這些消息將不匹配任何綁定,并且將會(huì)丟失。
另外,“l(fā)azy.orange.male.rabbit”
即使有四個(gè)單詞,也將匹配最后一個(gè)綁定,并將其傳送到第二個(gè)隊(duì)列。
topic交換器
topic交換器功能強(qiáng)大,可以像其他交換器一樣運(yùn)行。
當(dāng)隊(duì)列用
“#”
(井號(hào))綁定鍵綁定時(shí),它將接收所有消息,而與路由鍵無(wú)關(guān),就像在fanout
交換器中一樣。當(dāng)在綁定中不使用特殊字符
“*”
(星號(hào))和“#”
(井號(hào))時(shí),topic交換器的行為就像direct交換器一樣。
完整示例
我們將在日志記錄系統(tǒng)中使用topic
交換器。我們將從一個(gè)可行的假設(shè)開(kāi)始,即日志的路由鍵將包含兩個(gè)詞:“<facility>.<severity>”
。
emit_log_topic.go
的代碼:
package main
import (
"log"
"os"
"strings"
"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()
err = ch.ExchangeDeclare(
"logs_topic", // name
"topic", // type
true, // durable
false, // auto-deleted
false, // internal
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare an exchange")
body := bodyFrom(os.Args)
err = ch.Publish(
"logs_topic", // exchange
severityFrom(os.Args), // routing key
false, // mandatory
false, // immediate
amqp.Publishing{
ContentType: "text/plain",
Body: []byte(body),
})
failOnError(err, "Failed to publish a message")
log.Printf(" [x] Sent %s", body)
}
func bodyFrom(args []string) string {
var s string
if (len(args) < 3) || os.Args[2] == "" {
s = "hello"
} else {
s = strings.Join(args[2:], " ")
}
return s
}
func severityFrom(args []string) string {
var s string
if (len(args) < 2) || os.Args[1] == "" {
s = "anonymous.info"
} else {
s = os.Args[1]
}
return s
}
receive_logs_topic.go
的代碼:
package main
import (
"log"
"os"
"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()
err = ch.ExchangeDeclare(
"logs_topic", // name
"topic", // type
true, // durable
false, // auto-deleted
false, // internal
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare an exchange")
q, err := ch.QueueDeclare(
"", // name
false, // durable
false, // delete when unused
true, // exclusive
false, // no-wait
nil, // arguments
)
failOnError(err, "Failed to declare a queue")
if len(os.Args) < 2 {
log.Printf("Usage: %s [binding_key]...", os.Args[0])
os.Exit(0)
}
// 綁定topic
for _, s := range os.Args[1:] {
log.Printf("Binding queue %s to exchange %s with routing key %s",
q.Name, "logs_topic", s)
err = ch.QueueBind(
q.Name, // queue name
s, // routing key
"logs_topic", // exchange
false,
nil)
failOnError(err, "Failed to bind 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)
go func() {
for d := range msgs {
log.Printf(" [x] %s", d.Body)
}
}()
log.Printf(" [*] Waiting for logs. To exit press CTRL+C")
<-forever
}
想要接收所有的日志:
go run receive_logs_topic.go "#"
要從“kern”
接收所有日志:
go run receive_logs_topic.go "kern.*"
或者,如果你只想接收“critical”
日志:
go run receive_logs_topic.go "*.critical"
你可以創(chuàng)建多個(gè)綁定:
go run receive_logs_topic.go "kern.*" "*.critical"
并發(fā)出帶有路由鍵“kern.critical”
的日志:
go run emit_log_topic.go "kern.critical" "A critical kernel error"
你可以自己嘗試玩一下這個(gè)程序。請(qǐng)注意,代碼沒(méi)有對(duì)路由鍵或綁定鍵進(jìn)行任何假設(shè),你可能希望使用兩個(gè)以上的路由鍵參數(shù)。文章來(lái)源:http://www.zghlxwxcb.cn/news/detail-634730.html
源自:https://www.rabbitmq.com/getstarted.html文章來(lái)源地址http://www.zghlxwxcb.cn/news/detail-634730.html
到了這里,關(guān)于【RabbitMQ】golang客戶端教程5——使用topic交換器的文章就介紹完了。如果您還想了解更多內(nèi)容,請(qǐng)?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持TOY模板網(wǎng)!