程序博客网 > 圈点软件下载

Spring JMS

来源：互联网 发布：圈点软件下载 编辑：程序博客网 时间：2024/04/20 23:09

1 DestinationResolver
    DestinationResolver接口的作用是将指定的目的地名解析为目的地实例。其定义如下：

Java代码
  1. public interface DestinationResolver {  
  2.     Destination resolveDestinationName(Session session, String destinationName,   
  3.         boolean pubSubDomain) throws JMSException;  
  4. }  

    参数pubSubDomain用于指定是使用“发布/订阅”模式（解析后的目的地是Topic），还是使用“点对点”模式（解析后的目的地是Queue）。

 

    CachingDestinationResolver接口继承了DestinationResolver，增加了缓存的功能，其接口定义如下：

Java代码
  1. public interface CachingDestinationResolver extends DestinationResolver {  
  2.     void removeFromCache(String destinationName);  
  3.     void clearCache();  
  4. }  

    在目的地失效的时候，removeFromCache方法会被调用；在JMS provider失效的时候，clearCache方法会被调用。

1.1 DynamicDestinationResolver
    DynamicDestinationResolver实现了DestinationResolver接口。根据指定的目的地名，DynamicDestinationResolver会动态创建目的地实例。针对JMS1.1规范，它采用如下方法创建目的地：

Java代码
  1. session.createTopic(topicName)  
  2. session.createQueue(queueName);  


1.2 JndiDestinationResolver
    JndiDestinationResolver继承自JndiLocatorSupport，同时实现了CachingDestinationResolver接口。如果在JMSprovider中配置了静态目的地，那么JndiDestinationResolver通过JNDI查找的方式获得目的地实例。


   JndiDestinationResolver的fallbackToDynamicDestination属性用于指定在JNDI查找失败后，是否使用动态目的地，默认值是false。JndiDestinationResolver的cache属性用于指定是否对目的地实例进行缓存，默认值是true。

 

1.3 BeanFactoryDestinationResolver
    BeanFactoryDestinationResolver实现了DestinationResolver接口和BeanFactoryAware接口。它会根据指定的目的地名从BeanFactory中查找目的地实例。以下是相关的代码：

Java代码
  1. public Destination resolveDestinationName(Session session, String destinationName,   
  2. boolean pubSubDomain) throws JMSException {  
  3.     Assert.state(this.beanFactory != null, "BeanFactory is required");  
  4.     try {  
  5.         return (Destination) this.beanFactory.getBean(destinationName, Destination.class);  
  6.     }  
  7.     catch (BeansException ex) {  
  8.         throw new DestinationResolutionException(  
  9.             "Failed to look up Destinaton bean with name '" + destinationName + "'", ex);  
  10.     }  
  11. }  

 

2 JmsAccessor
    抽象类JmsAccessor是JmsTemplate、SimpleMessageListenerContainer和DefaultMessageListenerContainer等concrete class的基类。JmsAccessor定义了如下几个用于访问JMS服务的共通属性。

Java代码
  1. private ConnectionFactory connectionFactory;  
  2. private boolean sessionTransacted = false;  
  3. private int sessionAcknowledgeMode = Session.AUTO_ACKNOWLEDGE;  


    JmsAccessor提供了创建Connection和Session的方法，如下：

Java代码
  1. protected Connection createConnection() throws JMSException {  
  2.     return getConnectionFactory().createConnection();  
  3. }  
  4.   
  5. protected Session createSession(Connection con) throws JMSException {  
  6.     return con.createSession(isSessionTransacted(), getSessionAcknowledgeMode());  
  7. }  

 
2.1 JmsDestinationAccessor
   抽象类JmsDestinationAccessor继承自JmsAccessor，增加了destinationResolver和pubSubDomain属性。destinationResolver的默认值是DynamicDestinationResolver的实例，也就是说默认采用动态目的地解析的方式；pubSubDomain用于指定是使用“发布/订阅”模式还是使用“点对点”模式，默认值是false。

    JmsDestinationAccessor提供了用于解析目的地的方法，如下：

Java代码
  1. protected Destination resolveDestinationName(Session session, String destinationName)   
  2. throws JMSException {  
  3.     return getDestinationResolver().resolveDestinationName(session, destinationName,   
  4.         isPubSubDomain());  
  5. }  


2.2 AbstractJmsListeningContainer
    AbstractJmsListeningContainer继承自JmsDestinationAccessor，作为所有MessageListener Container的公共基类。它主要提供了JMSconnection的生命周期管理的功能，但是没有对消息接收的方式（主动接收方式或者异步接收方式）等做任何假定。该类主要的属性如下：

Java代码
  1. private String clientId;  
  2. private Connection sharedConnection;  

    clientId通常用于持久订阅；sharedConnection保存了被共享的JMS connection。

 

    该类定义了如下的抽象方法，以便子类可以决定是否使用共享的JMS connection。

Java代码
  1. protected abstract boolean sharedConnectionEnabled();  

 

2.3 AbstractMessageListenerContainer
    AbstractMessageListenerContainer继承自AbstractJmsListeningContainer，也是作为所有Message Listener Container的公共基类。该类主要的属性如下：

Java代码
  1. private volatile Object destination;  
  2. private volatile Object messageListener;  
  3. private boolean exposeListenerSession = true;  

    destination用于指定接收消息的目的地。
    messageListener用于指定处理消息的listener。对于messageListener，它既可以是符合JMS规范的javax.jms.MessageListener，也可以是Spring特有的org.springframework.jms.listener.SessionAwareMessageListener。SessionAwareMessageListener的定义如下：

Java代码
  1. public interface SessionAwareMessageListener {  
  2.     void onMessage(Message message, Session session) throws JMSException;  
  3. }  

    跟javax.jms.MessageListener相比，这个接口的onMessage方法增加了一个Session 类型的参数，可以通过这个session发送回复消息（reply message）。


    如果使用了SessionAwareMessageListener 类型的messagelistener，那么exposeListenerSession参数指定了传入onMessage方法的session参数是否是创建了MessageConsumer的session，默认值是true。如果是false，那么AbstractMessageListenerContainer会在connection上新建一个session，并传入onMessage方法。

2.4 AbstractPollingMessageListenerContainer
    AbstractPollingMessageListenerContainer继承自AbstractMessageListenerContainer，它提供了对于主动接收消息(polling)的支持，以及支持外部的事务管理。

Java代码
  1. private boolean pubSubNoLocal = false;  
  2. private long receiveTimeout = DEFAULT_RECEIVE_TIMEOUT;  
  3. private PlatformTransactionManager transactionManager;  

    如果使用“发布/订阅”模式，那么pubSubNoLocal 属性指定通过某个连接发送到某个Topic的消息，是否应该被投递回这个连接。


    receiveTimeout属性用于指定调用MessageConsumer的receive方法时的超时时间，默认值是1秒。需要注意的是，这个值应该比transactionManager 中指定的事务超时时间略小。


   通常情况下，应该为transactionManager设置一个org.springframework.transaction.jta.JtaTransactionManager的实例，此外也要设置一个支持XA的ConnectionFactory。需要注意的是，XA 事务对性能有较大的影响。
    如果只是希望使用local JMStransaction，那么只要设置sessionTransacted为true或者使用JmsTransactionManager即可。实际上，如果设置了非JTA的transactionManager，那么sessionTransacted属性会自动被设置成true。
    由于local JMS transaction无法同其它local transaction（例如local databasetransaction）进行协调，因此客户端程序可能需要对重发的消息进行检查。JMS规范要求：JMSprovider应该将重发消息的JMSRedelivered属性设置为true。

2.5 SimpleMessageListenerContainer
   SimpleMessageListenerContainer继承自AbstractMessageListenerContainer，使用异步方式接收消息（也就是通过MessageConsumer上注册MessageListener的方式接收消息）。该类主要的属性如下：

Java代码
  1. private boolean pubSubNoLocal = false;  
  2. private int concurrentConsumers = 1;  
  3. private Set sessions;  
  4. private Set consumers;  
  5. private TaskExecutor taskExecutor;  

    如果使用“发布/订阅”模式，那么pubSubNoLocal 属性指定通过某个连接发送到某个Topic的消息，是否应该被投递回这个连接。

 

   SimpleMessageListenerContainer允许创建多个Session和MessageConsumer来接收消息。具体的个数由concurrentConsumers属性指定。需要注意的是，应该只是在Destination为Queue的时候才使用多个MessageConsumer（Queue中的一个消息只能被一个Consumer接收），虽然使用多个MessageConsumer会提高消息处理的性能，但是消息处理的顺序却得不到保证：消息被接收的顺序仍然是消息发送时的顺序，但是由于消息可能会被并发处理，因此消息处理的顺序可能和消息发送的顺序不同。此外，不应该在Destination为Topic的时候使用多个MessageConsumer，这是因为多个MessageConsumer会接收到同样的消息。

    SimpleMessageListenerContainer创建的Session和MessageConsumer分别保存在sessions和consumers属性中。


   taskExecutor属性的默认值是null，也就是说，对MessageListener（或者SessionAwareMessageListener）的回调是在MessageConsumer的内部线程中执行。如果指定了taskExecutor，那么回调是在TaskExecutor内部的线程中执行。以下是相关的代码：

Java代码
  1. protected MessageConsumer createListenerConsumer(final Session session)   
  2. throws JMSException {  
  3.     Destination destination = getDestination();  
  4.     if (destination == null) {  
  5.         destination = resolveDestinationName(session, getDestinationName());  
  6.     }  
  7.     MessageConsumer consumer = createConsumer(session, destination);  
  8.   
  9.     if (this.taskExecutor != null) {  
  10.         consumer.setMessageListener(new MessageListener() {  
  11.             public void onMessage(final Message message) {  
  12.                 taskExecutor.execute(new Runnable() {  
  13.                     public void run() {  
  14.                         processMessage(message, session);  
  15.                     }  
  16.                 });  
  17.             }  
  18.         });  
  19.     }  
  20.     else {  
  21.         consumer.setMessageListener(new MessageListener() {  
  22.             public void onMessage(Message message) {  
  23.                 processMessage(message, session);  
  24.             }  
  25.         });  
  26.     }  
  27.   
  28.     return consumer;  
  29. }  

   需要注意的是，如果指定了taskExecutor，那么消息在被taskExecutor内部的线程处理前，可能已经被确认过了（外层的onMessage方法可能已经执行结束了）。因此如果使用事务Session或者Session.CLIENT_ACKNOWLEDGE类型的确认模式，那么可能会导致问题。

 

   该类的sharedConnectionEnabled方法（在AbstractJmsListeningContainer中定义）总是返回true，因此SimpleMessageListenerContainer会使用共享的JMS connection。

2.6 DefaultMessageListenerContainer
    DefaultMessageListenerContainer继承自AbstractPollingMessageListenerContainer，主要使用同步的方式接收消息（也就是通过循环调用MessageConsumer.receive的方式接收消息）。该类主要的属性如下：

Java代码
  1. private int concurrentConsumers = 1;  
  2. private int maxConcurrentConsumers = 1;  
  3. private int maxMessagesPerTask = Integer.MIN_VALUE;  
  4. private int idleTaskExecutionLimit = 1;  
  5. private final Set scheduledInvokers = new HashSet();  
  6. private TaskExecutor taskExecutor;  
  7. private int cacheLevel = CACHE_AUTO;  

    跟SimpleMessageListenerContainer一样，DefaultMessageListenerContainer也支持创建多个Session和MessageConsumer来接收消息。跟SimpleMessageListenerContainer不同的是，DefaultMessageListenerContainer创建了concurrentConsumers所指定个数的AsyncMessageListenerInvoker（实现了SchedulingAwareRunnable接口），并交给taskExecutor运行。


   maxMessagesPerTask属性的默认值是Integer.MIN_VALUE，但是如果设置的taskExecutor（默认值是SimpleAsyncTaskExecutor）实现了SchedulingTaskExecutor接口并且其prefersShortLivedTasks方法返回true（也就是说该TaskExecutor倾向于短期任务），那么maxMessagesPerTask属性会自动被设置为10。
   如果maxMessagesPerTask属性的值小于0，那么AsyncMessageListenerInvoker.run方法会在循环中反复尝试接收消息，并在接收到消息后调用MessageListener（或者SessionAwareMessageListener）；如果maxMessagesPerTask属性的值不小于0，那么AsyncMessageListenerInvoker.run方法里最多会尝试接收消息maxMessagesPerTask次，每次接收消息的超时时间由其父类AbstractPollingMessageListenerContainer的receiveTimeout属性指定。如果在这些尝试中都没有接收到消息，那么AsyncMessageListenerInvoker的idleTaskExecutionCount属性会被累加。在run方法执行完毕前会对idleTaskExecutionCount进行检查，如果该值超过了DefaultMessageListenerContainer.idleTaskExecutionLimit（默认值1），那么这个AsyncMessageListenerInvoker可能会被销毁。


   所有AsyncMessageListenerInvoker实例都保存在scheduledInvokers中，实例的个数可以在concurrentConsumers和maxConcurrentConsumers之间浮动。跟SimpleMessageListenerContainer一样，应该只是在Destination为Queue的时候才使用多个AsyncMessageListenerInvoker实例。

 

    cacheLevel属性用于指定是否对JMS资源进行缓存，可选的值是CACHE_NONE =0、CACHE_CONNECTION = 1、CACHE_SESSION = 2、CACHE_CONSUMER = 3和CACHE_AUTO=4。默认情况下，如果transactionManager属性不为null，那么cacheLevel被自动设置为CACHE_NONE（不进行缓存），否则cacheLevel被自动设置为CACHE_CONSUMER。


    如果cacheLevel属性值大于等于CACHE_CONNECTION，那么sharedConnectionEnabled方法（在AbstractJmsListeningContainer中定义）返回true，也就是说使用共享的JMS连接。

 

 

3 SingleConnectionFactory
   SingleConnectionFactory实现了ConnectionFactory接口，其createConnection方法总是返回相同的Connection。可以在SingleConnectionFactory的构造函数中传入Connection对象或者ConnectionFactory对象，用来创建被代理的连接对象。SingleConnectionFactory.createConnection方法返回的连接是个代理，它忽略了对stop和close方法的调用（连接会在SingleConnectionFactory.destroy方法中关闭）。


    SingleConnectionFactory的reconnectOnException属性用来指定是否在连接抛出JMSException的时候，对连接进行重置，重置后如果再调用createConnection方法，那么会返回一个新的连接。


   需要注意的是，AbstractJmsListeningContainer类的抽象方法sharedConnectionEnabled指定了是否在message listener container内部使用共享的JMS连接。因此通常情况下不需要为单独的message listenercontainer设置SingleConnectionFactory（及其子类）；如果希望在不同的message listenercontainer之间共享JMS连接，那么可以考虑使用SingleConnectionFactory。

3.1 CachingConnectionFactory
    CachingConnectionFactory继承自SingleConnectionFactory，增加了对Session和MessageProducer缓存的功能。该类主要的属性如下：

Java代码
  1. private int sessionCacheSize = 1;  
  2. private boolean cacheProducers = true;  

    sessionCacheSize属性指定了被缓存的Session实例的个数（默认值是1），也就是说，如果同时请求的Session个数大于sessionCacheSize，那么这些Session不会被缓存，而是正常的被创建和销毁。


    cacheProducers属性指定了是否对MessageProducer进行缓存，默认值是true。

圈点软件下载 圈点软件下载
原创粉丝点击
热门IT博客
儿童摄影软件儿童摄影软件
python if returnpython if return
手机怎么投诉淘宝店家
淘宝网户外沙滩鞋
机器人用什么语言编程
mac客人用户密码
java代码隐晦的表白
软件实施方案
基于模型的聚类算法
linux系统怎么选择
淘宝里的店铺街在哪里
开机时windows未能启动
金瓯缺 知乎
淘宝上标品是什么意思
行知实践园手抄报
微软程序员面试题
优化设计历史必修一
店铺淘客软件
知乎男朋友不提前女友
淘宝的信用评价体系
热门问题 老师的惩罚 人脸识别 我在镇武司摸鱼那些年 重生之率土为王 我在大康的咸鱼生活 盘龙之生命进化 天生仙种 凡人之先天五行 春回大明朝 姑娘不必设防，我是瞎子 黄冈煲仔饭 黄冈职业技术学院 黄冈职业学院 黄冈师范学院教务系统 湖北黄冈女人不能要 黄冈科技职业学院 黄冈招商项目排行榜 黄冈市人力资源和社会保障局 黄冈小状元作业本六年级数学 黄冈中学广州学校 黄冈招商项目排行 黄冈邮政编码 黄冈市招商项目排行榜 黄冈代理项目排行 湖北黄冈邮编 黄冈未来30天天天预报 黄冈师范大学 黄冈周边旅游景点 黄冈招聘信息 黄冈房地产网 黄冈中专学校 黄冈招工信息 黄冈房地产信息网 黄冈教育信息网 黄冈旅游景点大全 黄冈在售楼盘 黄冈英语教学 宜春黄冈实验学校 黄冈中学网校怎么样 湖北黄冈人怎么样 黄冈有哪些旅游景点 黄冈中学网校网站 黄冈特色美食 黄冈附近的旅游景点 黄冈有哪些县 黄冈中学网站 湖北黄冈职业技术学院 黄冈人事考试网 黄冈中学网校好吗 黄冈女子妇科医院 湖北黄冈中医院

程序博客网，程序员的互联网技术博客家园。csdn论坛精品 msdn技术资料都在这里