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);
			}
		});
	}
	
}
（3）写2个消费者
    消费者类需要实现MessageListener接口，然后重写onMessage方法，且消费者需要交给Spring容器来实例化。
        消费者A的代码如下：
package com.zxy.mq.consumer;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.TextMessage;
import org.springframework.stereotype.Component;

@Component
public class TestAConsumer implements MessageListener {

	@Override
	public void onMessage(Message message) {
		// myQueueA的消费者
		try {
			 String text = ((TextMessage) message).getText();
			 System.out.println(this.getClass().getSimpleName() + "接受到消息---->" + text);
		} catch (JMSException e) {
			e.printStackTrace();
		}
	}

}
        消费者B的代码如下：
package com.zxy.mq.consumer;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.TextMessage;
import org.springframework.stereotype.Component;

@Component
public class TestBConsumer implements MessageListener {

	@Override
	public void onMessage(Message message) {
		// myQueueB的消费者
		try {
			 String text = ((TextMessage) message).getText();
			 System.out.println(this.getClass().getSimpleName() + "接受到消息---->" + text);
		} catch (JMSException e) {
			e.printStackTrace();
		}
	}

}
（4）queue监听器中配置Listener并指向消费者
        由于消费者需要监听queue消息，因此需要在applicationContext.xml的Queue监听器里面添加Listener并ref对应消费者。
配置消费者A监听的queue的名字为myQueueA，消费者B监听的queue的名字为myQueueB。
        具体的配置见下图

三、测试

    利用通用生产者来发送mq消息，然后消费者收到消息后会打印到控制台。
（1）测试代码
    发送10个mq消息，myQueueA队列5个，myQueueB队列5个
    测试代码如下：
package com.zxy.mq.test;
import org.springframework.context.ApplicationContext;
import org.springframework.context.support.ClassPathXmlApplicationContext;
import com.zxy.mq.producer.CommonMqQueueProducer;

/**
 * MQ消息测试类
 * @author ZENG.XIAO.YAN
 * @time   2018-11-15 14:04:35
 * @version  v1.0
 */
public class MqTestDemo {
	private static ApplicationContext applicationContext;
	// 静态代码块加载Spring容器
	static {
		applicationContext = new ClassPathXmlApplicationContext("classpath:applicationContext.xml");
		System.out.println("spring 容器已启动。。。");
	}
	
	public static void main(String[] args) {
		CommonMqQueueProducer mqQueueProducer = applicationContext.getBean(CommonMqQueueProducer.class);
		for (int i = 1; i < 11; i++) {
			// 奇数给myQueueA发，偶数给myQueueB发
			if (i % 2 == 1) {
				mqQueueProducer.send("myQueueA", "Mq消息A" + i);
			} else {
				mqQueueProducer.send("myQueueB", "Mq消息B" + i);
			}
		}
	}

}
（2）测试结果
    通过控制台可以发现，对应queue的消费者接受到了消息，说明Spring整合ActiveMQ整合成功了。
    控制台输出结果见下图 
                

四、小结

    （1）由于使用ActiveMQ官方原生的代码来发送MQ消息的代码比较复杂，因此采用JmsTemplate来发送MQ消息
    （2）由于JmsTemplate发送MQ消息时每次都要创建Connection和Session。因此引入Spring提供的CachingConnectionFactory，起到类似于数据库连接池的效果
    （3）注册JmsTemplate时，pubSubDomain这个属性的值要特别注意。默认值是false，也就是说默认只是支持queue模式，不支持topic模式。但是，如果将它改为true，则不支持queue模式。因此如果项目需要同时支持queue和topic模式，那么需要注册2个JmsTemplate，同时监听容器（<jms:listener-container>）也需要注册2个
posted @ 2018-11-15 14:41  zeng1994  阅读(10183)  评论(0)  编辑  收藏  举报