[jboss-cvs] JBossAS SVN: r63482 - in projects/aop/trunk/aop/docs/examples: annotated-dynamic-cflow and 2 other directories.
jboss-cvs-commits at lists.jboss.org
jboss-cvs-commits at lists.jboss.org
Tue Jun 12 14:52:59 EDT 2007
Author: flavia.rainone at jboss.com
Date: 2007-06-12 14:52:59 -0400 (Tue, 12 Jun 2007)
New Revision: 63482
Added:
projects/aop/trunk/aop/docs/examples/dynamic-cflow/
projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml
projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html
projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml
projects/aop/trunk/aop/docs/examples/ioc-with-has/
projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java
projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java
projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java
projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml
projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html
projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml
Removed:
projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java
projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml
projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html
projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml
projects/aop/trunk/aop/docs/examples/dynamic_cflow/
projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java
projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java
projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java
projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml
projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html
projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml
projects/aop/trunk/aop/docs/examples/ioc_with_has/
Modified:
projects/aop/trunk/aop/docs/examples/annotated-dynamic-cflow/annotated-dynamic-cflow.html
projects/aop/trunk/aop/docs/examples/examples.html
Log:
Uniformized example names.
Modified: projects/aop/trunk/aop/docs/examples/annotated-dynamic-cflow/annotated-dynamic-cflow.html
===================================================================
--- projects/aop/trunk/aop/docs/examples/annotated-dynamic-cflow/annotated-dynamic-cflow.html 2007-06-12 18:47:19 UTC (rev 63481)
+++ projects/aop/trunk/aop/docs/examples/annotated-dynamic-cflow/annotated-dynamic-cflow.html 2007-06-12 18:52:59 UTC (rev 63482)
@@ -6,7 +6,7 @@
</p><p>
<h4>Overview</h4>
-Dynamic CFlows work similar to when defined in <a href="../dynamic_cflow/cflow.html">XML</a>. The only difference is how to declare it using annotations.
+Dynamic CFlows work similar to when defined in <a href="../dynamic-cflow/cflow.html">XML</a>. The only difference is how to declare it using annotations.
</p><p>
<h4>Implement DynamicCFlow</h4>
@@ -28,7 +28,7 @@
}
</pre>
</p><p>
-This is exactly the same as in the <a href="../dynamic_cflow/cflow.html">XML</a> example. The only difference is that we declare the dynamic cflow class by annotating it with @DynamicCFlowDef.
+This is exactly the same as in the <a href="../dynamic-cflow/cflow.html">XML</a> example. The only difference is that we declare the dynamic cflow class by annotating it with @DynamicCFlowDef.
</p><p>
<h4>Use in bindings</h4>
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow (from rev 63476, projects/aop/trunk/aop/docs/examples/dynamic_cflow)
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/Driver.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,34 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2005, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-
-public class Driver
-{
- public static void main(String[] args)
- {
- POJO pojo = new POJO();
- System.out.println("--- pojo.method4(); ---");
- pojo.method1();
- System.out.println("--- turn on cflow ---");
- SimpleDynamicCFlow.runit = true;
- pojo.method1();
- }
-}
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/Driver.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/Driver.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,34 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2005, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+public class Driver
+{
+ public static void main(String[] args)
+ {
+ POJO pojo = new POJO();
+ System.out.println("--- pojo.method4(); ---");
+ pojo.method1();
+ System.out.println("--- turn on cflow ---");
+ SimpleDynamicCFlow.runit = true;
+ pojo.method1();
+ }
+}
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/POJO.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,33 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2005, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-public class POJO
-{
- public POJO() {}
-
- public void method1()
- {
- System.out.println("method1");
- }
-}
-
-
-
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/POJO.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/POJO.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,33 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2005, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+public class POJO
+{
+ public POJO() {}
+
+ public void method1()
+ {
+ System.out.println("method1");
+ }
+}
+
+
+
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/SimpleDynamicCFlow.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,35 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2005, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-
-import org.jboss.aop.joinpoint.Invocation;
-import org.jboss.aop.pointcut.DynamicCFlow;
-
-public class SimpleDynamicCFlow implements DynamicCFlow
-{
- public static boolean runit = false;
-
-
- public boolean shouldExecute(Invocation invocation)
- {
- return runit;
- }
-}
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/SimpleDynamicCFlow.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleDynamicCFlow.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,35 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2005, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+import org.jboss.aop.joinpoint.Invocation;
+import org.jboss.aop.pointcut.DynamicCFlow;
+
+public class SimpleDynamicCFlow implements DynamicCFlow
+{
+ public static boolean runit = false;
+
+
+ public boolean shouldExecute(Invocation invocation)
+ {
+ return runit;
+ }
+}
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/SimpleInterceptor.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,48 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2005, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-import org.jboss.aop.joinpoint.Invocation;
-import org.jboss.aop.joinpoint.MethodInvocation;
-import org.jboss.aop.advice.Interceptor;
-
-/**
- *
- * @author <a href="mailto:bill at jboss.org">Bill Burke</a>
- * @version $Revision$
- */
-public class SimpleInterceptor implements Interceptor
-{
- public String getName() { return "SimpleInterceptor"; }
-
- public Object invoke(Invocation invocation) throws Throwable
- {
- try
- {
- MethodInvocation mi = (MethodInvocation)invocation;
- System.out.println("<<< Entering SimpleInterceptor for: " + mi.getMethod().toString());
- return invocation.invokeNext();
- }
- finally
- {
- System.out.println(">>> Leaving SimpleInterceptor");
- }
- }
-}
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/SimpleInterceptor.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/SimpleInterceptor.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,48 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2005, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+import org.jboss.aop.joinpoint.Invocation;
+import org.jboss.aop.joinpoint.MethodInvocation;
+import org.jboss.aop.advice.Interceptor;
+
+/**
+ *
+ * @author <a href="mailto:bill at jboss.org">Bill Burke</a>
+ * @version $Revision$
+ */
+public class SimpleInterceptor implements Interceptor
+{
+ public String getName() { return "SimpleInterceptor"; }
+
+ public Object invoke(Invocation invocation) throws Throwable
+ {
+ try
+ {
+ MethodInvocation mi = (MethodInvocation)invocation;
+ System.out.println("<<< Entering SimpleInterceptor for: " + mi.getMethod().toString());
+ return invocation.invokeNext();
+ }
+ finally
+ {
+ System.out.println(">>> Leaving SimpleInterceptor");
+ }
+ }
+}
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/build.xml 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<project default="usage" name="JBoss/AOP">
- <import file="../examples-build.xml"/>
-
- <target name="run.aopc.50" depends="_run.aopc.50"/>
-
- <target name="run.loadtime.50" depends="_run.loadtime.50"/>
-
- <target name="run.aopc.14" depends="_run.aopc.14"/>
-
- <target name="run.loadtime.14" depends="_run.loadtime.14"/>
-</project>
-
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/build.xml)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/build.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<project default="usage" name="JBoss/AOP">
+ <import file="../examples-build.xml"/>
+
+ <target name="run.aopc.50" depends="_run.aopc.50"/>
+
+ <target name="run.loadtime.50" depends="_run.loadtime.50"/>
+
+ <target name="run.aopc.14" depends="_run.aopc.14"/>
+
+ <target name="run.loadtime.14" depends="_run.loadtime.14"/>
+</project>
+
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/cflow.html 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,66 +0,0 @@
-<html>
-<body>
-<p>
-<h2>Dynamic Control Flow</h2>
-
-</p><p>
-<h4>Overview</h4>
-
-Control flow is a runtime construct. A dynamic cflow will be called before the execution of the advices/interceptors it wraps. If it returns true then the advices execution. It allows you to do runtime dynamic checks at runtime to determine whether or not you want to run an advice stack.
-</p><p>
-<h4>Step One</h4>
-
-To implement a Dynamic CFlow you first need to implement org.jboss.aop.pointcut.DynamicCFlow
-</p><p>
-<pre>
-public interface DynamicCFlow
-{
- boolean shouldExecute(Invocation invocation);
-}
-</pre>
-</p><p>
-Put in the logic you want to run at runtime into the shouldExecution method.
-</p><p>
-<h4>Step Two</h4>
-
-Step two is to declare the Dynamic CFlow in the AOP XML file. See jboss-aop.xml:
-</p><p>
-<pre>
- <dynamic-cflow name="simple" class="SimpleDynamicCFlow"/>
-</pre>
-</p><p>
-Then you can use the dynamic cflow in any cflow expression. The cflow will be allocate once and only once for the entire VM.
-</p><p>
-<h4>Configure with XML</h4>
-
-If you want to do some XML configuration of the dynamic cflow instance, you can have it implement org.jboss.util.xml.XmlLoadable.
-</p><p>
-<pre>
-public interface XmlLoadable
-{
- public void importXml(Element element);
-}
-</pre>
-</p><p>
-<h4>Run the example</h4>
-
-<p>
-<b>THIS EXAMPLE REQUIRES JDK 5!! For other options, please look at the
-<a href="../valid_targets_not_annotated.html"/>non-annotated examples guide</a></b> To compile and run:</p>
-<pre>
- $ run.aopc.50
-</pre>
-<p>It will javac the files and then run the AOPC precompiler to manipulate the bytecode, then finally run the example. The output should be similar to this:</p>
-<pre>
-_run.aopc.50:
- [java] --- pojo.method4(); ---
- [java] method1
- [java] --- turn on cflow ---
- [java] <<< Entering SimpleInterceptor for: public void POJO.method1()
- [java] method1
- [java] >>> Leaving SimpleInterceptor
-</pre>
-</p><p>
-</p>
-</body>
-</html>
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/cflow.html)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/cflow.html 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,66 @@
+<html>
+<body>
+<p>
+<h2>Dynamic Control Flow</h2>
+
+</p><p>
+<h4>Overview</h4>
+
+Control flow is a runtime construct. A dynamic cflow will be called before the execution of the advices/interceptors it wraps. If it returns true then the advices execution. It allows you to do runtime dynamic checks at runtime to determine whether or not you want to run an advice stack.
+</p><p>
+<h4>Step One</h4>
+
+To implement a Dynamic CFlow you first need to implement org.jboss.aop.pointcut.DynamicCFlow
+</p><p>
+<pre>
+public interface DynamicCFlow
+{
+ boolean shouldExecute(Invocation invocation);
+}
+</pre>
+</p><p>
+Put in the logic you want to run at runtime into the shouldExecution method.
+</p><p>
+<h4>Step Two</h4>
+
+Step two is to declare the Dynamic CFlow in the AOP XML file. See jboss-aop.xml:
+</p><p>
+<pre>
+ <dynamic-cflow name="simple" class="SimpleDynamicCFlow"/>
+</pre>
+</p><p>
+Then you can use the dynamic cflow in any cflow expression. The cflow will be allocate once and only once for the entire VM.
+</p><p>
+<h4>Configure with XML</h4>
+
+If you want to do some XML configuration of the dynamic cflow instance, you can have it implement org.jboss.util.xml.XmlLoadable.
+</p><p>
+<pre>
+public interface XmlLoadable
+{
+ public void importXml(Element element);
+}
+</pre>
+</p><p>
+<h4>Run the example</h4>
+
+<p>
+<b>THIS EXAMPLE REQUIRES JDK 5!! For other options, please look at the
+<a href="../valid_targets_not_annotated.html"/>non-annotated examples guide</a></b> To compile and run:</p>
+<pre>
+ $ run.aopc.50
+</pre>
+<p>It will javac the files and then run the AOPC precompiler to manipulate the bytecode, then finally run the example. The output should be similar to this:</p>
+<pre>
+_run.aopc.50:
+ [java] --- pojo.method4(); ---
+ [java] method1
+ [java] --- turn on cflow ---
+ [java] <<< Entering SimpleInterceptor for: public void POJO.method1()
+ [java] method1
+ [java] >>> Leaving SimpleInterceptor
+</pre>
+</p><p>
+</p>
+</body>
+</html>
Deleted: projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic_cflow/jboss-aop.xml 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,10 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<aop>
-
- <dynamic-cflow name="simple" class="SimpleDynamicCFlow"/>
-
- <bind pointcut="execution(void POJO->method1())" cflow="simple">
- <interceptor class="SimpleInterceptor"/>
- </bind>
-
-</aop>
Copied: projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml (from rev 63480, projects/aop/trunk/aop/docs/examples/dynamic_cflow/jboss-aop.xml)
===================================================================
--- projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml (rev 0)
+++ projects/aop/trunk/aop/docs/examples/dynamic-cflow/jboss-aop.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<aop>
+
+ <dynamic-cflow name="simple" class="SimpleDynamicCFlow"/>
+
+ <bind pointcut="execution(void POJO->method1())" cflow="simple">
+ <interceptor class="SimpleInterceptor"/>
+ </bind>
+
+</aop>
Modified: projects/aop/trunk/aop/docs/examples/examples.html
===================================================================
--- projects/aop/trunk/aop/docs/examples/examples.html 2007-06-12 18:47:19 UTC (rev 63481)
+++ projects/aop/trunk/aop/docs/examples/examples.html 2007-06-12 18:52:59 UTC (rev 63482)
@@ -51,10 +51,10 @@
<li> <a href="instanceof/instanceof.html">Instanceof</a></li>
<li> <a href="implements/implements.html">Implements</a></li>
<li> <a href="cflow/cflow.html">Control flow</a></li>
-<li> <a href="dynamic_cflow/cflow.html">Dynamic control flow</a></li>
+<li> <a href="dynamic-cflow/cflow.html">Dynamic control flow</a></li>
<li> <a href="composition/composition.html">Compositional and named pointcuts</a></li>
<li> <a href="stacks/stacks.html">Stacks</a></li>
-<li> <a href="ioc_with_has/has.html">The has and hasfield operator</a></li>
+<li> <a href="ioc-with-has/has.html">The has and hasfield operator</a></li>
<li> <a href="typedef/typedef.html">Typedefs</a></li>
</ul>
</p><p>
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has (from rev 63476, projects/aop/trunk/aop/docs/examples/ioc_with_has)
Deleted: projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc_with_has/DependencyInjectorInterceptor.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,43 +0,0 @@
-/*
-* JBoss, Home of Professional Open Source
-* Copyright 2005, JBoss Inc., and individual contributors as indicated
-* by the @authors tag. See the copyright.txt in the distribution for a
-* full listing of individual contributors.
-*
-* This is free software; you can redistribute it and/or modify it
-* under the terms of the GNU Lesser General Public License as
-* published by the Free Software Foundation; either version 2.1 of
-* the License, or (at your option) any later version.
-*
-* This software is distributed in the hope that it will be useful,
-* but WITHOUT ANY WARRANTY; without even the implied warranty of
-* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-* Lesser General Public License for more details.
-*
-* You should have received a copy of the GNU Lesser General Public
-* License along with this software; if not, write to the Free
-* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-*/
-import org.jboss.aop.joinpoint.Invocation;
-import org.jboss.aop.joinpoint.ConstructorInvocation;
-import org.jboss.aop.advice.Interceptor;
-import java.lang.reflect.*;
-
-/**
- *
- * @author <a href="mailto:bill at jboss.org">Bill Burke</a>
- * @version $Revision$
- */
-public class DependencyInjectorInterceptor implements Interceptor
-{
- public String getName() { return "ConstructorInterceptor"; }
-
- public Object invoke(Invocation invocation) throws Throwable
- {
- Object val = invocation.invokeNext();
- Method method = val.getClass().getMethod("setInjectedParameter", new Class[] { Integer.TYPE });
- method.invoke(val, new Object[] { new Integer(55) });
- return val;
- }
-}
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java (from rev 63480, projects/aop/trunk/aop/docs/examples/ioc_with_has/DependencyInjectorInterceptor.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/DependencyInjectorInterceptor.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,43 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2005, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+import org.jboss.aop.joinpoint.Invocation;
+import org.jboss.aop.joinpoint.ConstructorInvocation;
+import org.jboss.aop.advice.Interceptor;
+import java.lang.reflect.*;
+
+/**
+ *
+ * @author <a href="mailto:bill at jboss.org">Bill Burke</a>
+ * @version $Revision$
+ */
+public class DependencyInjectorInterceptor implements Interceptor
+{
+ public String getName() { return "ConstructorInterceptor"; }
+
+ public Object invoke(Invocation invocation) throws Throwable
+ {
+ Object val = invocation.invokeNext();
+ Method method = val.getClass().getMethod("setInjectedParameter", new Class[] { Integer.TYPE });
+ method.invoke(val, new Object[] { new Integer(55) });
+ return val;
+ }
+}
Deleted: projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc_with_has/Driver.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,30 +0,0 @@
-/*
- * JBoss, Home of Professional Open Source
- * Copyright 2005, JBoss Inc., and individual contributors as indicated
- * by the @authors tag. See the copyright.txt in the distribution for a
- * full listing of individual contributors.
- *
- * This is free software; you can redistribute it and/or modify it
- * under the terms of the GNU Lesser General Public License as
- * published by the Free Software Foundation; either version 2.1 of
- * the License, or (at your option) any later version.
- *
- * This software is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this software; if not, write to the Free
- * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
- * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
- */
-
-public class Driver
-{
- public static void main(String[] args)
- {
- POJO pojo = new POJO();
- System.out.println("foo: : " + pojo.foo);
- }
-}
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java (from rev 63480, projects/aop/trunk/aop/docs/examples/ioc_with_has/Driver.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/Driver.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,30 @@
+/*
+ * JBoss, Home of Professional Open Source
+ * Copyright 2005, JBoss Inc., and individual contributors as indicated
+ * by the @authors tag. See the copyright.txt in the distribution for a
+ * full listing of individual contributors.
+ *
+ * This is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU Lesser General Public License as
+ * published by the Free Software Foundation; either version 2.1 of
+ * the License, or (at your option) any later version.
+ *
+ * This software is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this software; if not, write to the Free
+ * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+ * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+ */
+
+public class Driver
+{
+ public static void main(String[] args)
+ {
+ POJO pojo = new POJO();
+ System.out.println("foo: : " + pojo.foo);
+ }
+}
Deleted: projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc_with_has/POJO.java 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,39 +0,0 @@
-/*
-* JBoss, Home of Professional Open Source
-* Copyright 2005, JBoss Inc., and individual contributors as indicated
-* by the @authors tag. See the copyright.txt in the distribution for a
-* full listing of individual contributors.
-*
-* This is free software; you can redistribute it and/or modify it
-* under the terms of the GNU Lesser General Public License as
-* published by the Free Software Foundation; either version 2.1 of
-* the License, or (at your option) any later version.
-*
-* This software is distributed in the hope that it will be useful,
-* but WITHOUT ANY WARRANTY; without even the implied warranty of
-* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-* Lesser General Public License for more details.
-*
-* You should have received a copy of the GNU Lesser General Public
-* License along with this software; if not, write to the Free
-* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
-* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
-*/
-public class POJO
-{
- public POJO()
- {
- }
-
- public int foo = 0;
-
- public void setInjectedParameter(int newfoo)
- {
- foo = newfoo;
- }
-
-
-}
-
-
-
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java (from rev 63480, projects/aop/trunk/aop/docs/examples/ioc_with_has/POJO.java)
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java (rev 0)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/POJO.java 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,39 @@
+/*
+* JBoss, Home of Professional Open Source
+* Copyright 2005, JBoss Inc., and individual contributors as indicated
+* by the @authors tag. See the copyright.txt in the distribution for a
+* full listing of individual contributors.
+*
+* This is free software; you can redistribute it and/or modify it
+* under the terms of the GNU Lesser General Public License as
+* published by the Free Software Foundation; either version 2.1 of
+* the License, or (at your option) any later version.
+*
+* This software is distributed in the hope that it will be useful,
+* but WITHOUT ANY WARRANTY; without even the implied warranty of
+* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+* Lesser General Public License for more details.
+*
+* You should have received a copy of the GNU Lesser General Public
+* License along with this software; if not, write to the Free
+* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
+* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
+*/
+public class POJO
+{
+ public POJO()
+ {
+ }
+
+ public int foo = 0;
+
+ public void setInjectedParameter(int newfoo)
+ {
+ foo = newfoo;
+ }
+
+
+}
+
+
+
Deleted: projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc_with_has/build.xml 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-<project default="usage" name="JBoss/AOP">
- <import file="../examples-build.xml"/>
-
- <target name="run.aopc.50" depends="_run.aopc.50"/>
-
- <target name="run.loadtime.50" depends="_run.loadtime.50"/>
-
- <target name="run.aopc.14" depends="_run.aopc.14"/>
-
- <target name="run.loadtime.14" depends="_run.loadtime.14"/>
-</project>
-
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml (from rev 63480, projects/aop/trunk/aop/docs/examples/ioc_with_has/build.xml)
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml (rev 0)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/build.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<project default="usage" name="JBoss/AOP">
+ <import file="../examples-build.xml"/>
+
+ <target name="run.aopc.50" depends="_run.aopc.50"/>
+
+ <target name="run.loadtime.50" depends="_run.loadtime.50"/>
+
+ <target name="run.aopc.14" depends="_run.aopc.14"/>
+
+ <target name="run.loadtime.14" depends="_run.loadtime.14"/>
+</project>
+
Deleted: projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc_with_has/has.html 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,39 +0,0 @@
-<html>
-<body>
-<p>
-<h2> The HAS and HASFIELD operator</h2>
-
-</p><p>
-The HAS operator within a pointcut expression allows you to inquire about extra information of the pointcut's target class. Let's say you have an constructor execution pointcut:
-<pre>
-execution(*->new(..))
-</pre>
-</p><p>
-You can add a HAS expression to narrow down the expression to include the execution of any constructor who's class has a method setValue:
-<pre>
-execution(*->new(..)) AND has(void *->setValue(int))
-</pre>
-</p><p>
-You can also do the same with fields. Let's say we also wanted to narrow it down to all classes that have a Thread field:
-</p><p>
-<pre>
-execution(*->new(..)) AND hasfield(java.lang.Thread *.*)
-</pre>
-</p><p>
-<h4>Inversion of Control</h4>
-
-</p><p>
-How is this useful? A usecase is Inversion of Control (IoC). IoC is about injecting an object's depencies transparently. You could define an aspect that intercepted a constructor call, and on the return inject these dependencies into the object. The has operator allows you to do this and this is what the example program does.
-</p><p>
-The example uses the following binding:
-<pre>
- <bind pointcut="execution(*->new(..)) AND has(public void *->setInjectedParameter(int))">
- <interceptor class="DependencyInjectorInterceptor"/>
- </bind>
-</pre>
-</p><p>
-On any constructor call where the constructor's class has a public setInjectedParameter method, call the DependencyInjectorInterceptor. The DependencyInjectorInterceptor will call the constructed object's setInjectedParameter.
-</p><p>
-</p>
-</body>
-</html>
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html (from rev 63480, projects/aop/trunk/aop/docs/examples/ioc_with_has/has.html)
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html (rev 0)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/has.html 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,39 @@
+<html>
+<body>
+<p>
+<h2> The HAS and HASFIELD operator</h2>
+
+</p><p>
+The HAS operator within a pointcut expression allows you to inquire about extra information of the pointcut's target class. Let's say you have an constructor execution pointcut:
+<pre>
+execution(*->new(..))
+</pre>
+</p><p>
+You can add a HAS expression to narrow down the expression to include the execution of any constructor who's class has a method setValue:
+<pre>
+execution(*->new(..)) AND has(void *->setValue(int))
+</pre>
+</p><p>
+You can also do the same with fields. Let's say we also wanted to narrow it down to all classes that have a Thread field:
+</p><p>
+<pre>
+execution(*->new(..)) AND hasfield(java.lang.Thread *.*)
+</pre>
+</p><p>
+<h4>Inversion of Control</h4>
+
+</p><p>
+How is this useful? A usecase is Inversion of Control (IoC). IoC is about injecting an object's depencies transparently. You could define an aspect that intercepted a constructor call, and on the return inject these dependencies into the object. The has operator allows you to do this and this is what the example program does.
+</p><p>
+The example uses the following binding:
+<pre>
+ <bind pointcut="execution(*->new(..)) AND has(public void *->setInjectedParameter(int))">
+ <interceptor class="DependencyInjectorInterceptor"/>
+ </bind>
+</pre>
+</p><p>
+On any constructor call where the constructor's class has a public setInjectedParameter method, call the DependencyInjectorInterceptor. The DependencyInjectorInterceptor will call the constructed object's setInjectedParameter.
+</p><p>
+</p>
+</body>
+</html>
Deleted: projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc_with_has/jboss-aop.xml 2007-06-12 14:43:55 UTC (rev 63476)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<aop>
-
- <bind pointcut="execution(*->new(..)) AND has(public void *->setInjectedParameter(int))">
- <interceptor class="DependencyInjectorInterceptor"/>
- </bind>
-
-</aop>
Copied: projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml (from rev 63480, projects/aop/trunk/aop/docs/examples/ioc_with_has/jboss-aop.xml)
===================================================================
--- projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml (rev 0)
+++ projects/aop/trunk/aop/docs/examples/ioc-with-has/jboss-aop.xml 2007-06-12 18:52:59 UTC (rev 63482)
@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<aop>
+
+ <bind pointcut="execution(*->new(..)) AND has(public void *->setInjectedParameter(int))">
+ <interceptor class="DependencyInjectorInterceptor"/>
+ </bind>
+
+</aop>
More information about the jboss-cvs-commits
mailing list