1 ActiveMQ是啥
ActiveMQ 就是一个消息中间件,市面上现在有很多的消息中间件开源产品,比如,RocketMQ、RabbitMQ、Kafka等。
拿一个简单的比喻来说,消息中间件就是一个中转站,在程序中加的一个中转站,有了这样一个类似快递的存储站点,可以大大的减轻物流的压力,而对应到程序中,也就是减轻了程序的压力。
另外不得不说的是,ActiveMQ是遵从 JMS 规范的消息中间件,那么什么是 JMS 规范呢?
JMS 规范
JMS是java的消息服务,JMS的客户端之间可以通过JMS服务进行异步的消息传输。
消息模型
- Point-to-Point(P2P),点对点
- P2P模式图
如上图,有几个需要了解的概念,发送者、接收者、消息队列。
在点对点模型中,一般消息由发送者将消息发送到消息队列中,然后,接收者从消息队列中消费消息,消息被消费者消费之后,消息就不存在了。
- Publish/Subscribe(Pub/Sub),发布订阅模型
- Pub/Sub模式图
如上图,有下面几个概念,主题、发布者、订阅者。
在发布订阅模型中,发布者通常将消息发布到主题(topic)中,然后,订阅者通过订阅主题来消费消息,与 P2P 模型不同的是,发布订阅模型的消息是可以被多次消费的!
两种模式的区别
1、P2P
在发送者和接收者之间没有时间上的依赖性,也就是说发送者发送了消息之后,不管接收者有没有运行,不会影响消息发送到队列,而Pub/Sub
模式有时间上的依赖性,消费者必须先订阅主题,才能够消费消息。
2、P2P
模式的每个消息只能有一个消费者,消费完了消息就不存在了,Pub/Sub
模式可以有多个消费者。
2 为什么需要使用消息中间件
到这里我就不得不讲一个小故事了!
小明、小李和小白都是在一个项目组的 Java 开发人员,但是呢,他们的团队比较小,只有几个开发人员,而他们正在开发一个项目,这个项目比较庞大,所以,项目负责人就考虑到项目进度,给他们每个人都分一个模块单独开发,这样就能够加快项目的进度了。
然而,万万没有想到的是,当项目开发到一定阶段的时候,小明、小李和小白各自负责的模块都需要项目调用数据了,但是呢,现在问题来了,每次小白向小明需要数据的时候,小明总是要改接口来满足小白的需求,而且还会担心小明的系统会不会出问题,如果出了问题就调用不了怎么办?这样就总是耽误项目的进度,小李那边也是出现了这种问题!
于是,小明就想了个办法,如果在各个模块之间再加一个模块,用来处理数据,比如一个队列来存数据,每次就把数据丢到那个模块中去,这样就不用担心那个问题啦。小明是不是很聪明!
其实,小明没有做足够的调查,他说的这个模块,就是 ActiveMQ 的作用所在啦。
也就是降低模块与模块之间的耦合度,达到解耦的目的!
然后,他们又遇到了一个问题,他们在开发一个用户注册模块的时候,是先注册,然后写入数据库,然后再发送邮件或者短信通知用户,但是,他们发现这样的系统速度很慢!
后来,他们发现了消息中间件后,改造了一下,变成了下面的模式。
他们也发现了,这就是消息中间件带来的异步执行的优势!
系统速度杠杠的!
后来,小明、小李和小白开发的系统呢上线了,但是,公司业快速发展,当流量大的时候,系统的数据调用总是负荷不了,出现宕机的问题,没办法,只能再改代码了!
他们灵机一动,前面都用了消息中间件了,但是没有发现另外一个功能,我们可以加入消息中间件,控制每次消费消息的数量,保证系统不会宕机,剩下的消息在系统流量小的时候再定时执行不就可以了。简直不要太好!
小明、小李和小白经过这个系统的开发,终于明白了消息中间件的优势了!
3 安装使用
3.1 下载
到下面的官网地址下载,包括linux和Windows的不同版本。
3.2 解压使用
windows使用方法
首先,解压到一个自己的目录,ActiveMQ目录如下;
进入到对应的 bin 目录;
里面有一个 activemq 的可执行文件,打开 cmd,执行:activemq start
成功启动了!
关闭;
activemq stop
linux 使用方法
解压到指定目录;
sudo tar zxvf activemq-x.x.x-bin.tar.gz
进入到 bin 目录,执行下面命令;
./activemq start
关闭;
./activemq stop
后台管理界面
启动成功之后,可以输出http://localhost:8161/admin/
查看 ActiveMQ 的后台管理界面,用户名和密码都为 admin
。
ok,到这里,ActiveMQ的安装和基本使用应该没有问题了,接下来,我们使用 ActiveMQ 的 Java API 从一个入门实例开始讲起!
4 ActiveMQ入门程序
4.1 前提条件
在开始之前,先申明一下需要的 Java 环境的配置,相关配置自行解决哦!
- Java JDK1.7 以上
- Maven 3.0 以上
- 开发工具 IDEA
4.2 带你入门
step1:导入 Maven 相关依赖;
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>8</source>
<target>8</target>
</configuration>
</plugin>
</plugins>
</build>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<spring.version>4.3.10.RELEASE</spring.version>
</properties>
<dependencies>
<dependency>
<groupId>org.apache.activemq</groupId>
<artifactId>activemq-all</artifactId>
<version>5.15.0</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jms</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
<version>2.6.2</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
</dependencies>
step2:创建发送端类;
/**
* @ClassName JmsSender
* @Description
* @Author 欧阳思海
* @Date 2019/8/13 16:39
* @Version 1.0
**/
public class JmsSender {
public static void main(String[] args) {
ConnectionFactory connectionFactory = new ActiveMQConnectionFactory("tcp://localhost:61616");
Connection connection = null;
try {
connection = connectionFactory.createConnection();
connection.start();
Session session = connection.createSession(Boolean.FALSE, Session.CLIENT_ACKNOWLEDGE);
Destination destination = session.createQueue("queue");
MessageProducer producer = session.createProducer(destination);
TextMessage textMessage = session.createTextMessage("hello activemq");
producer.send(textMessage);
//session.commit();
session.close();
} catch (JMSException e) {
e.printStackTrace();
} finally {
if (connection != null) {
try {
connection.close();
} catch (JMSException e) {
e.printStackTrace();
}
}
}
}
}
上面的代码创建了一个消息发送者,步骤如下:
1、创建ActiveMQ实现的JMS规范的实现类ActiveMQConnectionFactory
的对象connectionFactory
,并且给定参数ActiveMQ的服务地址;
2、由connectionFactory
调用方法createConnection
创建连接connection
对象;
3、由connection
对象调用createSession
方法创建session
会话对象;
4、有了session
对象之后,就可以发送者、队列或者主题了,这里创建队列,session.createQueue("queue")
,并给定了队列名称为queue
。
5、session
对象通过方法createProducer
创建生产者,并且创建消息session.createTextMessage("hello activemq")
;
6、生产者调用send
的方法发送消息,producer.send(textMessage)
;
通过上面的步骤就可以将消息发送到队列中了,接着只要等待消费者消费消息即可,消息消费后,消息就消失了。
通过上面的讲解,也将JMS的主要的接口都概括了,包括:ConnectionFactory(连接工厂)、Session(会话)、Connection(连接);
step3:创建消费端类;
/**
* @ClassName JmsReceiver
* @Description
* @Author 欧阳思海
* @Date 2019/8/13 16:47
* @Version 1.0
**/
public class JmsReceiver {
public static void main(String[] args) {
ConnectionFactory connectionFactory = new ActiveMQConnectionFactory("tcp://localhost:61616");
Connection connection = null;
try {
//创建连接
connection = connectionFactory.createConnection();
connection.start();
Session session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
//创建队列(如果队列已经存在则不会创建,queue是队列名称)
//destination表示目的地
Destination destination = session.createQueue("queue");
//创建消息接收者
MessageConsumer consumer = session.createConsumer(destination);
TextMessage textMessage = (TextMessage) consumer.receive();
System.out.println(textMessage.getText());
session.commit();
session.close();
} catch (JMSException e) {
e.printStackTrace();
} finally {
if (connection != null) {
try {
connection.close();
} catch (JMSException e) {
e.printStackTrace();
}
}
}
}
}
消费者和生产者的差别不大,前面的创建工厂、创建连接、创建会话对象和生产者一样,区别在于,session.createConsumer(destination)
通过session
创建消费者,然后,调用receive
方法接受消息。
运行发送端,查看后台管理界面,点击 Queues 选项,发现有一个入队的消息,并且没有出队列;
运行接收端;
再查看后台管理界面,消息被消费了;
5 ActiveMQ整合Spring
这一部分花了挺多时间琢磨的,首先是应为在实际的开发中,我们整合Spring来开发项目是最多的一种方式,这一块如果可以学透的话,对于项目开发是非常有好处的,出于这个出发点,尽可能的把相关的知识讲解的全面一些。
首先,这一部分分为以下三个部分来讲解。
- 不使用 Spring 配置文件方式
- 使用 Spring 配置文件方式
- 注解方式(0配置)
5.1 前提条件
- JDK 1.7 以上
- Maven 3.0 以上
- Spring 4.3.1 ,或者以上版本
- ActiveMQ 5.15.9 目前最新稳定版本
项目结构
这次搭建的项目是一个子模块聚合的项目,结构如下;
这个聚合的项目分为生产者(Producer) 和消费者(Consumer)两个子模块。
导入 Maven 依赖
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<spring.version>4.3.10.RELEASE</spring.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.activemq</groupId>
<artifactId>activemq-all</artifactId>
<version>5.15.9</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jms</artifactId>
<version>${spring.version}</version>
</dependency>
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-pool2</artifactId>
<version>2.6.2</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>4.2.5.RELEASE</version>
</dependency>
</dependencies>
</dependencyManagement>
温馨提示
由于我这里使用的是子模块聚合的方式,所以,如果你不是这种方式的项目,直接给出各个依赖的版本在你的项目中即可!
5.2 不使用 Spring 配置文件方式
这一节的讲解中,我们将采用不使用 Spring 的配置文件的方式,Maven 的相关依赖在上面已经给出,请参考上一节的内容。
生产者(Producer)
首先,我们来看一下生产者端,生产者端主要负责发送消息到 Broker
中,发送的目的地(Destination)
可以分为队列(Queue)
和主题(Topic)
,下面,我们就看看如何不采用 Spring 配置文件的方式发送消息。
public static void main(String[] args) {
ConnectionFactory cf = new ActiveMQConnectionFactory("tcp://localhost:61616");
Connection connection = null;
try {
connection = cf.createConnection();
connection.start();
Session session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
Queue destination = session.createQueue("queue2");
JmsQueueSenderWithNotXml jmsQueueSender = new JmsQueueSenderWithNotXml();
jmsQueueSender.setConnectionFactory(cf);
jmsQueueSender.setQueue(destination);
jmsQueueSender.simpleSend();
jmsQueueSender.sendWithConversion();
} catch (JMSException e) {
e.printStackTrace();
}
}
private JmsTemplate jmsTemplate;
private Queue queue;
public void setConnectionFactory(ConnectionFactory cf) {
this.jmsTemplate = new JmsTemplate(cf);
}
public void setQueue(Queue queue) {
this.queue = queue;
}
/*
* @Author 欧阳思海
* @Description 发送简单消息
* @Date 15:45 2019/8/16
* @Param []
* @return void
**/
public void simpleSend() {
this.jmsTemplate.send(this.queue, new MessageCreator() {
public Message createMessage(Session session) throws JMSException {
return session.createTextMessage("hello queue world");
}
});
System.out.println("发送成功!");
}
/*
* @Author 欧阳思海
* @Description 发送map类型的消息
* @Date 15:46 2019/8/16
* @Param []
* @return void
**/
public void sendWithConversion() {
Map map = new HashMap();
map.put("Name", "sihai");
map.put("Age", new Integer(18));
jmsTemplate.convertAndSend("Queue3", map, new MessagePostProcessor() {
public Message postProcessMessage(Message message) throws JMSException {
message.setIntProperty("num", 189);
message.setJMSCorrelationID("00001");
return message;
}
});
System.out.println("发送成功!");
}
step1:上面是生产者端的所有代码示例,在这个示例中,我们首先通过下面的代码设置好ConnectionFactory 和Queue,并且调用JmsTemplate
Spring提供的工具类提供两个发送消息的方法 。
private JmsTemplate jmsTemplate;
private Queue queue;
public void setConnectionFactory(ConnectionFactory cf) {
this.jmsTemplate = new JmsTemplate(cf);
}
public void setQueue(Queue queue) {
this.queue = queue;
}
/*
* @Author 欧阳思海
* @Description 发送简单消息
* @Date 15:45 2019/8/16
* @Param []
* @return void
**/
public void simpleSend() {
this.jmsTemplate.send(this.queue, new MessageCreator() {
public Message createMessage(Session session) throws JMSException {
return session.createTextMessage("hello queue world");
}
});
System.out.println("发送成功!");
}
/*
* @Author 欧阳思海
* @Description 发送map类型的消息
* @Date 15:46 2019/8/16
* @Param []
* @return void
**/
public void sendWithConversion() {
Map map = new HashMap();
map.put("Name", "sihai");
map.put("Age", new Integer(18));
jmsTemplate.convertAndSend("Queue3", map, new MessagePostProcessor() {
public Message postProcessMessage(Message message) throws JMSException {
message.setIntProperty("num", 189);
message.setJMSCorrelationID("00001");
return message;
}
});
System.out.println("发送成功!");
}
step2:使用Main方法,设置ConnectionFactory和Queue对象,接着,调用发送方法发送消息。
public static void main(String[] args) {
ConnectionFactory cf = new ActiveMQConnectionFactory("tcp://localhost:61616");
Connection connection = null;
try {
connection = cf.createConnection();
connection.start();
Session session = connection.createSession(Boolean.TRUE, Session.AUTO_ACKNOWLEDGE);
Queue destination = session.createQueue("queue2");
JmsQueueSenderWithNotXml jmsQueueSender = new JmsQueueSenderWithNotXml();
jmsQueueSender.setConnectionFactory(cf);
jmsQueueSender.setQueue(destination);
jmsQueueSender.simpleSend();
jmsQueueSender.sendWithConversion();
} catch (JMSException e) {
e.printStackTrace();
}
}
step2:接着,我们运行上面的代码,输出下面结果,再看一下ActiveMQ的控制台,看看有没有消息发送成功。
发现有一条挂起的消息和入队列的消息,说明发送成功!
消费者(Consumer)
对于消费者,在这一节先不展开讲解,可以先参考上面的入门程序的消费端的代码消费消息,接下来的方式再讲解消费端的消费消息。
5.3 使用 Spring 配置文件方式
上面一节中,讲解了不使用 Spring 配置的方式如何发送消息,主要是想让大家了解一下其中的原理,这一节中,将使用 Spring 配置的方式讲解,这种方式在实际的开发中还是用的比较多的。
生产者(Producer)
既然是配置文件的方式,那么,首先,不得不讲如何进行xml配置了。
step1: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:jms="http://www.springframework.org/schema/jms"
xsi:schemaLocation="
http://www.springframework.org/schema/beans https://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/jms https://www.springframework.org/schema/jms/spring-jms.xsd">
<bean id="connectionFactory" class="org.apache.activemq.pool.PooledConnectionFactory" destroy-method="stop">
<property name="connectionFactory">
<bean class="org.apache.activemq.ActiveMQConnectionFactory">
<property name="brokerURL">
<value>tcp://localhost:61616</value>
</property>
</bean>
</property>
<property name="maxConnections" value="50"/>
</bean>
<bean id="destination" class="org.apache.activemq.command.ActiveMQQueue">
<constructor-arg index="0" value="spring-queue"/>
</bean>
<!--<bean id="destinationTopic" class="org.apache.activemq.command.ActiveMQTopic">
<constructor-arg index="0" value="spring-topic"/>
</bean>-->
<bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
<property name="connectionFactory" ref="connectionFactory"/>
<property name="defaultDestination" ref="destination"/>
<property name="messageConverter">
<bean class="org.springframework.jms.support.converter.SimpleMessageConverter"/>
</property>
</bean>
</beans>
在上面的配置中,首先,需要配置connectionFactory
(对应不使用配置的connectionFactory对象),然后,需要配置destination
(对应不使用配置的destination),在这里使用的是向队列发送消息,也可以使用主题(Topic),最后,配置 Spring 提供的jmsTemplate
模板类。
step2:使用Main方法运行
public static void main(String[] args) {
ApplicationContext application = new FileSystemXmlApplicationContext("G:\\ideaproject\\activemq\\Producer\\src\\main\\resources\\service-jms.xml");
JmsTemplate jmsTemplate = (JmsTemplate) application.getBean("jmsTemplate");
for (int i = 0; i < 10; i++) {
int finalI = i;
jmsTemplate.send((session) -> {
TextMessage textMessage = session.createTextMessage();
textMessage.setText("first message" + finalI);
return textMessage;
});
}
}
在上面的代码中,调用了JmsTemplate
的send
方法发送消息。运行之后,就成功发送消息了,这种方式还是简洁不少的。
温馨提示
上面我使用的是FileSystemXmlApplicationContext
获取xml配置文件,除此之外,你也可以使用ClassPathXmlApplicationContext
来获取。
消费者(Consumer)
在上一节中,没有讲解消费者,在这一节中,将重点讲解。
step1:首先,我们还是需要配置xml文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:amq="http://activemq.apache.org/schema/core"
xmlns:jms="http://www.springframework.org/schema/jms"
xsi:schemaLocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-4.1.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context-4.1.xsd
http://www.springframework.org/schema/jms
http://www.springframework.org/schema/jms/spring-jms-4.1.xsd
http://activemq.apache.org/schema/core
http://activemq.apache.org/schema/core/activemq-core-5.8.0.xsd">
<!--连接工厂-->
<bean id="connectionFactory" class="org.apache.activemq.pool.PooledConnectionFactory" destroy-method="stop">
<property name="connectionFactory">
<bean class="org.apache.activemq.ActiveMQConnectionFactory">
<property name="brokerURL">
<value>tcp://localhost:61616</value>
</property>
</bean>
</property>
<property name="maxConnections" value="50"/>
</bean>
<!--配置队列-->
<bean id="destination" class="org.apache.activemq.command.ActiveMQQueue">
<constructor-arg index="0" value="queue2"/>
</bean>
<!-- 配置主题(topic)-->
<!-- <bean id="destinationTopic" class="org.apache.activemq.command.ActiveMQTopic">
<constructor-arg index="0" value="spring-topic"/>
</bean>-->
<!--配置spring的jms模板-->
<bean id="jmsTemplate" class="org.springframework.jms.core.JmsTemplate">
<property name="connectionFactory" ref="connectionFactory"/>
<property name="defaultDestination" ref="destination"/>
<property name="messageConverter">
<bean class="org.springframework.jms.support.converter.SimpleMessageConverter"/>
</property>
</bean>
<!-- 消息监听器 -->
<!--<bean id="messageListener" class="com.sihai.activemq.listener.MyMessageListener"/>-->
<bean id="messageListener" class="com.sihai.activemq.listener.MySessionAwareMessageListener"></bean>
<!--jta事务-->
<!--<bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager"/>-->
<!-- 消息监听器容器 -->
<bean id="jmsContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
<property name="connectionFactory" ref="connectionFactory"/>
<property name="destination" ref="destination"/>
<property name="messageListener" ref="messageListener"/>
<!--配置本地资源事务-->
<!--<property name="sessionTransacted" value="true"/>-->
<!--配置jta事务-->
<!--<property name="transactionManager" ref="transactionManager"/>-->
</bean>
<!--<!– 监听注解支持 –>
<jms:annotation-driven />-->
</beans>
最前面的配置和生产者是一样的,需要配置connectionFactory
(对应不使用配置的connectionFactory对象),然后,需要配置destination
(对应不使用配置的destination)。
区别在于,消费者端需要配置一个消息监听器容器,如下。
<!-- 消息监听器 -->
<!--<bean id="messageListener" class="com.sihai.activemq.listener.MyMessageListener"/>-->
<bean id="messageListener" class="com.sihai.activemq.listener.MySessionAwareMessageListener"></bean>
<!--jta事务-->
<!--<bean id="transactionManager" class="org.springframework.transaction.jta.JtaTransactionManager"/>-->
<!-- 消息监听器容器 -->
<bean id="jmsContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
<property name="connectionFactory" ref="connectionFactory"/>
<property name="destination" ref="destination"/>
<property name="messageListener" ref="messageListener"/>
<!--配置本地资源事务-->
<!--<property name="sessionTransacted" value="true"/>-->
<!--配置jta事务-->
<!--<property name="transactionManager" ref="transactionManager"/>-->
</bean>
那么这个怎么配置呢?请接着看。
step2:消息监听器容器配置
首先,我们需要写一个类,实现MessageListener
接口,然后实现一个名为onMessage
的方法,通过这个方法就可以监听是否有消息,有消息就消费。
/**
* @ClassName MyMessageListener
* @Description 消息消费监听器实现
* @Author 欧阳思海
* @Date 2019/8/13 20:39
* @Version 1.0
**/
@Component
public class MyMessageListener implements MessageListener {
@Override
public void onMessage(Message message) {
if (message instanceof TextMessage) {
try {
System.out.println(((TextMessage) message).getText());
}
catch (JMSException ex) {
throw new RuntimeException(ex);
}
}
else {
throw new IllegalArgumentException("Message must be of type TextMessage");
}
}
}
如此,配置就完成了。
step3:启动spring容器,运行。
/*
* @Author 欧阳思海
* @Description xml配置方式获取消息
* @Date 18:09 2019/8/16
* @Param []
* @return void
**/
@Test
public void test_01() throws IOException {
ClassPathXmlApplicationContext application = new ClassPathXmlApplicationContext("G:\\ideaproject\\activemq\\Consumer\\src\\main\\resources\\service-jms.xml");
/*JmsTemplate jmsTemplate = (JmsTemplate) application.getBean("jmsTemplate");
String msg = (String) jmsTemplate.receiveAndConvert();
System.out.println(msg);*/
System.in.read();
}
在上面的代码中,System.in.read()
,这个作用就是一直等待,有消息就消费。
step4:开启消息监听器事务
在消息处理的过程中是可以开启事务的,如果出现处理失败的情况,就会回滚。在消息监听容器当中可以配置一个属性是sessionTransacted的本地事务,如果value
为true
,就代表开启本地事务。具体配置如下:
<!-- 消息监听器容器 -->
<bean id="jmsContainer" class="org.springframework.jms.listener.DefaultMessageListenerContainer">
<property name="connectionFactory" ref="connectionFactory"/>
<property name="destination" ref="destination"/>
<property name="messageListener" ref="messageListener"/>
<!--配置本地资源事务-->
<property name="sessionTransacted" value="true"/>
</bean>
消息监听器容器
上面的消费者的讲解中,其实,最重要的就是消息监听器容器配置了,这一部分,我们就详细的讲解一下消息监听器容器的配置方法。
1 实现MessageListener接口
这种方式就是上面的实例使用的方式,先看看这个接口。
public interface MessageListener {
void onMessage(Message var1);
}
这个接口很简单,只有一个方法onMessage
,通过拿到Message
参数读取消息,这里就不再多说了。
2 实现SessionAwareMessageListener接口
这个接口平时很少用到,但是,其实是有这个接口可以实现的,这个接口和上面的MessageListener
接口有点不一样,这个接口是Spring
提供的。
public interface SessionAwareMessageListener<M extends Message> {
void onMessage(M var1, Session var2) throws JMSException;
}
另外,你可以看到,这个接口提供的是一个泛型接口,可以是M extends Message
这个类型,同时,实现的方式onMessage
,还多了一个Session
参数,可以在获取消息的同时处理Session
。
使用实例
/**
* @ClassName MySessionAwareMessageListener
* @Description 实现SessionAwareMessageListener的消息监听器
* @Author 欧阳思海
* @Date 2019/8/16 16:02
* @Version 1.0
**/
public class MySessionAwareMessageListener implements SessionAwareMessageListener {
@Override
public void onMessage(Message message, Session session) throws JMSException {
if (message instanceof TextMessage) {
try {
System.out.println(((TextMessage) message).getText());
}
catch (JMSException ex) {
throw new RuntimeException(ex);
}
}
else {
throw new IllegalArgumentException("Message must be of type TextMessage");
}
}
}
5.4 注解方式(0配置)
前面已经介绍了两种方式,分别是不使用xml配置方式和使用xml配置的方式,但是,由于现在微服务的兴起,约定优于配置是现在的一种趋势,所以,在这一节中,我们使用注解的方式来处理。
生产者(Producer)
由于使用注解的方式,所以,我们不再需要xml配置文件了,但是,我们可以参照上面的xml的配置方式来配置注解的方式。
step1:首先,我们需要一个 Java 配置类,如下;
/**
* @ClassName ProducerConfig
* @Description 不用xml的配置类
* @Author 欧阳思海
* @Date 2019/8/16 17:41
* @Version 1.0
**/
@Configuration
public class ProducerConfig {
@Bean
//配置ConnectionFactory用于生成connection
public ActiveMQConnectionFactory connectionFactory() {
ActiveMQConnectionFactory activeMQConnectionFactory
= new ActiveMQConnectionFactory("tcp://localhost:61616");
return activeMQConnectionFactory;
}
@Bean
//注册SingleConnectionFactory,这个spring的一个包装工厂 用于管理真正的ConnectionFactory
public SingleConnectionFactory singleConnectionFactory(ActiveMQConnectionFactory activeMQconnectionFactory) {
SingleConnectionFactory connectionFactory = new SingleConnectionFactory();
//设置目标工厂
connectionFactory.setTargetConnectionFactory(activeMQconnectionFactory);
return connectionFactory;
}
@Bean
//配置生产者,jmsTemplate
public JmsTemplate jmsTemplate(SingleConnectionFactory connectionFactory) {
JmsTemplate jmsTemplate = new JmsTemplate();
jmsTemplate.setConnectionFactory(connectionFactory);
return jmsTemplate;
}
/**
* 配置队列目的的: 根据测试需要配置其中一个
* 1.队列 点对点 queue
* 2.主题 一对多 topic
*/
@Bean //
public ActiveMQQueue queueDestination() {
ActiveMQQueue activeMQQueue = new ActiveMQQueue("queue-anno");
return activeMQQueue;
}
@Bean
public ActiveMQTopic topicDestination() {
ActiveMQTopic activeMQTopic = new ActiveMQTopic("topic-anno");
return activeMQTopic;
}
}
上面的配置的每一个方法就对应xml配置的每一个节点,对应起来配置会比较简单,每一个方法都使用了@Bean
这个注解,类上使用Configuration
,将这些配置加入到 spring 容器中。
step2:启动 spring 容器,发送消息;
/**
* @ClassName JmsSenderWithAnnotation
* @Description 注解发送方式
* @Author 欧阳思海
* @Date 2019/8/16 18:04
* @Version 1.0
**/
public class JmsSenderWithAnnotation {
/*
* @Author 欧阳思海
* @Description 测试点对点
* @Date 18:05 2019/8/16
* @Param []
* @return void
**/
@Test
public void testActiveMqAnnotation() {
AnnotationConfigApplicationContext aContext =
new AnnotationConfigApplicationContext(ProducerConfig.class);
//获得发送者的模板对象
JmsTemplate jmsTemplate = aContext.getBean(JmsTemplate.class);
Destination bean = (Destination) aContext.getBean("queueDestination");
//发送消息
jmsTemplate.send(bean, new MessageCreator() {
@Override
public Message createMessage(Session session) throws JMSException {
TextMessage message = session.createTextMessage();
message.setText("activemq message for queue");
return message;
}
});
}
/*
* @Author 欧阳思海
* @Description 测试topic发送
* @Date 18:06 2019/8/16
* @Param []
* @return void
**/
@Test
public void testActiveMqAnnotation2() {
AnnotationConfigApplicationContext aContext =
new AnnotationConfigApplicationContext(ProducerConfig.class);
//获得发送者的模板对象
JmsTemplate jmsTemplate = aContext.getBean(JmsTemplate.class);
Destination bean = (Destination) aContext.getBean("topicDestination");
//发送消息
jmsTemplate.send(bean, new MessageCreator() {
@Override
public Message createMessage(Session session) throws JMSException {
TextMessage message = session.createTextMessage();
message.setText("activemq message for topic");
return message;
}
});
}
}
分别运行这两个测试,查看ActiveMQ控制台,发现Queue和Topic都有一条消息发送成功;
消费者(Consumer)
消费者的大概也差不多,跟xml的配置一样,多的也是消息监听容器的配置,来看看;
step1:首先,Java 配置类
**
* @ClassName ConsumerConfig
* @Description 不用xml的配置类
* @Author 欧阳思海
* @Date 2019/8/16 17:44
* @Version 1.0
**/
@ComponentScan(basePackages = {"com.sihai"})
@EnableJms
@Configuration
public class ConsumerConfig {
@Bean
//配置ConnectionFactory用于生成connection
public ActiveMQConnectionFactory connectionFactory() {
ActiveMQConnectionFactory activeMQConnectionFactory
= new ActiveMQConnectionFactory("tcp://localhost:61616");
return activeMQConnectionFactory;
}
@Bean
//注册SingleConnectionFactory,这个spring的一个包装工厂 用于管理真正的ConnectionFactory
public SingleConnectionFactory singleConnectionFactory(ActiveMQConnectionFactory activeMQconnectionFactory) {
SingleConnectionFactory connectionFactory = new SingleConnectionFactory();
//设置目标工厂
connectionFactory.setTargetConnectionFactory(activeMQconnectionFactory);
return connectionFactory;
}
/*在xml当中的如下配置 效果相同
* <bean class="org.springframework.jms.listener.DefaultMessageListenerContainer">
* <property name="connectionFactory" ref="connectionFactory" />
* <property name="destination" ref="topicDestination" />
* <property name="messageListener" ref="itemListenerMessage" />
* </bean>
**/
@Bean
public DefaultMessageListenerContainer jmsListenerContainerFactory(SingleConnectionFactory singleConnectionFactory, MyMessageListener myMessageListener, Destination destination) {
//创建容器
DefaultMessageListenerContainer jmsContainer = new DefaultMessageListenerContainer();
//设置监听器
jmsContainer.setMessageListener(myMessageListener);
//设置连接工厂
jmsContainer.setConnectionFactory(singleConnectionFactory);
//设置监听目的地的名字/也可以直接设置对象目的地
jmsContainer.setDestination(destination);
return jmsContainer;
}
/**
* 1.队列 点对点 queue
* 2.主题 一对多 topic
*/
@Bean
public ActiveMQQueue queueDestination() {
ActiveMQQueue activeMQQueue = new ActiveMQQueue("queue-anno");
return activeMQQueue;
}
/*@Bean
public ActiveMQTopic topicDestination() {
ActiveMQTopic activeMQTopic = new ActiveMQTopic("topic-anno");
return activeMQTopic;
}*/
}
其中只有一个消息监听容器的配置是和生产者的配置不同的,消息监听容器的配置需要配置消息监听器、连接工厂和目的地(Destination)。
/*在xml当中的如下配置 效果相同
* <bean class="org.springframework.jms.listener.DefaultMessageListenerContainer">
* <property name="connectionFactory" ref="connectionFactory" />
* <property name="destination" ref="topicDestination" />
* <property name="messageListener" ref="itemListenerMessage" />
* </bean>
**/
@Bean
public DefaultMessageListenerContainer jmsListenerContainerFactory(SingleConnectionFactory singleConnectionFactory, MyMessageListener myMessageListener, Destination destination) {
//创建容器
DefaultMessageListenerContainer jmsContainer = new DefaultMessageListenerContainer();
//设置监听器
jmsContainer.setMessageListener(myMessageListener);
//设置连接工厂
jmsContainer.setConnectionFactory(singleConnectionFactory);
//设置监听目的地的名字/也可以直接设置对象目的地
jmsContainer.setDestination(destination);
return jmsContainer;
}
step2:消息监听器
/**
* @ClassName MyMessageListener
* @Description 消息消费监听器实现
* @Author 欧阳思海
* @Date 2019/8/13 20:39
* @Version 1.0
**/
@Component
public class MyMessageListener implements MessageListener {
@Override
public void onMessage(Message message) {
if (message instanceof TextMessage) {
try {
System.out.println(((TextMessage) message).getText());
}
catch (JMSException ex) {
throw new RuntimeException(ex);
}
}
else {
throw new IllegalArgumentException("Message must be of type TextMessage");
}
}
}
这个前面已经讲过了,这里就不再累赘了,但是,这里我需要讲的是消息监听器注解方式的配置,如下。
step3:消息监听器注解方式的配置方法
/**
* @ClassName JmsAnnotation
* @Description 注解方式监听
* @Author 欧阳思海
* @Date 2019/8/16 17:01
* @Version 1.0
**/
@Component
@EnableJms
public class JmsAnnotation {
@JmsListener(destination = "queue-anno")
public void onMessage(Message message) {
if (message instanceof TextMessage) {
try {
System.out.println(((TextMessage) message).getText());
}
catch (JMSException ex) {
throw new RuntimeException(ex);
}
}
else {
throw new IllegalArgumentException("Message must be of type TextMessage");
}
}
}
你会发现,在消息监听器的类上面需要两个配置@Component和@EnableJms,用于标记这是一个消息监听器,另外,在onMessage
方法上,需要一个@JmsListener(destination = "queue-anno")
注解,可以标记需要哪个destination
。
注意:如果采用注解的消息监听,那么需要修改Java类的消息监听的容器的配置,否则会出现问题
step4:消息监听容器配置更改
将
/*在xml当中的如下配置 效果相同
* <bean class="org.springframework.jms.listener.DefaultMessageListenerContainer">
* <property name="connectionFactory" ref="connectionFactory" />
* <property name="destination" ref="topicDestination" />
* <property name="messageListener" ref="itemListenerMessage" />
* </bean>
**/
@Bean
public DefaultMessageListenerContainer jmsListenerContainerFactory(SingleConnectionFactory singleConnectionFactory, MyMessageListener myMessageListener, Destination destination) {
//创建容器
DefaultMessageListenerContainer jmsContainer = new DefaultMessageListenerContainer();
//设置监听器
jmsContainer.setMessageListener(myMessageListener);
//设置连接工厂
jmsContainer.setConnectionFactory(singleConnectionFactory);
//设置监听目的地的名字/也可以直接设置对象目的地
jmsContainer.setDestination(destination);
return jmsContainer;
}
改为
@Bean
public DefaultJmsListenerContainerFactory jmsListenerContainerFactory() {
DefaultJmsListenerContainerFactory factory = new DefaultJmsListenerContainerFactory();
factory.setConnectionFactory(connectionFactory());
// factory.setDestinationResolver(destinationResolver());
factory.setSessionTransacted(true);
factory.setConcurrency("3-10");
return factory;
}
上面的修改会发现,实现接口的监听器使用的是DefaultMessageListenerContainer
,而注解的方式使用的是DefaultJmsListenerContainerFactory
,所以,这里需要特别注意。
此时,消息监听器是注解的方式的Java配置类就是下面这样的。
/**
* @ClassName ConsumerConfig
* @Description 不用xml的配置类
* @Author 欧阳思海
* @Date 2019/8/16 17:44
* @Version 1.0
**/
@ComponentScan(basePackages = {"com.sihai"})
@EnableJms
@Configuration
public class ConsumerConfig {
@Bean
//配置ConnectionFactory用于生成connection
public ActiveMQConnectionFactory connectionFactory() {
ActiveMQConnectionFactory activeMQConnectionFactory
= new ActiveMQConnectionFactory("tcp://localhost:61616");
return activeMQConnectionFactory;
}
@Bean
//注册SingleConnectionFactory,这个spring的一个包装工厂 用于管理真正的ConnectionFactory
public SingleConnectionFactory singleConnectionFactory(ActiveMQConnectionFactory activeMQconnectionFactory) {
SingleConnectionFactory connectionFactory = new SingleConnectionFactory();
//设置目标工厂
connectionFactory.setTargetConnectionFactory(activeMQconnectionFactory);
return connectionFactory;
}
@Bean
public DefaultJmsListenerContainerFactory jmsListenerContainerFactory() {
DefaultJmsListenerContainerFactory factory = new DefaultJmsListenerContainerFactory();
factory.setConnectionFactory(connectionFactory());
// factory.setDestinationResolver(destinationResolver());
factory.setSessionTransacted(true);
factory.setConcurrency("3-10");
return factory;
}
/**
* 1.队列 点对点 queue
* 2.主题 一对多 topic
*/
@Bean
public ActiveMQQueue queueDestination() {
ActiveMQQueue activeMQQueue = new ActiveMQQueue("queue-anno");
return activeMQQueue;
}
/*@Bean
public ActiveMQTopic topicDestination() {
ActiveMQTopic activeMQTopic = new ActiveMQTopic("topic-anno");
return activeMQTopic;
}*/
}
step5:启动容器,消费消息
/**
* @ClassName SpringSender
* @Description
* @Author 欧阳思海
* @Date 2019/8/13 17:22
* @Version 1.0
**/
public class SpringReceiver {
/*
* @Author 欧阳思海
* @Description xml配置方式获取消息
* @Date 18:09 2019/8/16
* @Param []
* @return void
**/
@Test
public void test_01() throws IOException {
ApplicationContext application = new FileSystemXmlApplicationContext("G:\\ideaproject\\activemq\\Consumer\\src\\main\\resources\\service-jms.xml");
/*JmsTemplate jmsTemplate = (JmsTemplate) application.getBean("jmsTemplate");
String msg = (String) jmsTemplate.receiveAndConvert();
System.out.println(msg);*/
System.in.read();
}
/*
* @Author 欧阳思海
* @Description 注解方式获取消息
* @Date 18:10 2019/8/16
* @Param []
* @return void
**/
@Test
public void test_02() throws IOException {
AnnotationConfigApplicationContext aContext =
new AnnotationConfigApplicationContext(ConsumerConfig.class);
/*JmsTemplate jmsTemplate = (JmsTemplate) application.getBean("jmsTemplate");
String msg = (String) jmsTemplate.receiveAndConvert();
System.out.println(msg);*/
System.in.read();
}
}
终于,到这里把ActiveMQ整合Spring的全部内容就讲述完结了,这一部分讲了三个部分,分别是:
- 不使用 Spring 配置文件方式
- 使用 Spring 配置文件方式
- 注解方式(0配置)
6 ActiveMQ支持的传输协议
6.1 默认协议介绍
在ActiveMQ中支持的协议还是挺多的,这也是ActiveMQ的一个特点之一,例如,默认支持AMQP、MQTT、OpenWire、STOMP、WebSocket,这些默认的协议的配置都是在activemq.xml
配置文件中的。
<transportConnectors>
<!-- DOS protection, limit concurrent connections to 1000 and frame size to 100MB -->
<transportConnector name="openwire" uri="tcp://0.0.0.0:61616?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="amqp" uri="amqp://0.0.0.0:5672?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="stomp" uri="stomp://0.0.0.0:61613?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="mqtt" uri="mqtt://0.0.0.0:1883?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="ws" uri="ws://0.0.0.0:61614?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
</transportConnectors>
注意:上面的每种协议的端口都必须是不一样的。
6.2 其他协议
除了上面的协议外,还支持这些协议:TCP、UDP 、NIO、SSL、Http(s)、vm
那么如何使用这些协议呢?
只需要在上面的activemq.xml
配置文件中的transportConnectors
节点添加就可以,例如,添加 nio协议。
<transportConnectors>
<!-- 新增协议 -->
<transportConnector name="nio" uri="nio://0.0.0.0:61619"/>
<!-- DOS protection, limit concurrent connections to 1000 and frame size to 100MB -->
<transportConnector name="openwire" uri="tcp://0.0.0.0:61616?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="amqp" uri="amqp://0.0.0.0:5672?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="stomp" uri="stomp://0.0.0.0:61613?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="mqtt" uri="mqtt://0.0.0.0:1883?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
<transportConnector name="ws" uri="ws://0.0.0.0:61614?maximumConnections=1000&wireFormat.maxFrameSize=104857600"/>
</transportConnectors>
其他协议的添加方法也是相似的!
6.3 简化配置
在ActiveMQ中还有一种更加简单的配置方法,在uri中可以使用 auto
来简化配置,ActiveMQ将监听器端口的消息自动适配相应的协议。
<transportConnector name="auto" uri="auto://0.0.0.0:61619"/>
如果需要更加安全,还可以在此基础上添加ssl
协议。
<transportConnector name="auto+ssl" uri="auto+ssl://0.0.0.0:61619"/>
如果还想要提高传输的性能,可以配合上面的nio
协议,提高网络性能。
<transportConnector name="auto+nio" uri="auto+nio://0.0.0.0:61619"/>
7 ActiveMQ的持久化存储机制
持久化的作用是什么呢?
作用主要是为避免系统以外宕机而导致消息丢失,在ActiveMQ中支持多种持久化机制,比如,JDBC、AMQ、KahaDB、LevelDB,下面简单介绍一下这几种机制。
- JDBC:基于数据库存储的方式,可以存储在Mysql等数据库中,这种机制的性能瓶颈在Mysql等数据库,所以其性能是不太好的。
配置方法
在activemq.xml
配置文件中配置,这里我们使用Mysql进行配置。
step1:修改persistenceAdapter节点
<persistenceAdapter>
<jdbcPersistenceAdapter dataSource="#mysqlDataSource" createTablesOnStartup="true"/>
<!--<kahaDB directory="${activemq.data}/kahadb"/>-->
</persistenceAdapter>
其中,dataSource="#mysqlDataSource"
是数据源引用。
step2:配置Mysql数据源
<bean id="mysqlDataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/test"/>
<property name="username" value="root"/>
<property name="password" value="123456"/>
</bean>
这就是spring的配置方式。
step3:导入数据库连接池、驱动等Jar包
在ActiveMQ的目录中有一个lib目录,是存放jar包的目录。
将下面几个Jar放入。
step4:启动ActiveMQ,查看结果
启动之后,打开mysql数据库,发现生成了三张数据表。
这样就成功了,每次生成消息之后,就会将消息的信息存储到这三张表中,消费之后,再删除信息。
- AMQ:基于文件存储,这种方式会把消息写入日志文件,并且是顺序存储方式,这种方式比JDBC方式要好,缺点是:会为每个Destination创建索引,占用大量磁盘空间。
配置方法
在activemq.xml
配置文件中配置,更加详细参数请参考:https://activemq.apache.org/amq-message-store。
<broker brokerName="broker" persistent="true" useShutdownHook="false">
<persistenceAdapter>
<amqPersistenceAdapter directory="数据存储目录" maxFileLength="32mb"/>
</persistenceAdapter>
</broker>
- KahaDB:这个5.4版本之后出现的默认的持久化方式,与AMQ很相似,不同的是只为Destination创建一个索引。
配置方法
在activemq.xml
配置文件中配置,更加详细参数请参考:https://activemq.apache.org/kahadb。
<broker brokerName="broker">
<persistenceAdapter>
<kahaDB directory="数据存储目录" journalMaxFileLength="32mb"/>
</persistenceAdapter>
</broker>
- LevelDB:5.6版本后推出的新的持久化方式。这种比KahaDB更快,跟KahaDB类似,但是不是用自定义B数实现。但是需要注意的是,目前官网已经不推荐使用这种方式,而是推荐使用KahaDB。
配置方法
在activemq.xml
配置文件中配置,更加详细的参数请参考:https://activemq.apache.org/leveldb-store。
<broker brokerName="broker" ... >
...
<persistenceAdapter>
<levelDB directory="数据存储目录"/>
</persistenceAdapter>
...
</broker>
8 ActiveMQ网络连接支持
Broker的网络配置主要有三种配置方法,分别是静态配置、动态配置和主从配置。
8.1 静态配置
静态传输提供了一种硬编码机制,可以使用URI列表发现其他连接。使用此发现机制的连接将尝试连接到列表中的所有URI,直到成功为止。
在activemq.xml配置文件中配置。
<networkConnectors>
<networkConnector uri="static:(tcp://localhoat:61616)"/>
</networkConnectors>
配置语法
static:(uri1,uri2,uri3,…)?options
举例
static:(tcp://localhost:61616,tcp://remotehost:61617?trace=false,vm://localbroker)?initialReconnectDelay=100
uri的属性说明
8.2 动态配置
在activemq.xml配置文件中配置。
<networkConnectors>
<networkConnector uri="multicast://default"/>
</networkConnectors>
8.3 主从配置
Master-Slave模型是非常常见的,主从模型主要是为了防止一个网络节点出现问题而提出的,提高了稳定性。
在ActiveMQ中也是可配置的,我们可以在activemq.xml配置文件中进行相关配置。
<networkConnectors>
<networkConnector uri="masterslave:(tcp://host1:61616,tcp://host2:61616,tcp://..)"/>
</networkConnectors>
注意:Master-Slave方式的第一个url需要是master,其他是slave。
另外,NetworkConnector 节点还有其他属性可以配置,具体详情可以查看官网:https://activemq.apache.org/networks-of-brokers。
8.4 容错的客户端连接方法
在前面的客户端连接ActiveMQ的时候只是使用一个简单的url进行连接。
ActiveMQConnectionFactory activeMQConnectionFactory
= new ActiveMQConnectionFactory("tcp://localhost:61616");
但是,这种方式会出现一个问题,一旦这台ActiveMQ宕机了,就连接不上了,所以,有另外一种容错的方式,当一台出现宕机,可以连接上其他的机器,这样就不会出现问题了。
ActiveMQConnectionFactory activeMQConnectionFactory
= new ActiveMQConnectionFactory("failover:(tcp://localhost:61616,tcp://remotehost:61616)");
其他属性参数请参考:https://activemq.apache.org/failover-transport-reference。