[seam-commits] Seam SVN: r13849 - branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US.

[seam-commits at lists.jboss.org]

Author: manaRH
Date: 2010-10-14 03:47:30 -0400 (Thu, 14 Oct 2010)
New Revision: 13849

Modified:
   branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Jms.xml
Log:
JBPAPP-1835 documented asynchronous issue with ThreadPoolDispatcher

Modified: branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Jms.xml
===================================================================
--- branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Jms.xml	2010-10-14 07:41:34 UTC (rev 13848)
+++ branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US/Jms.xml	2010-10-14 07:47:30 UTC (rev 13849)
@@ -81,12 +81,27 @@
         </para>
         
         <para>
-            For EJB components, we annotate the implementation of bean to specify that a method is processed
+            For EJB components, we annotate the local interface to specify that a method is processed
             asynchronously.
         </para>
         
+	    <note>
+	        <title>Asynchronous annotation while ThreadPoolDispatcher is used</title>    
+	    	<para>If you use <literal>org.jboss.seam.async.ThreadPoolDispatcher</literal> as an asynchronous dispatcher in your EJB3 code,
+	    	 you have to annotate with <literal>@Asynchronous</literal> annotation Bean class method and not local interface method like shown in example.</para>
+	    	 
+			<para>Spawning threads from local interface is not supported.</para>	    	      
+	    </note>
+        
+        <programlisting role="JAVA"><![CDATA[@Local
+public interface PaymentHandler
+{
+    @Asynchronous
+    public void processPayment(Payment payment);
+}]]></programlisting>
+
         <para>
-            For JavaBean components we annotate the component implementation class.
+            (For JavaBean components we can annotate the component implementation class if we like.)
         </para>
         
         <para>
@@ -97,7 +112,6 @@
 @Name("paymentHandler")
 public class PaymentHandlerBean implements PaymentHandler
 {
-	@Asynchronous
     public void processPayment(Payment payment)
     {
         //do some work!