消息队列RabbitMQ的Direct类型消息消费
消息队列目前流行的有KafKa、RabbitMQ、ActiveMQ等,它们的诞生无非不是为了解决消息的分布式消费,完成项目、服务之间的解耦动作。消息队列提供者与消费者之间完全采用异步通信方式,极力的提高了系统的响应能力,从而提高系统的网络请求吞吐量。
每一种的消息队列都有它在设计上的独一无二的优势,在实际的项目技术选型时根据项目的需求来确定。
本章目标
基于SpringBoot
项目整合RabbitMQ
消息队列,完成DirectExchange(路由键)
分布式消息消费。
Exchange
在RabbitMQ
中有三种常用的转发方式,分别是:
DirectExchange
:路由键方式转发消息。FanoutExchange
:广播方式转发消息。TopicExchange
:主题匹配方式转发消息。
我们本章先来讲解DirectExchange
路由键方式,根据设置的路由键的值进行完全匹配时转发,下面我们来看一张图,形象的介绍了转发消息匹配流程,如下图所示:
我们可以看到上图,当消息被提供者发送到RabbitMQ
后,会根据配置队列的交换以及绑定实例进行转发消息,上图只会将消息转发路由键为KEY
的队列消费者对应的实现方法逻辑中,从而完成消息的消费过程。
安装RabbitMQ
因为RabbitMQ
是跨平台的分布式消息队列服务,可以部署在任意的操作系统上,下面我们分别介绍在不同的系统下该怎么去安装RabbitMQ
服务。
我们本章采用的环境版本如下:
- RabbitMQ Server 3.6.14
- Erlang/OTP_X64 20.1
Windows下安装
我们先去RabbitMQ
官方网站下载最新版的安装包,下载地址:https://www.rabbitmq.com/download.html
,可以根据不同的操作系统选择下载。
我们在安装RabbitMQ
服务端时需要Erlang
环境的支持,所以我们需要先安装Erlang
。
我们通过
Erlang
官方网站http://www.erlang.org/downloads
下载最新的安装包我们访问
RabiitmQ
官方下载地址https://www.rabbitmq.com/download.html
下载最新安装包。
因为是国外的网站所以下载比较慢,大家下载时会浪费时间,我已经将安装包分享到了百度网盘,下载地址:安装包下载地址,密码:
pexf
运行安装
Erlang
运行安装
RabbitMQ
5.检查服务是否安装完成,RabbitMQ
安装完成后会以服务的形式创建,并且随着开机启动,如下所示:
Mac OS X 安装
在Mac OS X中我们使用brew
工具可以很简单的安装RabbitMQ
服务端,步骤如下:
brew
更新到最新版本,执行:brew update
- 接下来我们安装
Erlang
,执行:brew install erlang
- 最后安装
RabbitMQ
,执行:brew install rabbitmq
我们通过上面的步骤安装后,RabbitMQ
会被自动安装到/usr/local/Cellar/rabbitmq/
目录下,下面我们进入cd sbin
目录执行:
1 | sudo ./rabbitmq-server |
可以直接启动RabbitMQ
服务。
Ubuntu 安装
在Ubuntu
操作系统中,我们可以直接使用APT
仓库进行安装,我使用的系统版本是16.04
,系统版本并不影响安装。
- 安装
Erlang
,执行命令:sudo apt-get install erlang
- 下面我们需要将
RabbitMQ
的安装源配置信息写入到系统的/etc/apt/sources.list.d
配置文件内,执行如下命令:1
echo 'deb http://www.rabbitmq.com/debian/ testing main' | sudo tee /etc/apt/sources.list.d/rabbitmq.list
- 下面我们更新
APT
本地仓库的安装包列表,执行命令:sudo apt-get update
- 最后安装
RabbitMQ
服务,执行命令:sudo apt-get install rabbitmq-server
启用界面管理插件
RabbitMQ
提供了界面管理的web
插件,我们只需要启用指定的插件就可以了,下面我们来看看Windows
操作系统下该怎么启动界面管理插件。
我们使用CMD
进入RabbitMQ
安装目录C:\Program Files\RabbitMQ Server\rabbitmq_server-3.6.14
,然后我们进入sbin
目录,可以看到目录内存在很多个bat
脚本程序,我们找到rabbitmq-plugins.bat
,这个脚本程序可以控制RabbitMQ
插件启用禁用,我们执行如下脚本命令来启用界面管理插件:
1 | rabbitmq-plugins.bat enable rabbitmq_management |
命令行输出内容如下所示:
1 | The following plugins have been enabled: |
可以看到输出的内容RabbitMQ
自动启动了6个插件,我们现在访问http://127.0.0.1:15672地址可以直接打开RabbitMQ
的界面管理平台,而默认的用户名/密码分别为:guest/guest
,通过该用户可以直接登录管理平台。
禁用界面管理插件
我们同样可以禁用RabbitMQ
指定插件,执行如下命令:
1 | rabbitmq-plugins.bat disable rabbitmq_management |
命令创建输出内容则是相关停止插件的日志,如下:
1 | The following plugins have been disabled: |
这样我们再访问http://127.0.0.1:15672就会发现我们无法访问到界面。
构建项目
我们使用idea
开发工具创建一个SpringBoot
项目,添加依赖,pom.xml配置文件如下所示:
1 | <dependencies> |
我们本章来模拟用户注册完成后,将注册用户的编号通过Provider
模块发送到RabbitMQ
,然后RabbitMQ
根据配置的DirectExchange
的路由键进行异步转发。
初始化用户表
下面我们先来创建所需要的用户基本信息表
,建表SQL如下所示:
1 | CREATE TABLE `user_info` ( |
构建 rabbitmq-provider 项目
基于我们上述的项目创建一个Maven
子模块,命名为:rabbitmq-provider
,因为是直接创建的Module
项目,IDEA
并没有给我创建SpringApplication
启用类。
创建入口类
下面我们自行创建一个Provider
项目启动入口程序,如下所示:
1 | /** |
application.properties配置文件
下面我们在src/main/resource
目录下创建application.properties
并将对应RabbitMQ
以及Druid
的配置加入,如下所示:
1 | #用户名 |
在RabbitMQ
内有个virtual-host
即虚拟主机的概念,一个RabbitMQ
服务可以配置多个虚拟主机,每一个虚拟机主机之间是相互隔离,相互独立的,授权用户到指定的virtual-host
就可以发送消息到指定队列。
用户实体
本章数据库操作采用spring-data-jpa
,相关文章请访问:第十三章:SpringBoot实战SpringDataJPA,我们基于user_info
数据表对应创建实体,如下所示:
1 |
|
用户数据接口
创建UserRepository
用户数据操作接口,并继承JpaRepository
获得spring-data-jpa
相关的接口定义方法。如下所示:
1 | /** |
用户业务逻辑实现
本章只是简单完成了数据的添加,代码如下所示:
1 | /** |
在上面业务逻辑实现类内出现了一个名为QueueMessageService
消息队列实现类,该类是我们定义的用于发送消息到消息队列的统一入口,在下面我们会详细讲解。
用户控制器
创建一个名为UserController
的控制器类,对应编写一个添加用户的请求方法,如下所示:
1 | /** |
到这我们添加用户的流程已经编写完成了,那么我们就来看下消息队列QueueMessageService
接口的定义以及实现类的定义。
消息队列方法定义接口
创建一个名为QueueMessageService
的接口并且继承了RabbitTemplate.ConfirmCallback
接口,而RabbitTemplate.ConfirmCallback
接口是用来回调消息发送成功后的方法,当一个消息被成功写入到RabbitMQ
服务端时,就会自动的回调RabbitTemplate.ConfirmCallback
接口内的confirm
方法完成通知,QueueMessageService
接口如下所示:
1 | /** |
接下来我们需要实现该接口内的所有方法,并做出一些业务逻辑的处理。
消息队列业务实现
创建名为QueueMessageServiceSupport
实体类实现QueueMessageService
接口,并实现接口内的所有方法,如下所示:
1 | /** |
convertAndSend
方法用于将Object
类型的消息转换后发送到RabbitMQ
服务端,发送是的消息类型要与消息消费者方法参数保持一致。
在confirm
方法内,我们仅仅打印了消息发送时的id
,根据ack
参数输出消息发送状态。
在上面代码中我们注入了
RabbitTemplate
消息队列模板实例,而通过该实例我们可以将消息发送到RabbitMQ
服务端。那么这个实例具体在什么地方定义的呢?我们带着这个疑问来创建下面的模块,我们需要将RabbitMQ
相关的配置抽取出来作为一个单独的Module
存在。
构建 rabbitmq-common 项目
该模块项目很简单,只是添加RabbitMQ
相关的配置信息,由于Module
是一个子模块所以继承了parent
所有的依赖,当然我们用到的RabbitMQ
相关依赖也不例外。
配置rabbitmq
在创建配置类之前,我们先来定义两个枚举,分别存放了队列的交换信息、队列路由信息,
ExchangeEnum (存放了队列交换配置信息)
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/**
* rabbitmq交换配置枚举
* ========================
*
* @author 恒宇少年
* Created with IntelliJ IDEA.
* Date:2017/11/26
* Time:13:56
* 码云:http://git.oschina.net/jnyqy
* ========================
*/
public enum ExchangeEnum
{
/**
* 用户注册交换配置枚举
*/
USER_REGISTER("user.register.topic.exchange")
;
private String value;
ExchangeEnum(String value) {
this.value = value;
}
}QueueEnum (存放了队列信息以及队列的路由配置信息)
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/**
* 队列配置枚举
* ========================
*
* @author 恒宇少年
* Created with IntelliJ IDEA.
* Date:2017/11/26
* Time:14:05
* 码云:http://git.oschina.net/jnyqy
* ========================
*/
public enum QueueEnum
{
/**
* 用户注册枚举
*/
USER_REGISTER("user.register.queue","user.register")
;
/**
* 队列名称
*/
private String name;
/**
* 队列路由键
*/
private String routingKey;
QueueEnum(String name, String routingKey) {
this.name = name;
this.routingKey = routingKey;
}
}创建名为
UserRegisterQueueConfiguration
的实体类用于配置本章用到的用户注册队列信息,如果你得项目中使用多个队列,建议每一个业务逻辑创建一个配置类,分开维护,这样不容易出错。配置信息如下: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/**
* 用户注册消息队列配置
* ========================
* @author 恒宇少年
* Created with IntelliJ IDEA.
* Date:2017/11/26
* Time:16:58
* 码云:http://git.oschina.net/jnyqy
* ========================
*/
public class UserRegisterQueueConfiguration {
/**
* 配置路由交换对象实例
* @return
*/
public DirectExchange userRegisterDirectExchange()
{
return new DirectExchange(ExchangeEnum.USER_REGISTER.getValue());
}
/**
* 配置用户注册队列对象实例
* 并设置持久化队列
* @return
*/
public Queue userRegisterQueue()
{
return new Queue(QueueEnum.USER_REGISTER.getName(),true);
}
/**
* 将用户注册队列绑定到路由交换配置上并设置指定路由键进行转发
* @return
*/
public Binding userRegisterBinding()
{
return BindingBuilder.bind(userRegisterQueue()).to(userRegisterDirectExchange()).with(QueueEnum.USER_REGISTER.getRoutingKey());
}
}该配置类大致分为如下三部分:
配置交换实例
配置DirectExchange
实例对象,为交换设置一个名称,引用ExchangeEnum
枚举配置的交换名称,消息提供者与消息消费者的交换名称必须一致才具备的第一步的通讯基础。配置队列实例
配置Queue
实例对象,为消息队列设置一个名称,引用QueueEnum
枚举配置的队列名称,当然队列的名称同样也是提供者与消费者之间的通讯基础。绑定队列实例到交换实例
配置Binding
实例对象,消息绑定的目的就是将Queue
实例绑定到Exchange
上,并且通过设置的路由Key
进行消息转发,配置了路由Key
后,只有符合该路由配置的消息才会被转发到绑定交换上的消息队列。
我们的rabbitmq-common
模块已经编写完成。
添加 rabbitmq-provider 依赖 rabbitmq-common
下面我们回到rabbitmq-provider
模块,修改pom.xml配置文件,如下所示:
1 | <dependencies> |
可以看到我们将rabbitmq-common
模块添加到了rabbitmq-provider
模块的pom
配置文件内,完成了模块之间的相互依赖,这样我们rabbitmq-provider
就自动添加了对应的消息队列配置。
构建rabbitmq-consumer
我们再来创建一个rabbitmq-consumer
队列消息消费者模块,用于接受消费用户注册消息。
创建入口类
同样我们先来创建一个SpringApplication
入口启动类,如下所示:
1 | /** |
application.properties配置文件
配置文件的消息队列配置信息要与rabbitmq-provider
配置文件一致,如下所示:
1 | spring.application.name=rabbitmq-consumer |
我们修改了程序启动的端口号,为了我们下面进行测试的时候不出现端口占用的情况。
如果
RabbitMQ
配置信息与rabbitmq-provider
不一致,就不会收到消费消息。
用户注册消息消费者
创建名为UserConsumer
类,用于完成消息监听,并且实现消息消费,如下所示:
1 | /** |
在消息消费者类内,有两个陌生的注解:
- @RabbitListener
RabbitMQ
队列消息监听注解,该注解配置监听queues
内的队列名称列表,可以配置多个。队列名称对应本章rabbitmq-common
模块内QueueEnum
枚举name
属性。 - @RabbitHandler
RabbitMQ
消息处理方法,该方法的参数要与rabbitmq-provider
发送消息时的类型保持一致,否则无法自动调用消费方法,也就无法完成消息的消费。
#运行测试
我们接下来在rabbitmq-provider
模块src/test/java
下创建一个测试用例,访问用户注册控制器请求路径,如下所示:
1 |
|
调用测试用例时会自动将参数保存到数据库,并且将用户编号发送到RabbitMQ
服务端,而RabbitMQ
根据交换配置以及队列配置转发消息到消费者实例。
启动 rabbitmq-consumer
我们先来把rabbitmq-consumer
项目启动,控制台输出启动日志如下所示:
1 | ..... |
该部分启动日志就是我们配置的RabbitMQ
初始化信息,我们可以看到项目启动时会自动与配置的RabbitMQ
进行关联:
1 | [delegate=amqp://guest@127.0.0.1:5672/, localPort= 62107] |
运行测试用例
接下来我们执行rabbitmq-provider
项目的测试用例,来查看控制台的输出内容如下所示:
1 | ...... |
已经可以正常的将消息发送到RabbitMQ
服务端,并且接收到了回调通知,那么我们的rabbitmq-consumer
项目是不是已经执行了消息的消费呢?我们打开rabbitmq-consumer
控制台查看输出内容如下所示:
1 | 用户:2,完成了注册 |
看以看到已经可以成功的执行UserConsumer
消息监听类内的监听方法逻辑,到这里消息队列路由一对一的方式已经讲解完了。
总结
本章主要讲解了RabbitMQ
在不同操作系统下的安装方式,以及通过三个子模块形象的展示了消息的分布式处理,整体流程:rabbitmq-provider -> RabbitMQ
服务端 -> rabbitmq-consumer,消息的转发是非常快的,RabbitMQ
在收到消息后就会检索当前服务端是否存在该消息的消费者,如果存在将会马上将消息转发。
消息队列RabbitMQ的Direct类型消息消费