Author: davidb
Date: Thu Jul 2 16:47:10 2015
New Revision: 1688860
URL: http://svn.apache.org/r1688860
Log:
Add Getting Started section to the Aries Async Services page.
Modified:
aries/site/trunk/content/modules/async-svcs.mdtext
Modified: aries/site/trunk/content/modules/async-svcs.mdtext
URL:
http://svn.apache.org/viewvc/aries/site/trunk/content/modules/async-svcs.mdtext?rev=1688860&r1=1688859&r2=1688860&view=diff
==============================================================================
--- aries/site/trunk/content/modules/async-svcs.mdtext (original)
+++ aries/site/trunk/content/modules/async-svcs.mdtext Thu Jul 2 16:47:10 2015
@@ -26,7 +26,7 @@ programming in enterprise applications.
#OSGi Promises
One of the fundamental pieces of an asynchronous programming system is the
*Promise*. A Promise is a holder type that
-represents an asynchronous calcluation. Since Java 5 the JDK has contained
*java.util.concurrent.Future* to perform this
+represents an asynchronous calculation or computation. Since Java 5 the JDK
has contained *java.util.concurrent.Future* to perform this
function. Java's Future type is, however, fatally flawed as it has no callback
to notify the user when it resolves. Instead the
user must make a blocking call to *get()*.
@@ -157,4 +157,11 @@ Sometimes the user does not care when a
These sorts of calls are called "fire and forget" calls, and are also
supported by the async service using the *execute()* method.
The execute method still returns a promise, however this promise represents
whether the fire and forget call successfully started
-or not, not whether it has completed.
\ No newline at end of file
+or not, not whether it has completed.
+
+# Getting Started
+The Asynchronous Services implementation can be found in the Apache Aries
codebase in the `async` directory:
[https://svn.apache.org/repos/asf/aries/trunk/async][1]
+
+In this location a convenient all-in-one bundle can also be found with no
dependencies: the `async-all` module.
+
+ [1]: https://svn.apache.org/repos/asf/aries/trunk/async
\ No newline at end of file
