diff --git a/spring-framework-reference/src/jms.xml b/spring-framework-reference/src/jms.xml
index 525ce17afc..1e38064874 100644
--- a/spring-framework-reference/src/jms.xml
+++ b/spring-framework-reference/src/jms.xml
@@ -275,19 +275,21 @@
receiving a message (and possibly responding to it), and delegates
boilerplate JMS infrastructure concerns to the framework.
- There are three standard JMS message listener containers packaged
+ There are two standard JMS message listener containers packaged
with Spring, each with its specialised feature set.
SimpleMessageListenerContainer
- This message listener container is the simplest of the three
- standard flavors. It simply creates a fixed number of JMS sessions at
- startup and uses them throughout the lifespan of the container. This
- container doesn't allow for dynamic adaption to runtime demands or
- participate in externally managed transactions. However, it does have
- the fewest requirements on the JMS provider: This listener container
- only requires simple JMS API compliance.
+ This message listener container is the simpler of the two
+ standard flavors. It creates a fixed number of JMS sessions and
+ consumers at startup, registers the listener using the standard JMS
+ MessageConsumer.setMessageListener method,
+ and leaves it up the JMS provider to perform listener callbacks.
+ This variant does not allow for dynamic adaption to runtime demands or
+ for participation in externally managed transactions. Compatibility-wise,
+ it stays very close to the spirit of the standalone JMS specification
+ - but is generally not compatible with Java EE's JMS restrictions.
@@ -297,25 +299,12 @@
In contrast to SimpleMessageListenerContainer,
this container variant does allow for dynamic adaption to runtime
demands and is able to participate in externally managed transactions.
- Each received message is registered with an XA transaction (when
- configured with a JtaTransactionManager);
- processing can take advantage of XA transation semantics. This
- listener container strikes a good balance between low requirements on
- the JMS provider and good functionality including transaction
- participation.
-
-
-
- ServerSessionMessageListenerContainer
-
- This listener container leverages the JMS ServerSessionPool SPI
- to allow for dynamic management of JMS sessions. The use of this
- variety of message listener container enables the provider to perform
- dynamic runtime tuning but, at the expense of requiring the JMS
- provider to support the ServerSessionPool SPI. If there is no need for
- provider-driven runtime tuning, look at the
- DefaultMessageListenerContainer or the
- SimpleMessageListenerContainer instead.
+ Each received message is registered with an XA transaction when
+ configured with a JtaTransactionManager;
+ so processing may take advantage of XA transation semantics. This
+ listener container strikes a good balance between low requirements
+ on the JMS provider, advanced functionality such as transaction
+ participation, and compatibility with Java EE environments.