Spring JMS (2)

2. JmsAccessor



抽象类JmsAccessor是JmsTemplate,JmsDestinationAccessor,AbstractJmsListeningContainer扩展类的基类，提供了创建Connection和Session的方法。

protected Connection createConnection() throws JMSException {
		return getConnectionFactory().createConnection();
	}
protected Session createSession(Connection con) throws JMSException {
		return con.createSession(isSessionTransacted(), getSessionAcknowledgeMode()); //默认为Session.AUTO_ACKNOWLEDGE模式
	}

JmsAccessor还提供了通用的一些JMS属性：

private ConnectionFactory connectionFactory;
private boolean sessionTransacted = false;
private int sessionAcknowledgeMode = Session.AUTO_ACKNOWLEDGE;

2.1 JmsDestinationAccessor
  抽象类JmsDestinationAccessor继承JmsAccessor类，提供了对指定目的地名转换为JMS地址的封装。

protected Destination resolveDestinationName(Session session, String destinationName) throws JMSException {
		return getDestinationResolver().resolveDestinationName(session, destinationName, isPubSubDomain());
	}

2.2 AbstractJmsListeningContainer
  AbstractJmsListeningContainer是所有Message Listener Container的基类，提供了JMS Connection的生命周期管理功能。

private String clientId;// JMS client id
private boolean autoStartup = true; //当应用程序重新配置的时候是否自动启动
private Connection sharedConnection;//共享JMS Connection连接
protected abstract boolean sharedConnectionEnabled();//决定是否使用共享的JMS Connection。

2.3 AbstractMessageListenerContainer
  AbstractMessageListenerContainer继承AbstractJmsListeningContainer类，也是Message Listener Container的基类。

private volatile Object destination;//指定接收消息的目的地。
private volatile Object messageListener;//指定处理消息的listener。
private boolean exposeListenerSession = true;

这里的messageListener可以是标准的JMS消息监听对象(javax.jms.MessageListener)，也可以是Spring特有的的JMS监听对象(org.springframework.jms.listener.SessionAwareMessageListener)。
看一下SessionAwareMessageListener中监听器接口的定义:

public interface SessionAwareMessageListener {   
    void onMessage(Message message, Session session) throws JMSException;   
}

与标准的JMS消息监听对象相比

public interface SessionAwareMessageListener {   
    void onMessage(Message message) throws JMSException;   
}

增加了Session的参数，表示可以通过此session发送回复的消息。
如果使用了SessionAwareMessageListener 类型的message listener，那么exposeListenerSession参数指定了传入onMessage方法的session参数是否是创建了MessageConsumer的session，默认值是true。如果是false，那么AbstractMessageListenerContainer会在connection上新建一个session，并传入onMessage方法。

protected void doInvokeListener(SessionAwareMessageListener listener, Session session, Message message)
			throws JMSException {

		Connection conToClose = null;
		Session sessionToClose = null;
		try {
			Session sessionToUse = session;
			if (!isExposeListenerSession()) {
				// We need to expose a separate Session.
				conToClose = createConnection();
				sessionToClose = createSession(conToClose);
				sessionToUse = sessionToClose;
			}
			// Actually invoke the message listener...
			listener.onMessage(message, sessionToUse);
			// Clean up specially exposed Session, if any.
			if (sessionToUse != session) {
				if (sessionToUse.getTransacted() && isSessionLocallyTransacted(sessionToUse)) {
					// Transacted session created by this container -> commit.
					JmsUtils.commitIfNecessary(sessionToUse);
				}
			}
		}
		finally {
			JmsUtils.closeSession(sessionToClose);
			JmsUtils.closeConnection(conToClose);
		}
	}

2.4 AbstractPollingMessageListenerContainer
  AbstractPollingMessageListenerContainer继承了AbstractMessageListenerContainer类，并实现了BeanNameAware接口。提供了对消息的接受和事物的管理。

private long receiveTimeout = DEFAULT_RECEIVE_TIMEOUT;//默认接受消息超时时间为1秒
private boolean pubSubNoLocal = false;//表示某个连接发送到某个Topic的消息，是否应该被投递回这个连接。
private PlatformTransactionManager transactionManager; //我们需要配置一个平台的事物管理器。通常情况下为org.springframework.transaction.jta.JtaTransactionManager

2.5 SimpleMessageListenerContainer
  SimpleMessageListenerContainer继承自AbstractMessageListenerContainer，提供了对消息的异步接受。

private int concurrentConsumers = 1;
private Set<Session> sessions;
private Set<MessageConsumer> consumers;

允许一次启动多个Session和MessageConsumer，取决于concurrentConsumers的数量。

protected void initializeConsumers() throws JMSException {
		// Register Sessions and MessageConsumers.
		synchronized (this.consumersMonitor) {
			if (this.consumers == null) {
				this.sessions = new HashSet<Session>(this.concurrentConsumers);
				this.consumers = new HashSet<MessageConsumer>(this.concurrentConsumers);
				Connection con = getSharedConnection();
				for (int i = 0; i < this.concurrentConsumers; i++) {
					Session session = createSession(con);
					MessageConsumer consumer = createListenerConsumer(session);
					this.sessions.add(session);
					this.consumers.add(consumer);
				}
			}
		}
	}

2.6 DefaultMessageListenerContainer
  DefaultMessageListenerContainer继承了AbstractPollingMessageListenerContainer类，提供了同步消息的接受。也就是通过循环调用MessageConsumer.receive的方式接收消息。

private int cacheLevel = CACHE_AUTO;

cacheLevel表示是否对JMS资源进行缓存，如果transactionManager属性不为null，那么cacheLevel被自动设置为CACHE_NONE（不进行缓存），否则cacheLevel被自动设置为CACHE_CONSUMER。

2.7 SingleConnectionFactory
  SingleConnectionFactory