SpringBoot之简单整合RabbitMq

一、RabbitMq基本概念

1.1、什么是RabbitMq？

    AMQP，即Advanced Message Queuing Protocol，高级消息队列协议，是应用层协议的一个开放标准，为面向消息的中间件设计。消息中间件主要用于组件之间的解耦，消息的发送者无需知道消息使用者的存在，反之亦然。

AMQP的主要特征是面向消息、队列、路由（包括点对点和发布/订阅）、可靠性、安全。

    RabbitMQ是一个开源的AMQP实现，服务器端用Erlang语言编写，支持多种客户端，如：Python、Ruby、.NET、Java、JMS、C、PHP、ActionScript、XMPP、STOMP等，支持AJAX。用于在分布式系统中存储转发消息，在易用性、扩展性、高可用性等方面表现不俗。

下面将重点介绍RabbitMQ中的一些基础概念，了解了这些概念，是使用好RabbitMQ的基础。

1.2、RabbitMq中的基本信息是哪些？

    Message：消息，包含消息头（即附属的配置信息）和消息体（即消息的实体内容）

    Publisher：生产者，向交换机发布消息的主体

    Exchange：交换机，用来接收生产者发送的消息并将这些消息路由给服务器中的队列

    Binding：绑定，用于给Exchange和Queue建立关系，就是我们熟知的配对的红娘

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

    Connection：连接

    Channel：通道，MQ与外部打交道都是通过Channel来的，发布消息、订阅队列还是接收消息，这些动作都是通过Channel完成；简单来说就是消息通过Channel塞进队列或者流出队列

    Consumer：消费者，从消息队列中获取消息的主体

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

    Broker：消息队列服务器实体

1.3、什么是ACK？

    消息队列的一个重要指标，当有消费者获取了消息之后，对这个消息我应该怎么办？是直接删除还是等某个合适的机会再删除？又或者是干脆不删除，就留着了？

    在实际的应用场景中，消息正常消费之后，我们希望的是这个消息就不要了，但是消费的过程中如果出现了bug，则希望不要删除消息，等我修复这个bug后，可以把这个消息重新的投递给我

1.4、RabbitTemplate和AmqpTemplate的介绍

    Spring AMQP提供了一个发送和接收消息的操作模板类AmqpTemplate。 AmqpTemplate它定义包含了发送和接收消息等的一些基本的操作功能。RabbitTemplate是AmqpTemplate的一个实现。

    RabbitTemplate支持消息的确认与返回，为了返回消息，RabbitTemplate 需要设置mandatory 属性为true,并且CachingConnectionFactory 的publisherReturns属性也需要设置为true。返回的消息会根据它注册的RabbitTemplate.ReturnCallback setReturnCallback 回调发送到给客户端，

    一个RabbitTemplate仅能支持一个ReturnCallback 。

    为了确认Confirms消息, CachingConnectionFactory 的publisherConfirms 属性也需要设置为true，确认的消息会根据它注册的RabbitTemplate.ConfirmCallback setConfirmCallback回调发送到给客户端。一个RabbitTemplate也仅能支持一个ConfirmCallback.

二、RabbitMq和SpringBoot简单整合

    由于项目是采用SpringCloud架构的，RabbitMq消费者和提供者是可以完全解耦的所以，这里分为了一个邮箱系统（队列消费者）和用户系统(发送邮箱队列提供者)，测试用户注册邮件之后发送激活短信到用户的邮箱中。消费者是再邮箱系统中在2.6中说明出来了，发送邮箱队列提供者是在用户系统中。

    发送邮箱的操作可以看看我前面这篇文章 https://blog.csdn.net/qq_37892957/article/details/89226146

2.1、导入RabbitMq依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-amqp</artifactId>
</dependency>

2.2、配置RabbitMq属性在application.yml配置文件中

spring:
    rabbitmq:
      host: 你的RabbitMq配置地址
      port: 5672
      username: 用户名默认（guest）
      password: 密码默认（guest）

2.3、配置RabbitMqConfig的发送队列

package com.bean.springclouduser.config;

import org.springframework.amqp.core.Queue;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;


/**
* @Description //TODO
* @Author huangwb
**/
@Configuration
public class RabbitConfig {
    //直接发送邮箱消费队列
    @Bean
    public Queue queue() {
        return new Queue("sendEmail");
    }
}

2.4、配置发送方信息

package com.bean.springclouduser.service;

import org.springframework.amqp.core.AmqpTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;


/**
* @Description //TODO
* @Date 2019-04-13 21:46
* @Author huangwb
**/
@Component
public class SendEmailMq {
    @Autowired
    private AmqpTemplate amqpTemplate;

    public void sendEmail(Long userId) {
        amqpTemplate.convertAndSend("sendEmail", userId);
    }
}

2.5、配置请求控制器 方便来测试调用接口后的操作

package com.bean.springclouduser.controller;

import com.bean.springcloudcommon.model.UserInfo;
import com.bean.springcloudcommon.util.Result;
import com.bean.springclouduser.service.SendEmailMq;
import com.bean.springclouduser.service.UserInfoService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;


/**
* @Description //TODO
* @Author huangwb
**/
@RestController
@RequestMapping("/api/users")
public class UserController {
    /**
     * 用户注册成功发送激活邮箱操作的测试类
     * @return
     */
    @GetMapping("test")
    public String sendEmailMq() {
        sendEmailMq.sendEmail(1L);
        return "发送邮件成功";
    }
}

2.6、由于我的项目是SpringCloud的多项目结构 所以我在邮箱短信系统中配置了RabbitMq的消费者 在另外一个系统中你同样需要按照2.1 2.2的操作部署你的RabbitMq服务器信息

/**
* @Description //发送邮箱队列消费者
* @Author huangwb
**/
@Component
public class EmailReceiver {
    @Autowired
    private EmailService emailService;

    @RabbitHandler
    @RabbitListener(queues = "sendEmail")
    public void getEmailProcess(Long userId) {
        emailService.sendEmail(userId);
    }
}

三、结尾

    文章概念篇参考于 https://blog.csdn.net/liuyueyi25/article/details/80489596