[jboss-svn-commits] JBL Code SVN: r25818 - in labs/jbosstm/workspace/adinn/orchestration: docs and 1 other directories.

[jboss-svn-commits at lists.jboss.org]

Author: adinn
Date: 2009-03-25 09:56:57 -0400 (Wed, 25 Mar 2009)
New Revision: 25818

Modified:
   labs/jbosstm/workspace/adinn/orchestration/README
   labs/jbosstm/workspace/adinn/orchestration/docs/ProgrammersGuide.odt
   labs/jbosstm/workspace/adinn/orchestration/src/org/jboss/jbossts/orchestration/synchronization/Waiter.java
Log:
included details of how to use the compiler tp README and manual and updated the docs on signalWake/Kill to explain the optional argument mustMeet

Modified: labs/jbosstm/workspace/adinn/orchestration/README
===================================================================
--- labs/jbosstm/workspace/adinn/orchestration/README	2009-03-25 13:16:52 UTC (rev 25817)
+++ labs/jbosstm/workspace/adinn/orchestration/README	2009-03-25 13:56:57 UTC (rev 25818)
@@ -14,14 +14,12 @@
   the transformer class which inserts trigger calls to invoke rules
 
   a rule compiler which translates rules into classes which handle the
-  trigger method calls (n.b. at present the rules are excuted by
-  interpreting the type-checked rule parse tree rather than by
-  compiling them but the latter should eventualy follow)
+  trigger method calls
 
 The agent is passed to the JVM using the -javaagent option of the java
 command by setting JAVA_OPTS as follows:
 
-export JAVA_OPTS="-javaagent:${HOME}/jboss/workspace/adinn/orchestration/build/lib/orchestration.jar=script:${HOME}/jboss/workspace/adinn/orchestration/handler.txt -Dorg.jboss.jbossts.orchestration.dump.generated.classes=yes -Dorg.jboss.jbossts.orchestration.dump.generated.classes.directory=$HOME/jboss/workspace/adinn/orchestration/dump"
+export JAVA_OPTS="-javaagent:${HOME}/jboss/workspace/adinn/orchestration/build/lib/orchestration.jar=script:${HOME}/jboss/workspace/adinn/orchestration/handler.txt -Dorg.jboss.jbossts.orchestration.compileToBytecode -Dorg.jboss.jbossts.orchestration.dump.generated.classes=yes -Dorg.jboss.jbossts.orchestration.dump.generated.classes.directory=$HOME/jboss/workspace/adinn/orchestration/dump"
 
 The =script:<scriptFile> option to the -javaagent argument tells the
 agent premain to search <scriptFile> for rules. Multiple scripts may
@@ -33,6 +31,19 @@
 Several other example scritps are available in the dd/scripts
 directory.
 
+By default the rule engine executes rule bindings, conditions and
+actions by interpreting the rule parse tree. However, TOAST also
+supports compiled execution. If system property
+
+  org.jboss.jbossts.orchestration.compileToBytecode
+
+is set to a non-null value then the rule engine will compile the rule
+bindings, condition and action into Java bytecode which will be
+executed when the rule is triggered (see the user guide for full
+details). For rules which are triggered repeatedly during an
+application run this should significantly mitigate the overheads
+imposed by the rule system.
+
 The agent can be configured to dump transformed byte code by setting
 several Java system properties as shown in the example above:
 

Modified: labs/jbosstm/workspace/adinn/orchestration/docs/ProgrammersGuide.odt
===================================================================
(Binary files differ)

Modified: labs/jbosstm/workspace/adinn/orchestration/src/org/jboss/jbossts/orchestration/synchronization/Waiter.java
===================================================================
--- labs/jbosstm/workspace/adinn/orchestration/src/org/jboss/jbossts/orchestration/synchronization/Waiter.java	2009-03-25 13:16:52 UTC (rev 25817)
+++ labs/jbosstm/workspace/adinn/orchestration/src/org/jboss/jbossts/orchestration/synchronization/Waiter.java	2009-03-25 13:56:57 UTC (rev 25818)
@@ -54,6 +54,9 @@
                 } catch (InterruptedException e) {
                     // ignore
                 }
+            } else {
+                // notify in case a signalling thread was waiting
+                this.notifyAll();
             }
         }