《RabbitMQ入门之Go语言教程》(5) 主题交换器

上一篇文章中,我们对之前的日志系统进行了改进,使用direct类型的exchange替代了只能广播消息的fanout类型,让日志系统能够有选择性的接收处理消息。

虽然使用direct类型的exchange提升了日志系统的扩展性,但还是有它的局限性存在,那就是无法配置多重标准的路由。

如果想让系统不能仅根据日志级别来定义,还能根据发送日志的源信息来订阅。如unix工具syslog,就是根据日志级别(info/warn/crit..)和设备(auth/cron/kern)来进行路由的。这会提供更多的灵活性,如可以做到监听所有来自'cron'和'kern'设备的error信息。

为了实现这种灵活性,需要来学习下另外一个功能更综合的topic类型的交换器(exchange).

Topic exchange

Topic类型的exchange消息的routing key是有一定限制的,必须是一组使用“.”分开的单词。单词可以是任意的,但是一般来说以能准确的表达功能的为佳。如以下的例子都是合法的:"stock.usd.nyse", "nyse.vmw","quick.orange.rabbit".Routing key可以是任意多个单词组成,但其总长度不能超过255个字节。

Topic exchange的binding key跟之前的没有太大区别,其逻辑跟direct一样,其接收到的消息会分发到所有与其routing key相匹配的绑定队列。以下两个通配符也可作为binding key使用:

*   表示一个单词
#   表示0或多个单词

看例子:

python-five.png

上图中,消息的routing key用三个单词来表示,依次表示速度、颜色、种类,其形式如:"<speed>.<color>.<species>”。

图中有三个绑定:Q1的绑定键是"*.orange.*", Q2的绑定键是"*.*.rabbit"和"lazy.#".

这三个绑定规则可以简单概括为:

Q1对orange颜色的动物感兴趣;
Q2则对所有物种是rabbit的、速度是lazy的所有动物感兴趣;

举例来说明带有不同routing key的消息会被路由到哪个队列:

"quick.orange.rabbit":      分发到Q1和Q2;
"lazy.orange.elephant":     分发到Q1和Q2;
"quick.orange.fox":         分发到Q1;
"lazy.brown.fox":           分发到Q2;
"lazy.pink.rabbit":         分发到Q2,且只会分发一次,虽然它匹配了Q2的两个绑定;
"quick.brown.fox":          Q1、Q2都不分发,因为没有与之匹配的绑定规则,将会被忽略;
"orange":                   无匹配规则,丢失
"quick.orange.male.rabbit": 无匹配规则,丢失
"lazy.orange.male.rabbit":  分发到Q2,虽然有4个单词,但符合"lazy.#"规则的通配符

Topic exchange

Topic exchange很灵活,也很容易用此实现其他类型的功能.

如果将"#"指定为绑定键,那么就会接收所有的消息,相当于fanout类型的广播;

如果通配符"*","#"均不作为绑定键使用,那么其功能实现就等同于direct类型;

整个文件

在前一篇的基础上实现topic exchange,只需做少许改的即可,这里我们假设routing key由两个单词组成,类似于"<facility>.<severity>".

emit_log_topic.go:

package main

import (
    "fmt"
    "log"
    "os"
    "strings"

    "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(){
    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 an channel")
    defer ch.Close()

    err = ch.ExchangeDeclare(
        "logs_topic",     //name
        "topic",         //type
        true,    
        false,
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to declare an exchange")
    body := bodyFrom(os.Args)
    err = ch.Publish(
        "logs_topic",            // exchange
        severityFrom(os.Args),    //routing key
        false,
        false,
        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 || args[1] == "" {
        s = "info"
    }else {
        s = os.Args[1]
    }

    return s
}

Github地址

receive_logs_topic.go:

package main

import(
    "fmt"
    "log"
    "os"

    "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(){
    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",
        "topic",
        true,
        false, 
        false,
        false,
        nil,
    )
    failOnError(err, "Failed to declare an exchange")

    q, err := ch.QueueDeclare(
        "",     //name
        false,
        false,
        true,
        false,
        nil,
    )
    failOnError(err, "Failed to declare a queue")

    if len(os.Args) < 2 {
        log.Printf("Usage: %s [info] [warning] [error]", os.Args[0])
        os.Exit(0)
    }

    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, 
            s,
            "logs_topic",
            false,
            nil)
        failOnError(err, "Failed to bind a queue")
    }

    msgs, err := ch.Consume(
        q.Name,
        "",
        true,
        false,
        false, 
        false,
        nil,
    )
    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
}

Github地址

运行:

接收所有消息:

go run receive_logs_topic.go "#"

接收来自"kern"设备的消息:

go run receive_logs_topic.go "kern.*"

接收所有以"critical"结尾的消息:

go run receive_logs_topic.go "*.critical"

创建多重绑定:

go run receive_logs_topic.go "kern.*" "*.critical"

发送消息:

go run emit_log_topic.go "kern.critical" "A critical kernal error"

上述假设都是基于两个单词的,你也可以试一下设置其他长度单词的routing key看看会发生什么。

下一篇文章将会介绍如何使用RPC(Remote Procedure call)来消费消息。

最后,是Go语言实现RabbitMQ入门系列的目录,有兴趣的可以参考一下:

原文地址提供了其他语言的实现版本,可参考RabbtMQ GetStarted.

标签: RabbitMQ, Go, 消息队列, AMQP

添加新评论