学习jms（一）——基本实例

Java Message Service是java ee的规范之一，可以用来发送异步消息，在某些场景下，可以作为不同系统，或者不同模块之间的集成方式。

可以类比为通过数据库来集成的方式，模块A完成逻辑以后，往数据库插入一条记录，模块B定时轮询数据库，如果查到相应的记录，就进行处理。jms集成实际上思路是差不多的，只是功能更强，并且提供了标准的API支持，而且也可以避免反复轮询数据库或者读取文件的I/O操作，对系统的整体性能可能会有提升

其主要优点，首先是可以使2个系统或模块实现松耦合，模块A不需要直接调用模块B，只需要往jms provider上发送一条约定格式的消息，模块B收到这条消息，进行后续的业务处理

其次，jms方式是异步的，意味着模块A发送消息之后，不需要等待模块B或者jms provider的响应，自身的业务逻辑可以继续

jms技术对应的规范是jsr914，规范的实现称为jms provider，常见的实现有ActiveMQ、JBoss MQ、IBM Websphere MQ等。本文以ActiveMQ举例

一、ActiveMQ使用

ActiveMQ（其他的jms provider也差不多）安装之后，目录结构是这样的：



运行bin目录下的activemq.bat，会根据默认配置，启动一个broker。各种jms实现，好像都有broker的概念

启动之后，会占用至少2个端口，默认的是61616和8161

61616是等待jms client的连接，8161是ActiveMQ自带的一个web应用

http://localhost:8161/demo，可以看到各种官方提供的例子

http://localhost:8161/admin，是ActiveMQ的管理控制台



这里可以对队列进行各种操作，比如发送消息，查看消息，清空队列等等

ActiveMQ即使在不编程的情况下，也可以通过这种方式来使用，包括我之前的公司，是用Websphere MQ，有时也不编程，直接通过Websphere MQ，在两地进行消息传输。当然，大部分情况，还是需要针对jms client进行编程的

二、jms基本概念

前面说过，jms的实现，称为jms provider，可以认为是jms的服务器

jms的客户端，需要开发人员自行开发，称为jms client

jms的消息机制有2种模型，一种是Point to Point，表现为队列的形式。发送的消息，只能被一个接收者取走

另一种是Topic，可以被多个订阅者订阅，类似于群发



ConnectionFactory，用于jms client获取与jms provider的连接。不同的jms产品，对这个接口有不同的实现，比如说ActiveMQ，这个接口的实现类是ActiveMQConnectionFactory

Connection，是由ConnectionFactory产生的，表示jms client与jms provider的连接

Session，是由Connection产生的，表示一个会话。Session是关键组件，Message、Producer/Consumer、Destination都是在Session上创建的

Message，这个组件很好理解，就是传输的消息，里面包括head、properties、body，其中head是必选的

Destination，是消息源，对发送者来说，就是消息发到哪里；对接收者来说，就是从哪里取消息。Destination有2个子接口，Queue和Topic，分别对应上面提到的2种模型

Message Producer，是消息发送者，创建这个组件的代码类似：

Java代码  

1. Destination dest = session.createQueue("dotaQueue");// 消息目的地   
2.   
3.         MessageProducer producer = session.createProducer(dest);// 消息发送者  

Destination dest = session.createQueue("dotaQueue");// 消息目的地

		MessageProducer producer = session.createProducer(dest);// 消息发送者

可以注意到，这里需要把Destination作为参数，传入createProducer()方法，这说明消息发送者是绑定到Destination上的，这个发送者发送的消息，会发送到这个绑定的Destination上

Message Consumer，是消息接收者，和Message Producer是相反的一种组件

三、代码实例

这里是基于ActiveMQ进行开发，所以需要导入ActiveMQ提供的jar包。不过开发时，应该尽量针对jms接口进行开发，不依赖特定的实现

例子是用main函数跑的，没有在java ee容器里跑，所以没有办法依赖JNDI拿到ConnectionFactory的实例，只能手工创建ActiveMQConnectionFactory，所以和ActiveMQ的实现耦合了，没有办法连到别的jms实现上。如果实际的代码，用JNDI或者spring来获取ConnectionFactory的实例的话，那就可以仅针对接口编程，连接到任意jms provider了

为了简单起见，例子也没有用到spring，实际上spring对jms client提供了很好的支持，在后面再介绍

开发环境只要导入activemq-all-5.6.0.jar就可以了



里面已经包括了jms API、activemq-core、javaee-management API等必须的class

首先是Message Producer的例子：

Java代码  

1. public class Main {   
2.   
3.     public static void main(String[] args) throws JMSException {   
4.   
5.         String jmsProviderAddress = "tcp://localhost:61616";// 地址   
6.   
7.         ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(   
8.                 jmsProviderAddress);// 连接器   
9.   
10.         Connection connection = connectionFactory.createConnection();// 创建连接   
11.   
12.         Session session = connection.createSession(false,   
13.                 Session.AUTO_ACKNOWLEDGE);// 打开会话   
14.   
15.         Destination dest = session.createQueue("demoQueue");// 消息目的地   
16.   
17.         MessageProducer producer = session.createProducer(dest);// 消息发送者   
18.   
19.         Message message = session.createTextMessage("hello world");// 消息   
20.   
21.         producer.send(message);// 发送   
22.   
23.         producer.close();// 关闭   
24.         session.close();   
25.         connection.close();   
26.   
27.     }   
28.   
29. }  

public class Main {

	public static void main(String[] args) throws JMSException {

		String jmsProviderAddress = "tcp://localhost:61616";// 地址

		ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(
				jmsProviderAddress);// 连接器

		Connection connection = connectionFactory.createConnection();// 创建连接

		Session session = connection.createSession(false,
				Session.AUTO_ACKNOWLEDGE);// 打开会话

		Destination dest = session.createQueue("demoQueue");// 消息目的地

		MessageProducer producer = session.createProducer(dest);// 消息发送者

		Message message = session.createTextMessage("hello world");// 消息

		producer.send(message);// 发送

		producer.close();// 关闭
		session.close();
		connection.close();

	}

}

代码很简单，可以参考上面的图，各组件的关系是比较清楚的

然后是Message Consumer的例子：

Java代码  

1. public static void main(String[] args) throws JMSException {   
2.   
3.         String jmsProviderAddress = "tcp://localhost:61616";// 地址   
4.   
5.         ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(   
6.                 jmsProviderAddress);// 连接器   
7.   
8.         Connection connection = connectionFactory.createConnection();// 创建连接   
9.   
10.         Session session = connection.createSession(false,   
11.                 Session.AUTO_ACKNOWLEDGE);// 打开会话   
12.   
13.         String destinationName = "demoQueue";   
14.   
15.         Destination dest = session.createQueue(destinationName);// 消息目的地   
16.   
17.         MessageConsumer consumer = session.createConsumer(dest);   
18.   
19.         connection.start();   
20.   
21.         Message message = consumer.receive();   
22.   
23.         TextMessage textMessage = (TextMessage) message;   
24.   
25.         String text = textMessage.getText();   
26.   
27.         System.out.println("从ActiveMQ取回一条消息: " + text);   
28.   
29.         consumer.close();   
30.         session.close();   
31.         connection.close();   
32.   
33.     }  

public static void main(String[] args) throws JMSException {

		String jmsProviderAddress = "tcp://localhost:61616";// 地址

		ConnectionFactory connectionFactory = new ActiveMQConnectionFactory(
				jmsProviderAddress);// 连接器

		Connection connection = connectionFactory.createConnection();// 创建连接

		Session session = connection.createSession(false,
				Session.AUTO_ACKNOWLEDGE);// 打开会话

		String destinationName = "demoQueue";

		Destination dest = session.createQueue(destinationName);// 消息目的地

		MessageConsumer consumer = session.createConsumer(dest);

		connection.start();

		Message message = consumer.receive();

		TextMessage textMessage = (TextMessage) message;

		String text = textMessage.getText();

		System.out.println("从ActiveMQ取回一条消息: " + text);

		consumer.close();
		session.close();
		connection.close();

	}

和MessageProducer的代码基本类似，实际中一般会实现javax.jms.MessageListener接口，这样就不需要手工调用receive()方法
JMS提供了QueueRequestor,这是一个能发送请求和接收应答的简单类。请求者包含一个QueueSender来发送请求，并且利用一个QueueReceiver接收应答。每个请求者会创建自己的临时队列以接收应答，并把该队列的地址设置在请求消息的reply-to属性中。请示者发送和接收应答的代码非常简单：
QueueConnection connection=//获得连接
Queue requestQueue=//获得队列
Message request=//创建请求消息
QueueSession session=connection.CreateQueueSession(false,Session.AUTO_ACKNOWLEDGE);
QueueRequestor requestor=new QueueRequestor(session,requestQueue);
Message reply=requestor.request(request);

request方法负责发送请求消息，这个方法会阻塞，直到接收应答消息为止。
QueueRequestor使用的TemporaryQueue是一个点对点通道。相应的发布-订购通道是TemporaryTopic和TopicRequestor