RabbitMQ官网的消息模型的第五种-Topic

topic交换器

topic(主题)交换器

​ 发送到topic交换器的消息不能具有随意的routing_key——它必须是单词列表，以点分隔。这些词可以是任何东西，但通常它们指定与消息相关的某些功能。一些有效的routing_key示例：“stock.usd.nyse”，“nyse.vmw”，

“quick.orange.rabbit”。routing_key中可以包含任意多个单词，最多255个字节。

​ 绑定键也必须采用相同的形式。topic交换器背后的逻辑类似于direct交换器——用特定路由键发送的消息将传递到所有匹配绑定键绑定的队列。但是，绑定键有两个重要的特殊情况： - *（星号）可以代替一个单词。 - ＃（井号）可以替代零个或多个单词。

​ Topic类型的Exchange与Direct相比，都是可以根据RoutingKey把消息路由到不同的队列。只不过Topic类型Exchange可以让队列在绑定Routing Key的时候使用通配符! 这种模型RoutingKey一般都是一个或多个单词组成，多个单词间以".“分割，例如: item.insert

通配符

  • * (star) can substitute for exactly one word. 匹配不多不少刚好一个词

  • # (hash) can substitute for zero or more words. 匹配0个或多个词

例如：

audit.# 匹配audit.irs.corporate或者audit.irs等

audit.* 只能匹配audit.irs

​ 以上图作为示例，我们将发送一些都是描述动物的信息。将使用包含三个词（两个点）的路由密钥发送消息。路由键中的第一个单词将描述速度，第二个是颜色，第三个是种类："<speed>.<colour>.<species>"。

我们创建了三个绑定关系：Q1与绑定键“*.orange.*”绑定，Q2与“*.*.rabbit”和“lazy.＃”绑定。

这些绑定可以总结为：

  • Q1对所有橙色动物都感兴趣。
  • Q2想接收有关兔子（rabbit）的一切消息，以及有关懒惰（lazy）动物的一切消息。

路由键设置为“quick.orange.rabbit”的消息将传递到两个队列。消息“lazy.orange.elephant”也将发送给他们两个。另一方面，“quick.orange.fox”将仅进入第一个队列，而“lazy.brown.fox”将仅进入第二个队列。即使“lazy.pink.rabbit”与两个绑定匹配（匹配Q2的两个绑定），也只会传递到第二个队列一次。 “quick.brown.fox”与任何绑定都不匹配，因此将被丢弃。

如果我们打破约定并发送一个或四个单词的消息，例如“orange”或“

quick.orange.male.rabbit”，会发生什么？好吧，这些消息将不匹配任何绑定，并且将会丢失。

另外，“lazy.orange.male.rabbit”即使有四个单词，也将匹配最后一个绑定，并将其传送到第二个队列。

topic交换器

topic交换器功能强大，可以像其他交换器一样运行。

当队列用“#”作为绑定键绑定时，它将接收所有消息，而与路由键无关，就像在fanout交换器中一样；

当在绑定中不使用特殊字符“*”（星号）和“#”（井号）时，topic交换器的行为就像direct交换器一样。

完整demo

我们将在日志记录系统中使用topic交换器。我们将从一个可行的假设开始，即日志的路由键将包含两个词：“<facility>.<severity>”。

该代码与上一教程中的代码几乎相同。

producer.go

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

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://admin:admin@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
}

consumer.go

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

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://admin:admin@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
}

想要接收所有的日志：

1

go run consumer.go "#"

要从“kern”接收所有日志：

1

go run consumer.go "kern.*"

或者，如果你只想接收“critical”日志：

1

go run consumer.go "*.critical"

你可以创建多个绑定：

1

go run consumer.go "kern.*" "*.critical"

并发出带有路由键“kern.critical”的日志：

1

go run producer.go "kern.critical" "A critical kernel error"

测试

  • rabbitMQ web面板

1630917157347

1630917256069

  • 消费者

1630917334725

1630917363122

  • 生产者

1630917396703

参考资料

  1. RabbitMQ官网 Topic模式-Go客户端
  2. 李文周老师 Go语言客户端教程5-topic
  3. MQ消息中间件之RabbitMQ