From seam-commits at lists.jboss.org Thu Oct 14 03:47:31 2010
Content-Type: multipart/mixed; boundary="===============8010504726916005579=="
MIME-Version: 1.0
From: seam-commits at lists.jboss.org
To: seam-commits at lists.jboss.org
Subject: [seam-commits] Seam SVN: r13849 -
 branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-US.
Date: Thu, 14 Oct 2010 03:47:31 -0400
Message-ID: <201010140747.o9E7lVT5014049@svn01.web.mwc.hst.phx2.redhat.com>

--===============8010504726916005579==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

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.x=
ml
Log:
JBPAPP-1835 documented asynchronous issue with ThreadPoolDispatcher

Modified: branches/enterprise/JBPAPP_4_3_FP01/doc/Seam_Reference_Guide/en-U=
S/Jms.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- 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> annotati=
on 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=3D"JAVA"><![CDATA[@Local
+public interface PaymentHandler
+{
+    @Asynchronous
+    public void processPayment(Payment payment);
+}]]></programlisting>
+
         <para>
-            For JavaBean components we annotate the component implementati=
on class.
+            (For JavaBean components we can annotate the component impleme=
ntation 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!


--===============8010504726916005579==--