消息队列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 | /** | 
在消息消费者类内,有两个陌生的注解:
- @RabbitListenerRabbitMQ队列消息监听注解,该注解配置监听queues内的队列名称列表,可以配置多个。队列名称对应本章rabbitmq-common模块内QueueEnum枚举name属性。
- @RabbitHandlerRabbitMQ消息处理方法,该方法的参数要与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类型消息消费
 
 



 OAuth vs SAML vs OpenID
 OAuth vs SAML vs OpenID
