[hornetq-commits] JBoss hornetq SVN: r9291 - trunk/docs/user-manual/en.

[do-not-reply at jboss.org]

Author: ataylor
Date: 2010-06-03 10:19:26 -0400 (Thu, 03 Jun 2010)
New Revision: 9291

Modified:
   trunk/docs/user-manual/en/appserver-integration.xml
Log:
added pooling section for Resource Adaptor

Modified: trunk/docs/user-manual/en/appserver-integration.xml
===================================================================
--- trunk/docs/user-manual/en/appserver-integration.xml	2010-06-03 14:03:57 UTC (rev 9290)
+++ trunk/docs/user-manual/en/appserver-integration.xml	2010-06-03 14:19:26 UTC (rev 9291)
@@ -283,6 +283,29 @@
             EJBs (including Session, Entity and Message-Driven Beans), Servlets (including jsps) and
             custom MBeans.</para>
     </section>
+   <section>
+      <title>MDB and Consumer pool size</title>
+      <para>Most application servers, including JBoss, allow you to configure how many MDB's there are in a pool. In
+         Jboss this is configured via the <literal>MaxPoolSize</literal> parameter in the ejb3-interceptors-aop.xml file. Configuring
+         this has no actual effect on how many sessions/consumers there actually are created. This is because the Resource
+      Adaptor implementation knows nothing about the application servers MDB implementation. So even if you set the MDB
+         pool size to 1, 15 sessions/consumers will be created (this is the default). If you want to limit how many
+         sessions/consumers are created then you need to set the <literal>maxSession</literal> parameter either on the
+      resource adapter itself or via an an Activation Config Property on the MDB itself</para>
+        <programlisting>@MessageDriven(name = "MDBMessageSendTxExample",
+               activationConfig =
+                     {
+                        @ActivationConfigProperty(propertyName = "destinationType", propertyValue = "javax.jms.Queue"),
+                        @ActivationConfigProperty(propertyName = "destination", propertyValue = "queue/testQueue"),
+                        @ActivationConfigProperty(propertyName = "maxSession", propertyValue = "1")
+                     })
+ at TransactionManagement(value= TransactionManagementType.CONTAINER)
+ at TransactionAttribute(value= TransactionAttributeType.REQUIRED)
+ at ResourceAdapter("hornetq-ra.rar")
+public class MyMDB implements MessageListener
+{ ....}
+      </programlisting>
+   </section>
     <section>
         <title>Configuring the JCA Adaptor</title>
         <para>The Java Connector Architecture (JCA) Adapter is what allows HornetQ to be integrated