深入理解DefaultMessageListenerContainer

DefaultMessageListenerContainer是一个用于异步消息监听的管理类。

DefaultMessageListenerContainer最简单的实现逻辑，一个任务执行器，执行任务（即消息监听）。

DefaultMessageListenerContainer实现的主要原理是，通过内部初始化建立的一个taskExecutor（默认是SimpleAsyncTaskExecutor）用于执行消息监听的任务（AsyncMessageListenerInvoker）。

这里默认的任务执行器是SimpleAsyncTaskExecutor，这个执行器的缺点是不会重用连接，也就是对于每个任务都需要新开启一个线程，执行完任务后会关闭它。如果要优化的话可以考虑线程池。

消息监听的任务被抽象成AsyncMessageListenerInvoker类，这个类实现了Runnable接口，内部run方法其实是通过不断循环consumer.recieve()方法来实现监听。

事实上一个消费者对应了一个AsyncMessageListenerInvoker任务，每个任务需要一个单独的线程去执行它。这个AsyncMessageListenerInvoker实例被放在了一个名为scheduledInvokers的set里面。

其实我们还有一个比较关心的地方是这个DefaultMessageListenerContainer缓不缓存connection，session，consumer。它是根据catchLevel属性来决定是否缓存connection，session，consumer。默认的catchLevel对应常量CATCH_AUTO，即由配置的外部事务管理器决定。catchLevel级别分别是CATCH_NONE，CATCH_CONNECTION,CATCH_SESSION,CATCH_CONSUMER，分别对应0,1,2,3。我试了下默认的CATCH_AUTO在没有定义事务管理时值为 CATCH_CONSUMER，即3。

DefaultMessageListenerContainer会根据catchLevel来缓存共享connection，session，及consumer。值为3的话就会缓存connection，session，及consumer，在初始化的时候就会调用父类AbstractJmsListeningContainer的doStart()方法，判断cacheLevel是否大于等于1，如果大于就创建一个connection将放入成员变量sharedConnection中。

每个任务被执行的时候（即责任是监听消息），会先去获取connection，session及consumer（通过调用initResourcesIfNecessary方法）就像我们自己最初实现一个简单的客户端消费者一样。只不过这里会根据catchLevel来决定是否缓存session及consumer。被缓存了的session及consumer放在对应的成员变量里面。

接着任务会想要执行consumer.recieve方法，这之前肯定要获取onnection，session及consumer，如果已有onnection，session及consumer则获取过来，如果没有则通过配置的信息新建。执行完consumer.recieve后，会判断consumer.recieve返回的消息是否为空。

不为空则调用message对应的messageListner(之前我们在DefaultMessageListenerContainer中通过方法setMessageListner设置的）的onMessage执行相应的逻辑，并设置这个任务的Idle为false，表明这个任务不是空闲的，然后会调用方法判断是否应该新建任务实例，这个受限于MaxConcurrentConsumers及IdleTaskExecutionLimit。为空则不需要特别处理，只需调用noMessageReceived方法将idle标记设为true。

任务执行完后，会在finally处释放connection，session及consumer。这个是根据上述讲的catchLevel来设置的。

继承体系如下：

 

AbstractJmsListeningContainer提供了一个最上层最基础的jms消息监听管理类所应该有的方法。提供了start（启动这个管理类），stop，initialize（初始化这个管理类），establishSharedConnection等。

====================

http://blog.sina.com.cn/s/blog_6592ed330100loqk.html

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连接。