Spring整合ActiveMQ及多个Queue消息监听的配置

Posted zeng1994

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了Spring整合ActiveMQ及多个Queue消息监听的配置相关的知识，希望对你有一定的参考价值。

    消息队列（MQ）越来越火，在java开发的项目也属于比较常见的技术，MQ的相关使用也成java开发人员必备的技能。笔者公司采用的MQ是ActiveMQ，且消息都是用的点对点的模式。本文记录了实现Spring整合ActivateMQ的全过程及如何使用MQ，便于后续查阅。

一、项目的搭建

    采用maven构建项目，免去了copy jar包的麻烦。因此，我们创建了一个java类型的Maven Project
（1）项目结构图
    先把项目结构图看一下，便于对项目的理解。
        
（2）pom.xml 
    我们需要加入以下的依赖：
      • spring-jms
      • activemq-all
    具体见下面代码
<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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.zxy</groupId>
  <artifactId>spring-activemq</artifactId>
  <version>1.0-SNAPSHOT</version>
  <name>spring-activemq</name>
  
	<dependencies>
		<!-- spring-jms 依赖 -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jms</artifactId>
			<version>4.3.10.RELEASE</version>
		</dependency>
		
		<!-- activemq依赖 -->
		<dependency>
			<groupId>org.apache.activemq</groupId>
			<artifactId>activemq-all</artifactId>
			<version>5.9.1</version>
		</dependency>
	</dependencies>
  
</project>

二、整合+写代码

    先说明下，公司只用了ActiveMQ的点对点消息模式（queue），并没有用发布订阅模式（topic）。所以下文的整合也是按queue类型消息来配置的。
（1）配置applicationContext.xml
    Spring整合ActiveMQ步骤如下：
      • 注册ActiveMQ连接工厂—— 配置与ActiveMQ相关的一些基本配置
      • 注册Spring Cache连接工厂—— 类似于数据库连接池一样的东西，用于提高效率。后续Connection和Session都是通过它来获取，不直接和ActiveMQ发生关系
      • 注册JmsTemplate —— 主要用来发送MQ消息
      • 注册Queue监听 —— 主要用来配置MQ消息的消费者
     说明：因为JmsTemplate每次发送消息都需要创建Connection和Session，效率低。所以使用Spring的CachingConnectionFactory连接工厂来管理Connection和Session，原理类似于数据库连接池
    具体配置代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns:context="http://www.springframework.org/schema/context"
	xmlns:jms="http://www.springframework.org/schema/jms"
	xmlns:c="http://www.springframework.org/schema/c"
	xsi:schemaLocation="http://www.springframework.org/schema/jms http://www.springframework.org/schema/jms/spring-jms-4.3.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">

	<!-- 开启包扫描 （减少在xml中注册bean）-->
	<context:component-scan base-package="com.zxy.mq" />

	<!-- #### ActiveMq配置 start ####-->
	<!-- 1. ActiveMq连接工厂 -->
	<bean id="activeMQConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
		<property name="brokerURL" value="tcp://localhost:61616" />
	</bean>
	
	 <!--2. Spring Caching 连接工厂(类似数据库线程池的东西，减少连接的创建。) -->
	 <!-- 由于jmsTemplate每次发送消息都需要创建连接和创建session了，所以引入这个类似连接池的连接工厂，优化Mq的性能 -->
    <bean id="connectionFactory" class="org.springframework.jms.connection.CachingConnectionFactory">
    	<!-- 目标连接工厂 指向 ActiveMq工厂 -->
        <property name="targetConnectionFactory" ref="activeMQConnectionFactory" />
        <!-- session缓存的最大个数-->
        <property name="sessionCacheSize" value="100" />
    </bean>

	<!-- 3.配置jmsTemplate，用于发送发送mq消息 -->
	<bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
		<property name="connectionFactory" ref="connectionFactory" />
		<!-- 设置 jmsTemplate 不支持订阅模式，即：只支持queue模式。
			 如果项目需要同时支持queue和topic，那么就需要另外注册一个jmsTemplate（把pubSubDomain设为true）-->
		<property name="pubSubDomain" value="false"></property>
	</bean>

	<!-- 4.定义Queue监听器 -->
	<jms:listener-container destination-type="queue" connection-factory="connectionFactory">
		<!-- TODO 每添加一个queue的监听，都需要在这里添加一个配置 -->
		<!-- 这样配置就可以方便的对多个队列监听 , 每增加一个队列只需要添加一个 jms:listener -->
		<!-- destination:队列名称, ref:指向对应的监听器对象 -->
		<!-- 示例: <jms:listener destination="queueName" ref="consumerBean" /> -->
		
	</jms:listener-container>
	<!-- #### ActiveMq配置 end ####-->
	
</beans>
（2）写一个通用的MQ消息生产者
    一般我们传输mq消息都是json字符串。因此，文本类型的消息就能满足我们常见的需求了。所以我们可以认为文本消息就是通用的MQ消息类型。
    代码如下：
package com.zxy.mq.producer;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.Session;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jms.core.JmsTemplate;
import org.springframework.jms.core.MessageCreator;
import org.springframework.stereotype.Component;

/**
 * 通用的ActiveMQ queue消息生产者
 * @author ZENG.XIAO.YAN
 * @time   2018-11-13 10:48:20
 * @version  v1.0
 */
@Component
public class CommonMqQueueProducer {
	@Autowired
	private JmsTemplate jmsTemplate;
	
	/**
	 * 发送点对点的文本类型的Mq消息
	 * @param queue 队列的名字
	 * @param message	文本消息（一般直接传输json字符串，所以可以认为文本消息是最通用的）
	 */
	public void send(String queue, String message) {
		jmsTemplate.send(queue, new MessageCreator() {
			@Override
			public Message createMessage(Session session) throws JMSException {
				return session.createTextMessage(message);
			}
		});
	}
	
}