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!