Spring 对 JMS的支持
Spring 对 JMS 的支持
Srping 在 org.springframework.jsm 包中提供了一个用于简化 JMS API 的使用的抽象框架 , 并对用户屏蔽了 JMS1.1 与 JMS1.02 之间的差别
Spring JMS API
org.springframework.jms.core JMS 模板类 执行公共操作 使用接口回调 发送接收消息
org.springframework.jms 为 JMS 提供的运行期异常体系
org.springframework.jms.support 提供异常转化器 , 将 JMS 检查异常映射到该异常体系
org.springframework.jsm.support.conver 消息转化器 , 以便将 POJO 转化为 JMS 消息 , 提供 MDP 的功能
org.springframework.jms.listener 消息监听器容器 , 提供了异步消息接收的支持
org.springframework.jsm.support.destination 提供地址解析的功能 , 允许用户使用字符串的形式指定消息发送或接收地址 , 地址解析器负责地址的解析
org.springframework.jms.connection 提供一个 ConnectionFactory 的实现 , 还为 JMS 提供了一个 Spring 的 PlatformTransactionManager 的实现 ,JmsTaransactionManager , 这样 JMS 作为一个事务资源无缝集成到 Spring 的事务管理机制中
JMS 模板类
JMSTemplate 的使用情况对于两种消息域类型是一致的
JMSTemplate102
JMSTemplate102 通过指定 pubSubDomain 属性指定消息类型 true Pub/Sub
<bean id=”jsmTempalte” class=”org.springframewrok.jms.core.JmsTempalte”>
<property name=”pubSubDomain” value=”true”/>
</bean>
JmsTemplate102 的 ConnectionFactory 类型必须 JMSTemplate 的消息类型一致
如果 JmsTempalte 的消息类型为 pubSubDomain=true, 则 ConnectionFactory 必须是
javax.jms.TopicConnectionFactory, 如果是 false, 就使用 javax.jms.QueueConnectionFactory
因为 PooledConnectionFactory 只实现的 ConnectionFactory 接口 , 所以最好的办法是使用
ActiveMQConnectionFactory, 因为它同时实现了 ConnectionFactory,TopicConnectionFactory,
QueueConnectionFactory 接口 , 或者使用 JNDI 中的 ConnectionFactory , 开发中尽量使用后者
JmsTemplate 的支持类 org.springframework.jms.core.JmsGatewaySupport , 只要向该类注入一个
ConnectionFactory , 它会自动创建 JmsTempalte 实例
JMS 的异常映射
JMS 检查型异常转为运行时异常
Org.srpingframework.jms 包中的异常为 javax.jms 异常提供了类型转转换的镜像实现 ,Spring 中的 JMS 异常都继承于 JmsException
除此之外 ,Spring 还提供了一些特定的 JMS 异常
DestinationResolutionException 在 DestinationResolver 解析消息地址是发生错误抛出的异常
SynchedLocalTransactionFailedExcetion 在同步本地事务发生异常抛出的异常 , 事务结束再次同步就会有这样的异常抛出
UncategorizedJmsException 所有归类的异常
JMS 声明事务时可以在事务控制策略中使用这些异常
使用回调接口发送 / 接收消息
MessageSender.java
package cn.com.snt.spring_jms;
import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.Session;
import org.springframework.jms.core.MessageCreator;
import org.springframework.jms.core.support.JmsGatewaySupport;
public class MessageSender extends JmsGatewaySupport {
public void sendTextMsg( final String textMsg){
getJmsTemplate().send( new MessageCreator(){
public Message createMessage(Session session) throws JMSException {
return session.createTextMessage(textMsg);
}
});
}
}
applicationContext-sender.xml
<? xml version = "1.0" ?>
< 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" >
< bean id = "connectionFactory" class = "org.apache.activemq.pool.PooledConnectionFactory" >
< property name = "connectionFactory" >
< bean class = "org.apache.activemq.ActiveMQConnectionFactory" >
< property name = "brokerURL" value = "tcp://localhost:61616" />
</ bean >
</ property >
</ bean >
< bean id = "dest" class = "org.apache.activemq.command.ActiveMQQueue" >
< constructor-arg value = "myDest" />
</ bean >
< bean id = "jmsTemplate" class = "org.springframework.jms.core.JmsTemplate" >
< property name = "connectionFactory" ref = "connectionFactory" />
< property name = "defaultDestination" ref = "dest" />
</ bean >
< bean id = "messageSender" class = "cn.com.snt.spring_jms.MessageSender" >
< property name = "jmsTemplate" ref = "jmsTemplate" />
</ bean >
</ beans >
MessageReceiver.java
package cn.com.snt.spring_jms;
import javax.jms.JMSException;
import javax.jms.TextMessage;
import org.springframework.jms.core.support.JmsGatewaySupport;
public class MessageReceiver extends JmsGatewaySupport {
public void receiveTextMsg(){
TextMessage textMsg=(TextMessage)getJmsTemplate().receive();
try {
System. out .println( "msgid:" +textMsg.getJMSMessageID());
System. out .println( "msg:" +textMsg.getText());
} catch (JMSException e){
e.printStackTrace();
}
}
}
applicationContext-receiver.xml
<? xml version = "1.0" ?>
< 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" >
< bean id = "connectionFactory"
class = "org.apache.activemq.pool.PooledConnectionFactory" >
< property name = "connectionFactory" >
< bean
class = "org.apache.activemq.ActiveMQConnectionFactory" >
< property name = "brokerURL"
value = "tcp://localhost:61616" />
</ bean >
</ property >
</ bean >
< bean id = "dest" class = "org.apache.activemq.command.ActiveMQQueue" >
< constructor-arg value = "myDest" />
</ bean >
< bean id = "jmsTemplate"
class = "org.springframework.jms.core.JmsTemplate" >
< property name = "connectionFactory" ref = "connectionFactory" />
< property name = "defaultDestination" ref = "dest" />
</ bean >
< bean id = "messageReceiver" class = "cn.com.snt.spring_jms.MessageReceiver" >
< property name = "jmsTemplate" ref = "jmsTemplate" />
</ bean >
</ beans >
JmsTemplate send 方法有三种重载
send(MessageCreator messageCreator) 使用该方法一定要通过 defaultDestination 或
defaultDestinationName 指定默认地址 , 否则会报异常
send(Destination dest,MessageCreator messageCreator) 发送消息到指定目的地址
send(String destinationName,String messageSelector ) 将消息发送到 DestinationResolver 解析 destinationName 得到的真实地址 , 默认采用 DynamicDestinationResolver 解析地址
DestinationResoler 接口只有一个方法
Destination resolveDestinationName(Session session,String destintaionName,boolean pubSubDomain)
pubSubDomain=true 解析为 Topic , 否则解析为 Queue