Apache-ActiveMQ整合Spring

1.1关于activemq

在J2EE规范中,JMS有一席之地,但JMS只是一种规范一种概念,落地地实施JMS有很多产品,其中apache-activemq是一种比较常用的产品.ActiveMQ 是Apache出品，最流行的，能力强劲的开源消息总线。ActiveMQ 是一个完全支持JMS1.1和J2EE 1.4规范的 JMS Provider实现，尽管JMS规范出台已经是很久的事情了，但是JMS在当今的J2EE应用中间仍然扮演着特殊的地位。

2 准备工作

2.1 下载并安装activemq

下载apache-activemq:http://activemq.apache.org/download.html

这里下载linux版本:apache-activemq-5.7.0-bin.tar.gz




把apache-activemq-5.7.0-bin.tar.gz解压到一个目录中,会有一个apache-activemq-5.7.0的文件夹,进入该文件夹的bin目录,将看到activemq的脚本文件,执行该文件: ./activemq

若无法执行,可能是权限不够,需要修改权限: chmod 755 activemq

执行该文件后在终端如果看到下面信息,者启动成功



此时activemq线程已经运行,这时候不要关闭终端,否则activemq也会终止,如果想在后台运行activemq,执行一下命令:

nohup ./activemq start

3 实施项目

3.1 创建项目

新建maven项目,并声明项目依赖:

<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>ActivityMQ_Spring</groupId>
<artifactId>ActivityMQ_Spring</artifactId>
<version>0.0.1-SNAPSHOT</version>
<packaging>war</packaging>
<name>ActivityMQ_Spring</name>
<description/>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>

<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.10</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>4.1.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jms</artifactId>
<version>4.1.6.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>4.1.6.RELEASE</version>
</dependency>
<dependency>
<groupId>javax.annotation</groupId>
<artifactId>jsr250-api</artifactId>
<version>1.0</version>
</dependency>
<dependency>
<groupId>org.apache.activemq</groupId>
<artifactId>activemq-core</artifactId>
<version>5.7.0</version>
</dependency>

</dependencies>
<build>
<plugins>
<plugin>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.3.2</version>
<configuration>
<source>1.7</source>
<target>1.7</target>
</configuration>
</plugin>
<plugin>
<artifactId>maven-war-plugin</artifactId>
<version>2.2</version>
<configuration>
<version>3.0</version>
<failOnMissingWebXml>false</failOnMissingWebXml>
</configuration>
</plugin>
</plugins>
</build>
</project>

配置Spring框架:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0">
<display-name>ActivityMQ_Spring</display-name>

<!-- Spring监听器 -->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- 框架配置文件位置 -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath*:applicationContext-*.xml</param-value>
</context-param>
</web-app>

3.2 创建消息发送者:

package com.lin.activity.intf;

public interface ProductService {

public void sendMessage(javax.jms.Destination destination, final String message);

}

package com.lin.activity.service;

import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.Session;

import org.springframework.jms.core.JmsTemplate;
import org.springframework.jms.core.MessageCreator;

import com.lin.activity.intf.ProductService;

/**
* 消息发送组件是一个POJO,通过借助Spring的JmsTemplate封装发送目的destination和消息发送消息
* @author lin
*
*/
public class ProductServiceImpl implements ProductService {

private JmsTemplate jmsTemplate;

public void setJmsTemplate(JmsTemplate jmsTemplate) {
this.jmsTemplate = jmsTemplate;
}

@Override
public void sendMessage(javax.jms.Destination destination,final String message) {

/**
* 发送消息,这里使用一个内部类实现,内部类引用的外层类的属性值需要被定义为final
*/
jmsTemplate.send(destination, new MessageCreator() {

@Override
public Message createMessage(Session session) throws JMSException {

return session.createTextMessage(message);
}
});
}
}

3.3 创建消息接受者:

package com.lin.activity.service;

import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.TextMessage;

/**
* 定义处理消息的MessageListener
* 要定义处理消息的MessageListener我们只需要实现JMS规范中的MessageListener接口就可以了。
* MessageListener接口中只有一个方法onMessage方法，当接收到消息的时候会自动调用该方法。
* @author lin
*
*/
public class CostumerListener implements MessageListener {

/**
* 该方法监听发送方是否发送消息,若发送者处理消息
*/
@Override
public void onMessage(Message message) {

TextMessage textMsg = (TextMessage) message;
System.out.println("接受者接受到一个文本消息......");
try {
System.out.println("消息内容:" + textMsg.getText());
} catch (JMSException e) {
e.printStackTrace();
}
}

}

3.4 实现测试组件

package com.lin.activity.test;

import javax.jms.Destination;

import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import com.lin.activity.intf.ProductService;

/**
* Spring组件测试类
* @author lin
*/
//配置Spring组件运行时
@RunWith(SpringJUnit4ClassRunner.class)
//配置测试组件的配置文件路径,该路径位于class或maven项目的resource文件夹下
@ContextConfiguration("/applicationContext-jms.xml")
public class ActiveMQTest {

//属性自动绑定
@Autowired
@Qualifier("queueDestination")
private Destination destination;
@Autowired
private ProductService productService;

public Destination getDestination() {
return destination;
}

public void setDestination(Destination destination) {
this.destination = destination;
}

public ProductService getProductService() {
return productService;
}

public void setProductService(ProductService productService) {
this.productService = productService;
}

//测试方法
@org.junit.Test
public void testSendMessage()
{
for(int i=0;i<10;i++)
{
productService.sendMessage(destination, "发送第 "+i+" 条消息......");
}
}

}

3.5 配置applicationContext*.xml文件管理依赖:

<?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:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd"> <!-- 使用注解方式注入 -->
<context:component-scan base-package="com.lin" />

<!-- Spring提供的JMS工具类，它可以进行消息发送、接收等 -->
<bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
<!-- 这个connectionFactory对应的是我们定义的Spring提供的那个ConnectionFactory对象 -->
<property name="connectionFactory" ref="connectionFactory" />
</bean>

<!-- 消息发送组件 -->
<bean id="productServiceImpl" class="com.lin.activity.service.ProductServiceImpl">
<property name="jmsTemplate" ref="jmsTemplate"></property>
</bean>

<!-- 真正可以产生Connection的ConnectionFactory，由对应的 JMS服务厂商提供 -->
<bean id="targetConnectionFactory" class="org.apache.activemq.ActiveMQConnectionFactory">
<property name="brokerURL" value="tcp://localhost:61616" />
</bean>

<!-- Spring用于管理真正的ConnectionFactory的ConnectionFactory -->
<bean id="connectionFactory"
class="org.springframework.jms.connection.SingleConnectionFactory">
<!-- 目标ConnectionFactory对应真实的可以产生JMS Connection的ConnectionFactory -->
<property name="targetConnectionFactory" ref="targetConnectionFactory" />
</bean>

<!--这个是队列目的地 -->
<bean id="queueDestination" class="org.apache.activemq.command.ActiveMQQueue">
<constructor-arg>
<value>queue</value>
</constructor-arg>
</bean>
<!-- 消息监听器 -->
<bean id="costumerListener"
class="com.lin.activity.service.CostumerListener" />
<!-- 消息监听容器 -->
<bean id="jmsContainer"
class="org.springframework.jms.listener.DefaultMessageListenerContainer">
<property name="connectionFactory" ref="connectionFactory" />
<property name="destination" ref="queueDestination" />
<property name="messageListener" ref="costumerListener" />
</bean>

<!-- 单元测试类 -->
<!--  -
<bean id="activeMQTest" class="com.lin.activity.test.ActiveMQTest">
<property name="destination" ref="queueDestination"></property>
<property name="productService" ref="productServiceImpl"></property>
</bean>
-->
</beans>

在上面配置中,在配置一个MessageListenerContainer的时候有三个属性必须指定，一个是表示从哪里监听的ConnectionFactory；一个是表示监听什么的Destination；一个是接收到消息以后进行消息处理的MessageListener。Spring一共为我们提供了两种类型的MessageListenerContainer，SimpleMessageListenerContainer和DefaultMessageListenerContainer。

SimpleMessageListenerContainer会在一开始的时候就创建一个会话session和消费者Consumer，并且会使用标准的JMS MessageConsumer.setMessageListener()方法注册监听器让JMS提供者调用监听器的回调函数。它不会动态的适应运行时需要和参与外部的事务管理。兼容性方面，它非常接近于独立的JMS规范，但一般不兼容Java EE的JMS限制。
大多数情况下我们还是使用的DefaultMessageListenerContainer，跟SimpleMessageListenerContainer相比，DefaultMessageListenerContainer会动态的适应运行时需要，并且能够参与外部的事务管理。它很好的平衡了对JMS提供者要求低、先进功能如事务参与和兼容Java EE环境。

4 测试

以单元测试运行ActiveMQTest的方法

关闭activemq: ./activemq stop

该实例的目录结构: