[teiid-commits] teiid SVN: r3614 - trunk/documentation/developer-guide/src/main/docbook/en-US/content.
teiid-commits at lists.jboss.org
teiid-commits at lists.jboss.org
Fri Nov 4 13:36:59 EDT 2011
Author: rareddy
Date: 2011-11-04 13:36:58 -0400 (Fri, 04 Nov 2011)
New Revision: 3614
Modified:
trunk/documentation/developer-guide/src/main/docbook/en-US/content/translator-api.xml
Log:
misc: fixing "code" tag
Modified: trunk/documentation/developer-guide/src/main/docbook/en-US/content/translator-api.xml
===================================================================
--- trunk/documentation/developer-guide/src/main/docbook/en-US/content/translator-api.xml 2011-11-04 14:57:30 UTC (rev 3613)
+++ trunk/documentation/developer-guide/src/main/docbook/en-US/content/translator-api.xml 2011-11-04 17:36:58 UTC (rev 3614)
@@ -257,17 +257,27 @@
<section>
<title>Asynchronous Executions</title>
- <para>In some scenarios, a translator needs to execute
- asynchronously and allow the executing thread to perform other work. To allow this, you should Throw a <code>DataNotAvailableExecption</code> during a retrival method, rather than explicitly waiting or sleeping for the results.
- <note><para>A <code>DataNotAvailableException</code> should not be thrown by the execute method.</para><note>
- The
- <code>DataNotAvailableException</code> may take a delay parameter in its
- constructor to indicate how long the system should wait befor polling
- for results. Any non-negative value indicates a time until the next polling should be performed.
- The <code>DataNotAvailableException.NO_POLLING</code> exception (or any DataNotAvailableException with a negative delay) can be thrown to indicate that
- the execution will call <code>ExecutionContext.dataAvailable<c/ode> to indicate processing should resume.
- </para>
- <note><para>Since the exection and the associated connection are not closed until the work has completed, care should be taken if using asynchronous executions that hold a lot of state.</para></note>
+ <para>
+ In some scenarios, a translator needs to execute
+ asynchronously and allow the executing thread to perform other work. To allow this, you should Throw a
+ <code>DataNotAvailableExecption</code>
+ during a retrival method, rather than explicitly waiting or sleeping for the results.
+ <note>
+ <para>
+ A <code>DataNotAvailableException</code> should not be thrown by the execute method. The
+ <code>DataNotAvailableException</code> may take a delay parameter in its
+ constructor to indicate how long the system should wait befor polling
+ for results. Any non-negative value indicates a time until the next polling should be performed.
+ The
+ <code>DataNotAvailableException.NO_POLLING</code>
+ exception (or any DataNotAvailableException with a negative delay) can be thrown to indicate that
+ the execution will call <code>ExecutionContext.dataAvailable</code> to indicate processing should resume.
+ </para>
+ </note>
+ </para>
+ <note>
+ <para>Since the exection and the associated connection are not closed until the work has completed, care should be taken if using asynchronous executions that hold a lot of state.</para>
+ </note>
</section>
<section>
More information about the teiid-commits
mailing list