作者：cctvx1，江南白衣

本文来自springside wiki，请留意wiki上的更新。

1.概述

1.1 jms和activemq特性  

   jms始终在javaee五花八门的协议里，webservice满天飞的时候占一位置，是因为他能够：

• 能够把不影响用户执行结果又比较耗时的任务（比如发邮件通知管理员）异步的扔给jms 服务端，而尽快的把屏幕返还给用户，且服务端能够多线程排队响应高并发的请求。
• 能够在java世界里达到最高的解耦。客户端和服务端无需直连，甚至无需知晓对方是谁、在哪里、有多少人，只要对流过的信息作响应就行了，在企业应用环境复杂时作用明显。

    activemq 的特性：

• 完全支持jms1.1和j2ee 1.4规范的 jms provider实现，也是apache geronimo默认的jms provider。
• pojo withdout ejb container，无需实现ejb繁琐复杂的message bean接口和配置。
• spring base，能够使用spring的各种特性如ioc、aop 。
• effective，基于jencks的jca container实现 pool connection，control transactions and manage security。 

1.2 springside 的完全pojo的jms方案   

  springside在bookstore示例中，演示了用户下订单时，将发通知信到用户邮箱的动作，通过jms交给jms服务端异步完成，避免了邮件服务器的堵塞而影响用户的下订。

  全部代码于examples＼bookstore＼src＼java＼org＼springside＼bookstore＼components＼activemq 目录中。

  一个jms场景通常需要三者参和：

• 一个pojo的的message producer，负责使用spring的jms template发送消息。
• 一个message converter，负责把java对象如订单(order)转化为消息，使得producer能够直接发送pojo。
• 一个mdp message consumer，负责接收并处理消息。

  springside 2.0采用了activemq 4.1-incubator-snapshot 和spring 2.0 集成，比ss 1.0m3版本有三个值得留意的特点，使得代码中几乎不见一丝jms的侵入代码：

1. 采用spring2.0的schema式简化配置。
2. 实现message converter转化消息和对象，使得producer能够直接发送pojo而不是jms message。
3. 使用了spring的defaultmessagelistenercontainer和messagelisteneradapter，消息接收者不用实现messagelistener 接口。

2.引入activemq的xsd

  activemq4.1 响应spring 2.0号召，支持了引入xml schema namespace的简单配置语法，简化了配置的语句。 

  在applicationcontext.xml(spring的配置文档)中引入activemq的xml scheam 配置文档),如下:

<beans
  xmlns="http://www.springframework.org/schema/beans"
  xmlns:amq="http://activemq.org/config/1.0"
  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.xsd
  http://activemq.org/config/1.0 http://people.apache.org/repository/org.apache.activemq/xsds/activemq-core-4.1-incubator-snapshot.xsd">

由于activemq的那个xsd有部分错误,因此使用的是自行修改过的xsd,配置classpath中的schema.

在classpath 下面建立meta-inf＼spring.schemas 内容如下。这个spring.schemas是spring自定义scheam的配置文档,请注意"http:＼://"部分写法

http＼://people.apache.org/repository/org.apache.activemq/xsds/activemq-core-4.1-incubator-snapshot.xsd=/activemq-core-4.1-incubator-snapshot.xsd

3. 配置方案

3.1 基础零件 

1. 配置activemq broker  

   暂时采用在jvm中嵌入这种最简单的模式，  当spring初始化时候，activemq embedded broker 就会启动了。

 <amq:broker usejmx="false" persistent="false">
      <amq:transportconnectors>
　　　　        <amq:transportconnector uri="tcp://localhost:0"/>
　    amq:transportconnectors>
　amq:broker>

 

2. 配置(a)connectionfactory

  由于前面配置的broker是jvm embedded 所以url为:vm://localhost

 <amq:connectionfactory id="jmsconnectionfactory" brokerurl="vm://localhost"/>

3 配置(b)queue

 <amq:queue name="destination" physicalname="org.apache.activemq.spring.test.spring.embedded"/> 

 

4. 配置(c)converter

   配置conveter，使得producer能够直接发送order对象，而不是jms的message对象。

 <bean id="ordermessageconverter" class="org.springside.bookstore.components.activemq.ordermessageconverter"/>  

 

3.2  发送端 

1 配置jmstemplate

   spring提供的template，绑定了(a)connectionfactory和(c)converter。

 <bean id="jmstemplate" class="org.springframework.jms.core.jmstemplate">
  <property name="connectionfactory">
   
   <bean class="org.springframework.jms.connection.singleconnectionfactory">
    <property name="targetconnectionfactory" ref="jmsconnectionfactory"/>
   bean>
  property>
  
  <property name="messageconverter" ref="ordermessageconverter"/>
 bean>

 

2.producer

   消息发送者，使用jmstemplate发送消息，绑定了jmstemplate(含a、c 和(b)queue。

 <bean id="ordermessageproducer" class="org.springside.bookstore.components.activemq.ordermessageproducer">
  <property name="template" ref="jmstemplate"/>
  <property name="destination" ref="destination"/>
 bean>

 

 

3.3 接收端

  1.接收处理者(mdp)

    使用spring的messagelisteneradapter，指定负责处理消息的pojo及其方法名，绑定(c)converter。

 

  
 <bean id="messagelistener" class="org.springframework.jms.listener.adapter.messagelisteneradapter">
  <constructor-arg>
   <bean class="org.springside.bookstore.components.activemq.ordermessageconsumer">
    <property name="mailservice" ref="mailservice"/>
   bean>
  constructor-arg>
  
  <property name="defaultlistenermethod" value="sendemail"/>
  
  <property name="messageconverter" ref="ordermessageconverter"/>
 bean> 

 

2. listenercontainer

    负责调度mdp， 绑定(a) connectionfactory, (b)queue和接收处理者(mdp)。

 

 <bean id="listenercontainer" class="org.springframework.jms.listener.defaultmessagelistenercontainer">
  <property name="connectionfactory" ref="jmsconnectionfactory"/>
  <property name="destination" ref="destination"/>
  <property name="messagelistener" ref="messagelistener"/>
 bean>

 

 

  互相绑定的关系有点晕，发送端和接收端都以不同形式绑定了(a) connectionfactory, (b)queue和 (c)converter.