RabbitMQ快速入门及Spring Boot Maven项目快速应用

入门级教程

简介：

• 大多应用中，可通过消息服务中间件来提升系统异步通信、扩展解耦能力
  

• 消息服务中两个重要概念：消息代理（message broker）和目的地（destination)
  当消息发送者发送消息以后，将由消息代理接管，消息代理保证消息传递到指定目的地。

• 消息队列主要有两种形式的目的地
  队列（queue）：点对点消息通信（point-to-point）
  主题（topic）：发布（publish）/订阅（subscribe）消息通信

• 点对点式：
  消息发送者发送消息，消息代理将其放入一个队列中，消息接收者从队列中获取消息内容，消息读取后被移出队列
  消息只有唯一的发送者和接受者，但并不是说只能有一个接收者

• 发布订阅式：
  发送者（发布者）发送消息到主题，多个接收者（订阅者）监听（订阅）这个主题，那么就会在消息到达时同时收到消息

• JMS（Java Message Service）JAVA消息服务：
  基于JVM消息代理的规范。ActiveMQ、HornetMQ是JMS实现

• AMQP（Advanced Message Queuing Protocol）
  高级消息队列协议，也是一个消息代理的规范，兼容JMS; RabbitMQ是AMQP的实现

核心概念

• Message 消息，消息是不具名的，它由消息头和消息体组成。消息体是不透明的，而消息头则由一系列的可选属性组成，这些属性包括routing-key（路由键）、priority（相对于其他消息的优先权）、delivery-mode（指出该消息可能需要持久性存储）等。

• Publisher 消息的生产者，也是一个向交换器发布消息的客户端应用程序。

• Exchange 交换器，用来接收生产者发送的消息并将这些消息路由给服务器中的队列。
  Exchange有4种类型：direct(默认)，fanout, topic, 和headers，不同类型的Exchange转发消息的策略有所区别

• Queue 消息队列，用来保存消息直到发送给消费者。它是消息的容器，也是消息的终点。一个消息可投入一个或多个队列。消息一直在队列里面，等待消费者连接到这个队列将其取走。

• Binding 绑定，用于消息队列和交换器之间的关联。一个绑定就是基于路由键将交换器和消息队列连接起来的路由规则，所以可以将交换器理解成一个由绑定构成的路由表。Exchange 和Queue的绑定可以是多对多的关系。

• Connection 网络连接，比如一个TCP连接。

• Channel 信道，多路复用连接中的一条独立的双向数据流通道。信道是建立在真实的TCP连接内的虚拟连接，AMQP 命令都是通过信道发出去的，不管是发布消息、订阅队列还是接收消息，这些动作都是通过信道完成。因为对于操作系统来说建立和销毁 TCP 都是非常昂贵的开销，所以引入了信道的概念，以复用一条 TCP 连接。

• Consumer 消息的消费者，表示一个从消息队列中取得消息的客户端应用程序。

• Virtual Host 虚拟主机，表示一批交换器、消息队列和相关对象。虚拟主机是共享相同的身份认证和加密环境的独立服务器域。每个 vhost 本质上就是一个 mini 版的 RabbitMQ 服务器，拥有自己的队列、交换器、绑定和权限机制。vhost 是 AMQP 概念的基础，必须在连接时指定，RabbitMQ 默认的 vhost 是 / 。

• Broker 表示消息队列服务器实体
  

Exchange 类型

Exchange分发消息时根据类型的不同分发策略有区别，目前共四种类型：direct、fanout、topic、headers
headers 匹配 AMQP 消息的 header 而不是路由键， headers 交换器和 direct 交换器完全一致，但性能差很多，目前几乎用不到了，所以直接看另外三种类型：

点对点： 消息中的路由键（routing key）如果和 Binding 中的 binding key 一致， 交换器就将消息发到对应的队列中。路由键与队列名完全匹配，如果一个队列绑定到交换机要求路由键为“dog”，则只转发 routing key 标记为“dog”的消息，它是完全匹配、单播的模式

**广播：**每个发到 fanout 类型交换器的消息都会分到所有绑定的队列上去。fanout 交换器不处理路由键，只是简单的将队列绑定到交换器上，每个发送到交换器的消息都会被转发到与该交换器绑定的所有队列上。很像子网广播，每台子网内的主机都获得了一份复制的消息。fanout 类型转发消息是最快的。

主题： topic交换器通过模式匹配消息的路由键属性，将路由键和某个模式进行匹配，此时队列需要绑定到一个模式上。它将路由键和绑定键的字符串切分成单词，这些单词之间用点隔开。它同样也会识别两个通配符：符号#和符号*。# 匹配0个或多个单词，* 匹配一个单词

Spring Boot + Maven项目整合RabbitMQ

版本： Spring Boot 2.0.2.RELEASE RabbitMQ 3.7

docker 快速搭建RabbitMQ服务

dockerhub地址：https://hub.docker.com/_/rabbitmq?tab=description

• 拉取官方镜像　
  docker pull rabbitmq:3.7
  docker-file相关信息：

# ENV RABBITMQ_HOME=/opt/rabbitmq
# ENV RABBITMQ_DATA_DIR=/var/lib/rabbitmq # 容器卷对应目录
# VOLUME $RABBITMQ_DATA_DIR # 容器卷对应目录
# EXPOSE 4369 5671 5672 25672 # 暴露端口 其中5672 为客户端连接默认端口
# https://github.com/rabbitmq/rabbitmq-server/releases/download/v$RABBITMQ_VERSION/rabbitmq-server-generic-unix-latest-toolchain-3.7.23.tar.xz;  ## 快速下载地址

dockerfile地址

• 拉取包含控制台的镜像　
  docker pull rabbitmq:3.7-management 跟上一点二选一即可
  docker-file相关信息：

# from rabbitmq:3.7　
# EXPOSE 15671 15672

dockerfile地址

• 15672：控制台端口号；5672：应用访问端口号

• 启动镜像
  默认用户密码：guest/guest
  修改默认密码： -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin

# 创建容器卷
mkdir -p /home/rabbitmq
# 启动容器
docker run -d -v /home/rabbitmq:/var/lib/rabbitmq --network host \
-e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin --name rabbitmq-01 rabbitmq:3.7-management
# 查看端口是否有应用监听
netstat -napl | grep 5672
netstat -napl | grep 15672
# 查看容器日志
docker logs rabbitmq-01 # --name设置的容器名称

• 登录控制台
  http://192.168.201.91:15672/#/ 账号密码：admin/admin # 已经重置过默认密码
  

maven项目中引入 spring-boot-starter-amqp

<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-amqp</artifactId>
	<version>2.0.2.RELEASE</version>
</dependency>
<-- 2.0.2.RELEASE默认的 spring-rabbit组件 amqp-client组件 版本 -->
<properties>
	<rabbit-amqp-client.version>5.1.2</rabbit-amqp-client.version>
	<spring-amqp.version>2.0.3.RELEASE</spring-amqp.version>
</properties> 

spring-rabbit组件 依赖 amqp-client组件，并且，之间的版本号，也要匹配好，不然，运行时就会出错

• application.yml配置

spring: 
  rabbitmq: 
    host: 192.168.201.91
    port: 5672
    username: admin
    password: admin

• 在java中的应用; Direct Exchange 点对点通信举例

public class Test {

	// 管理组件
	@Autowired
	AmqpAdmin amqpAdmin;

	// 消息发送处理组件
	@Autowired
	RabbitTemplate rabbitTemplate;

	private final static String exchangeName = "yx.direct.exchange";
	private final static String routingKey = "yx.operation-log";
	private final static String destination = "yx.operation-log.queue"; // 也是queueName

	@Test
	public void createExchange() {
		// 定义Direct Exchange
		amqpAdmin.declareExchange(new DirectExchange(exchangeName));

		// 定义队列
		// durable true if we are declaring a durable queue (the queue will survive a server restart)
		amqpAdmin.declareQueue(new Queue(destination, true));

		// 创建绑定规则
		amqpAdmin.declareBinding(new Binding(destination, DestinationType.QUEUE, exchangeName, routingKey, null));
	}

	// 单播（点对点）
	@Test
	public void sendMsg() {
		// 对象被默认序列化以后发送出去
		rabbitTemplate.convertAndSend(exchangeName, routingKey, new EmpEntity("1", "张三"));
	}

	// 接受数据,如何将数据自动的转为json发送出去
	@Test
	public void receiveMsg() {
		Object o = rabbitTemplate.receiveAndConvert(destination);
		System.err.println(o.getClass());
		System.err.println(o);
	}
}

基于注解的简单应用：

@Service
public class TestService {

	// 一定要确定RabbitMQ的服务中已经创建了对应的queue，负责会启动报错
	@RabbitListener(queues = "yx.operation-log.queue")
	public void receive(EmpEntity entity) {
		System.out.println("收到消息：" + entity.toString());
	}

	// 一定要确定RabbitMQ的服务中已经创建了对应的queue，负责会启动报错
	@RabbitListener(queues = "yx.operation-log.queue")
	public void receive02(Message message) {
		System.out.println(message.getBody());
		System.out.println(message.getMessageProperties());
	}
}

参考文档

…