RabbitMq入门（与springboot简单使用）
RabbitMq入门（与springboot简单使用）
- 一、简介及AMQP协议
-
- 概述
- 优点
- AMQP
- 二、安装
-
- Docker安装
- 遇到的问题
-
- Management API returned status code 500
- 三、核心概念
-
- 整体架构
- 消息如何流转
- Exchange Type
-
- 概述
- direct
- topic
- fanout
- Header
- 四、简单使用
-
- 依赖文件
- 生产者
-
- yml配置
- 代码编写
- RabbitMQ相关配置
-
- 访问rabbitmq的控制台
- 创建Virtual Host
- 创建exchange
- 创建queues
- exchange 与queue的bind
- 测试
- 消费者
-
- yml配置
- 编写代码
一、简介及AMQP协议
概述
RabbitMQ是一个开源的消息代理和队列服务器，用来通过普通协议在完成不同的应用之间共享数据，RabbitMQ是使用Erlang语言来编写的，并且RabbitMQ是基于AMQP协议的。
优点
- 开源、性能优秀，稳定性保障
- 与SpringAMQP完美的整合、API丰富。
- 集群模式丰富、表达式配置、HA模式、镜像队列模型
- 保证数据不丢失的前提做到高可靠性、可用性
AMQP
AMQP全称：Advanced Message Queuing Protocol
AMQP翻译：高级消息队列协议
二、安装
Docker安装
docker 拉取rabbitmq（默认最新）镜像
docker pull rabbitmq
docker运行rabbitmq
docker run -d --name rabbitmq -p 5672:5672 -p 15672:15672 -v /mydata/rabbitmq/data:/var/lib/rabbitmq --hostname myRabbit -e RABBITMQ_DEFAULT_VHOST=my_vhost -e RABBITMQ_DEFAULT_USER=admin -e RABBITMQ_DEFAULT_PASS=admin 586ccc4c0d63（镜像编号）
开启web控制台
# 进入rabbitmq容器
[vagrant@bogon etc]$ sudo docker exec -it rabbitmq /bin/bash
# 进入rabbitmq容器，开启web控制台
root@myRabbit:/# rabbitmq-plugins enable rabbitmq_management
遇到的问题
Management API returned status code 500
进入rabbitmq容器，执行如下命令。
cd /etc/rabbitmq/conf.d/
echo management_agent.disable_metrics_collector = false > management_agent.disable_metrics_collector.conf
exit
三、核心概念
整体架构
- Server：又称为Broker，接受客户端的连接，实现AMQP实体服务
- Connection：连接，应用程序与Broker的网络连接
- Channel：网络信道，几乎所有的操作都在Channel中进行，Channel是进行消息读写的通道。客户端可建立多个channel，每个Channel代表一个会话任务。
- Message：消息。服务器和应用程序之间传送的数据，由Properties和Body组成。Properties可以对消息进行修饰，比如消息的优先级，延迟等高级特性；Body则是消息体内容。
- Virtual host：虚拟地址，用于进行逻辑隔离，最上层的消息路由。一个Virtual Host里面可以有若干个Exchange和Queue，同一个Virtual Host里面不能有相同名称的Exchange或queue
- Exchange：交换机，接收消息，根据路由键转发消息到绑定的队列。
- Binding: Exchange 和Queue之间的虚拟连接，binding中可含有routing key。
- Routing key: 一个路由规则，虚拟机可用它来确定如何路由一个特定消息。
- Queue: 也称为Message Queue，消息队列，保持消息并将他们转发给消费者。
消息如何流转
- 生成者指定发送的Exchange和routing key，并发送信息到Exchange
- Exchange根据routing key ，把消息放到对应的Message Queue
- 消费者根据监听的Message Queue，来进行消费。
Exchange Type
概述
在rabbitMq中，Exchange有四个类型：direct，topic，fanout，header，详见
direct
direct类型的exchange，只有当routing key完全相等时，才能路由到对应的Queue
topic
topic类型的direct差不多，只是topic可以设置“*”和“#”通配符。
fanout
俗称广播，此路由直接将消息路由到所有绑定队列中，无须对消息的routingkey进行匹配。
Header
Headr类型的exchange是根据header来判断，用的比较少
四、简单使用
此节简单介绍一下，springboot如何使用rabbitmq，在此之前，我们需要两个springboot工程（生产者和消费者），他们的包名结构一定要相同，因为这涉及到消费者接收消息时，如果两个工程的消息类结构和包名不一样会接收不到。来看一下我的包结构，依次是生产者，消费者
依赖文件
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0modelVersion>
<parent>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-parentartifactId>
<version>2.6.1version>
<relativePath/>
parent>
<groupId>com.study.rabbitmqgroupId>
<artifactId>RApusic-consumerartifactId>
<version>0.0.1-SNAPSHOTversion>
<name>RApusic-consumername>
<description>study for Spring Bootdescription>
<properties>
<java.version>1.8java.version>
properties>
<dependencies>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-amqpartifactId>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-webartifactId>
dependency>
<dependency>
<groupId>org.projectlombokgroupId>
<artifactId>lombokartifactId>
<optional>trueoptional>
dependency>
<dependency>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-starter-testartifactId>
<scope>testscope>
dependency>
<dependency>
<groupId>org.springframework.amqpgroupId>
<artifactId>spring-rabbit-testartifactId>
<scope>testscope>
dependency>
<dependency>
<groupId>org.apache.commonsgroupId>
<artifactId>commons-lang3artifactId>
dependency>
<dependency>
<groupId>commons-iogroupId>
<artifactId>commons-ioartifactId>
<version>2.6version>
dependency>
<dependency>
<groupId>com.alibabagroupId>
<artifactId>fastjsonartifactId>
<version>1.2.78version>
dependency>
<dependency>
<groupId>javax.servletgroupId>
<artifactId>javax.servlet-apiartifactId>
<scope>providedscope>
dependency>
<dependency>
<groupId>log4jgroupId>
<artifactId>log4jartifactId>
<version>1.2.17version>
dependency>
dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.bootgroupId>
<artifactId>spring-boot-maven-pluginartifactId>
<configuration>
<excludes>
<exclude>
<groupId>org.projectlombokgroupId>
<artifactId>lombokartifactId>
exclude>
excludes>
configuration>
plugin>
plugins>
build>
project>
生产者
yml配置
spring:
http:
encoding:
charset: UTF-8
datasource:
url: jdbc:mysql://localhost:3306/ml?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true&serverTimezone=GMT%2B8
username: root
password: root
jackson:
date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8
default-property-inclusion: NON_NULL
rabbitmq:
addresses: 192.168.137.20:5672 #rabbitmq地址
username: admin
password: admin
virtual-host: / #虚拟主机，一般最新版好像没有这个虚拟主机，需要你去rabbitmq的web控制台创建一下。
connection-timeout: 15000
server:
servlet:
context-path: /
port: 8001
代码编写
写完配置文件后，就该开始编写代码了，首先编写实体类 Order。
package com.study.rabbitmq.entity;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Order implements Serializable {
private static final long serialVersionUID = -837945093037776296L;
private String id;
private String name;
private String messageId;//存储消息发送的唯一标识。
}
生产者发送消息的代码。由于springboot的关系，所以写的代码非常少
package com.study.rabbitmq.producer;
import com.study.rabbitmq.entity.Order;
import org.springframework.amqp.rabbit.connection.CorrelationData;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
@Component
public class OrderSender {
@Autowired
private RabbitTemplate rabbitTemplate;
public void send(Order order){
CorrelationData correlationData = new CorrelationData();
correlationData.setId(order.getMessageId());
rabbitTemplate.convertAndSend("order-exchange",//exchange
"order.dada.123",//routingKey
order,//消息体内容
correlationData);//correlationData消息唯一ID
}
}
到此生产者代码编写完毕，是不是很简单。但是完成这些代码后我们发的消息，还不能被rabbitmq接收，因为exchange和queue还没有在rabbit中创建。所以下一节的内容，聪明的你应该猜到了。
RabbitMQ相关配置
访问rabbitmq的控制台
输入用户密码登录控制台。
创建Virtual Host
- 选项卡切换到admin，右侧选中Virtual Host，键入Name。点击添加完成操作。
创建exchange
- 选择exchange的选项卡。
- 图中红框区域键入exchange的name：order-exchange。type选为topic
- 点击add exchange按钮，完成exchange的创建。
创建queues
-
点击exchange选项卡，点击add a new queue
-
点开后，键入name（order-queue），点击Add queue
exchange 与queue的bind
-
点exchange选项卡，点击创建好的order-exchange
-
键入图中内容，点击bind按钮，完成绑定。
测试
到此rabbitmq的exchange和queue设置完毕。我们可以测试一下，是否可以使用（ps：如果控制台点击遇到Management API returned status code 500的错误，请看安装那节遇到问题篇）。
在生产者中编写测试用例并启动。
package com.study.rabbitmq.RApusic;
import com.study.rabbitmq.entity.Order;
import com.study.rabbitmq.producer.OrderSender;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.util.UUID;
@SpringBootTest
class RApusicApplicationTests {
@Test
void contextLoads() {
System.out.printf("111");
}
@Autowired
private OrderSender orderSender;
@Test
public void testSend(){
Order order = new Order();
order.setId("2021120900000001");
order.setName("测试订单1");
order.setMessageId(System.currentTimeMillis()+"$"+ UUID.randomUUID().toString());
orderSender.send(order);
}
}
查看web控制台，可见消息已经发送到了rabbitmq中。
消费者
生产者生产的消息，需要消费者消费。
yml配置
spring:
http:
encoding:
charset: UTF-8
datasource:
url: jdbc:mysql://localhost:3306/ml?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true&serverTimezone=GMT%2B8
username: root
password: root
jackson:
date-format: yyyy-MM-dd HH:mm:ss
time-zone: GMT+8
default-property-inclusion: NON_NULL
rabbitmq:
#基本配置
addresses: 192.168.137.20:5672
username: admin
password: admin
virtual-host: /
connection-timeout: 15000
#消费端配置
listener:
simple:
concurrency: 5 #并发数
max-concurrency: 15 #最大并发数
acknowledge-mode: manual #签收模式 manual（手动）or AUTO（自动）
prefetch: 1 #限流
server:
servlet:
context-path: /
port: 8002
编写代码
消费者也需要entity来接收发送来的消息。
package com.study.rabbitmq.entity;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Order implements Serializable {
private static final long serialVersionUID = -837945093037776296L;
private String id;
private String name;
private String messageId;//存储消息发送的唯一标识。
}
编写监听
package com.study.rabbitmq.consumer;
import com.rabbitmq.client.Channel;
import com.study.rabbitmq.entity.Order;
import org.springframework.amqp.rabbit.annotation.*;
import org.springframework.amqp.support.AmqpHeaders;
import org.springframework.messaging.handler.annotation.Headers;
import org.springframework.messaging.handler.annotation.Payload;
import org.springframework.stereotype.Component;
import java.io.IOException;
import java.util.Map;
@Component
public class OrderReceiver {
@RabbitListener(bindings = @QueueBinding(value = @Queue(value = "order-queue",declare = "true"),
exchange = @Exchange(name = "order-exchange",durable = "true",type ="topic" ),
key = "order.#"
))
@RabbitHandler
public void onOrderMessage(@Payload Order order, @Headers Map<String,Object> headers, Channel channel) throws IOException {
//消息者操作
System.out.println("-----收到消息------");
System.out.println("订单ID"+order.getId());
//获取heads中的DELIVERY_TAG
Long deliveryTag =(Long) headers.get(AmqpHeaders.DELIVERY_TAG);
//手工签收,basicAck（DELIVERY_TAG，是否支持批量）；
channel.basicAck(deliveryTag,false);
}
}
启动springboot，
至此springboot整合rabbitmq完毕。如果您发现文章中有错误，请及时告诉我，万分感谢。