Spring + ActiveMQ实现jms发送消息

1. 概述：Spring提供了一个用于简化JMS API使用的抽象框架，并且对用户屏蔽了JMS API中1.0.2和1.1版本的差异。
JMS的功能大致上分为两块，叫做消息制造和消息消耗。JmsTemplate 用于制造消息和同步消息接收。我们今天就用JmsTemplate实现同步的消息接受。
使用JMS发(接)消息的步骤：
  1)创建连接工厂
  2)使用连接工厂创建连接
  3)使用连接创建会话
  4)获取一个目的地
  5)使用会话和目的地创建消息生产者(消息消费者)
  6)使用连接创建一个需要发送的消息类型实例
  7)使用连接的一个队列发送器或主题公布器,使用发送器或者主题器发送消息(接受消息)

spring中的JmsTemplate实现了对jms的一些封装,内部提供了很多的方法，我们只需要实现定义的回调接口即可。JmsTemplate继承自JmsAccessor,在JmsAccessor中有ConnectionFactory的定义，而JmsTemplate本身的构造方法也有对ConnectionFactory的封装：

public JmsTemplate(ConnectionFactory connectionFactory) {
        this();
        setConnectionFactory(connectionFactory);
        afterPropertiesSet();
}

public JmsTemplate(ConnectionFactory connectionFactory) {
		this();
		setConnectionFactory(connectionFactory);
		afterPropertiesSet();
}

所以，我们有两种方式注入ConnectionFactory,本文我们采用构造方法的方式。

spring_jms.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"
    xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">

<!-- 这里我们用构造方法注入 connectionFactory-->
<bean id = "jmsTemplate" class = "org.springframework.jms.core.JmsTemplate">
    <constructor-arg ref="connectionFactory"></constructor-arg>
</bean>

<!-- 使用activemq中的连接工厂,提供一个brokerUrl,这里表示本地 -->
<bean id = "connectionFactory" class = "org.apache.activemq.ActiveMQConnectionFactory">
    <property name="brokerURL" value="vm://localhost" />
</bean>

<!-- 使用activemq中的点对点消息模型,随意指定一个地址 -->
<bean id="destination" class="org.apache.activemq.command.ActiveMQQueue">
        <constructor-arg value="test/queue"/>
</bean>

</beans>

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd">
		
<!-- 这里我们用构造方法注入 connectionFactory-->	
<bean id = "jmsTemplate" class = "org.springframework.jms.core.JmsTemplate">
	<constructor-arg ref="connectionFactory"></constructor-arg>
</bean>

<!-- 使用activemq中的连接工厂,提供一个brokerUrl,这里表示本地 -->
<bean id = "connectionFactory" class = "org.apache.activemq.ActiveMQConnectionFactory">
	<property name="brokerURL" value="vm://localhost" />
</bean>

<!-- 使用activemq中的点对点消息模型,随意指定一个地址 -->
<bean id="destination" class="org.apache.activemq.command.ActiveMQQueue">
        <constructor-arg value="test/queue"/> 
</bean>

</beans>

MessageCreator 回调接口通过JmsTemplate中调用代码提供的Session来创建一条消息。
看一下MessageCreator接口：

public interface MessageCreator {

    Message createMessage(Session session) throws JMSException;

}

public interface MessageCreator {

	Message createMessage(Session session) throws JMSException;

} 

那么，我们来实现发送和接受消息DummyJms类

public class DummyJms {

    public static void main(String[] args) throws Exception{
        ApplicationContext context = new ClassPathXmlApplicationContext("spring.xml");
        JmsTemplate jmsTemplate = (JmsTemplate)context.getBean("jmsTemplate");
        Destination destination = (Destination)context.getBean("destination");

        jmsTemplate.send(destination, new MessageCreator(){

                public Message createMessage(Session session)
                        throws JMSException {
                    return session.createTextMessage("send message ");
                }


        });

        TextMessage msg = (TextMessage)jmsTemplate.receive(destination);
        System.out.println("receive message = " + msg.getText());

    }

}

public class DummyJms {
	
	public static void main(String[] args) throws Exception{
		ApplicationContext context = new ClassPathXmlApplicationContext("spring.xml");
		JmsTemplate jmsTemplate = (JmsTemplate)context.getBean("jmsTemplate");
		Destination destination = (Destination)context.getBean("destination");
		
		jmsTemplate.send(destination, new MessageCreator(){
				
				public Message createMessage(Session session)
						throws JMSException {
					return session.createTextMessage("send message ");
				}
				
			
		});
		
		TextMessage msg = (TextMessage)jmsTemplate.receive(destination);
		System.out.println("receive message = " + msg.getText());
		
	}
	
}

输出结果：
receive message = send message


可是我们并没有看到的像前文描述的那那些创建消息生产者，消息消费者的一些东西。继续分析，我们可以看一下，
jmsTemplate.send(Destination destination,MessageCreator messageCreator)这里到底做了什么，可以让我们不费吹灰之力，就可以实现消息的发送。JmsTemplate源代码：

public void send(final Destination destination, final MessageCreator messageCreator) throws JmsException {
        execute(new SessionCallback<Object>() {
            public Object doInJms(Session session) throws JMSException {
                doSend(session, destination, messageCreator);
                return null;
            }
        }, false);
}

public void send(final Destination destination, final MessageCreator messageCreator) throws JmsException {
		execute(new SessionCallback<Object>() {
			public Object doInJms(Session session) throws JMSException {
				doSend(session, destination, messageCreator);
				return null;
			}
		}, false);
}

JmsTemplate实现了JmsOperations接口,在JmsOperations里有

<T> T execute(SessionCallback<T> action) throws JmsException;

<T> T execute(SessionCallback<T> action) throws JmsException;

的定义。

那么这个SessionCallback接口是什么呢？它也为用户提供了JMS session。

    T doInJms(Session session) throws JMSException;

}

public interface SessionCallback<T> {

	T doInJms(Session session) throws JMSException;

}

继续往下看。doSend方法：

            throws JMSException {

        Assert.notNull(messageCreator, "MessageCreator must not be null");
        MessageProducer producer = createProducer(session, destination);
        try {
            Message message = messageCreator.createMessage(session);
            if (logger.isDebugEnabled()) {
                logger.debug("Sending created message: " + message);
            }
            doSend(producer, message);
            // Check commit - avoid commit call within a JTA transaction.
            if (session.getTransacted() && isSessionLocallyTransacted(session)) {
                // Transacted session created by this template -> commit.
                JmsUtils.commitIfNecessary(session);
            }
        }
        finally {
            JmsUtils.closeMessageProducer(producer);
        }
    }

protected void doSend(Session session, Destination destination, MessageCreator messageCreator)
			throws JMSException {

		Assert.notNull(messageCreator, "MessageCreator must not be null");
		MessageProducer producer = createProducer(session, destination);
		try {
			Message message = messageCreator.createMessage(session);
			if (logger.isDebugEnabled()) {
				logger.debug("Sending created message: " + message);
			}
			doSend(producer, message);
			// Check commit - avoid commit call within a JTA transaction.
			if (session.getTransacted() && isSessionLocallyTransacted(session)) {
				// Transacted session created by this template -> commit.
				JmsUtils.commitIfNecessary(session);
			}
		}
		finally {
			JmsUtils.closeMessageProducer(producer);
		}
	}

createProducer()方法又调用了doCreateProducer(),实际的消息生产者在这里。

        return session.createProducer(destination);
    }

protected MessageProducer doCreateProducer(Session session, Destination destination) throws JMSException {
		return session.createProducer(destination);
	}

在这里，我们看到了，spring创建了消息的发送者，关闭连接的一些操作。到这里，大家就明白了，spring内部处理Jms消息的过程了吧(消息的接受也是一样)。
注：本文使用spring3.0和activemq5.2版本。