[jboss-cvs] JBossCache/src-50/resources ...
Ben Wang
bwang at jboss.com
Mon Sep 25 22:41:47 EDT 2006
User: bwang
Date: 06/09/25 22:41:47
Modified: src-50/resources pojocache-aop.xml
Log:
upd
Revision Changes Path
1.3 +42 -24 JBossCache/src-50/resources/pojocache-aop.xml
(In the diff below, changes in quantity of whitespace are not shown.)
Index: pojocache-aop.xml
===================================================================
RCS file: /cvsroot/jboss/JBossCache/src-50/resources/pojocache-aop.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -b -r1.2 -r1.3
--- pojocache-aop.xml 24 Sep 2006 08:18:41 -0000 1.2
+++ pojocache-aop.xml 26 Sep 2006 02:41:47 -0000 1.3
@@ -1,42 +1,61 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
- This is the pojocache configuration file to use the jboss aop library.
+ This is the PojoCache configuration file that specifies:
+ 1. Interceptor stack for API
+ 2. Annotation binding for POJO (via "prepare" element)
+
+ Basically, this is a variant of jboss-aop.xml. Note that
+ except for the customization of interceptor stack, you should
+ not need to modify this file.
+
To run PojoCache, you will need to define a system property:
- jboss.aop.path that contains the path to this file.
+ jboss.aop.path that contains the path to this file such that JBoss Aop
+ can locate it.
-->
<aop>
<!--
This defines the PojoCache 2.0 interceptor stack. Unless necessary, don't modify the stack here!
-->
+
<!-- Check id range validity -->
- <interceptor name="CheckId" class="org.jboss.cache.pojo.interceptors.CheckIdInterceptor" scope="PER_INSTANCE"/>
+ <interceptor name="CheckId" class="org.jboss.cache.pojo.interceptors.CheckIdInterceptor"
+ scope="PER_INSTANCE"/>
<!-- Track Tx undo operation -->
- <interceptor name="Undo" class="org.jboss.cache.pojo.interceptors.PojoTxUndoInterceptor" scope="PER_INSTANCE"/>
+ <interceptor name="Undo" class="org.jboss.cache.pojo.interceptors.PojoTxUndoInterceptor"
+ scope="PER_INSTANCE"/>
- <!-- Begining -->
- <interceptor name="Start" class="org.jboss.cache.pojo.interceptors.PojoBeginInterceptor" scope="PER_INSTANCE"/>
+ <!-- Begining of interceptor chain -->
+ <interceptor name="Start" class="org.jboss.cache.pojo.interceptors.PojoBeginInterceptor"
+ scope="PER_INSTANCE"/>
<!-- Check if we need a local tx for batch processing -->
- <interceptor name="Tx" class="org.jboss.cache.pojo.interceptors.PojoTxInterceptor" scope="PER_INSTANCE"/>
+ <interceptor name="Tx" class="org.jboss.cache.pojo.interceptors.PojoTxInterceptor"
+ scope="PER_INSTANCE"/>
- <!-- Mockup failed tx for testing -->
- <interceptor name="MockupTx" class="org.jboss.cache.pojo.interceptors.PojoFailedTxMockupInterceptor" scope="PER_INSTANCE"/>
+ <!--
+ Mockup failed tx for testing. You will need to set PojoFailedTxMockupInterceptor.setRollback(true)
+ to activate it.
+ -->
+ <interceptor name="MockupTx" class="org.jboss.cache.pojo.interceptors.PojoFailedTxMockupInterceptor"
+ scope="PER_INSTANCE"/>
<!-- Perform parent level node locking -->
- <interceptor name="TxLock" class="org.jboss.cache.pojo.interceptors.PojoTxLockInterceptor" scope="PER_INSTANCE"/>
+ <interceptor name="TxLock" class="org.jboss.cache.pojo.interceptors.PojoTxLockInterceptor"
+ scope="PER_INSTANCE"/>
<!-- Interceptor to perform Pojo level rollback -->
<interceptor name="TxUndo" class="org.jboss.cache.pojo.interceptors.PojoTxUndoSynchronizationInterceptor"
scope="PER_INSTANCE"/>
- <!-- Interceptor to perform Pojo level rollback -->
+ <!-- Interceptor to used to check recursive field interception. -->
<interceptor name="Reentrant" class="org.jboss.cache.pojo.interceptors.MethodReentrancyStopperInterceptor"
scope="PER_INSTANCE"/>
- <!-- Whether to allow non-serializable pojo -->
- <interceptor name="MarshallNonSerializable" class="org.jboss.cache.pojo.interceptors.CheckNonSerializableInterceptor"
+ <!-- Whether to allow non-serializable pojo. Default is false. -->
+ <interceptor name="MarshallNonSerializable"
+ class="org.jboss.cache.pojo.interceptors.CheckNonSerializableInterceptor"
scope="PER_INSTANCE">
<attribute name="marshallNonSerializable">false</attribute>
</interceptor>
@@ -47,7 +66,7 @@
<interceptor-ref name="CheckId"/>
<interceptor-ref name="MarshallNonSerializable"/>
<interceptor-ref name="Tx"/>
- <!-- NOTE: Comment this out during production!! MockupTx is for testing only. -->
+ <!-- NOTE: You can comment this out during production although leaving it here is OK. -->
<interceptor-ref name="MockupTx"/>
<interceptor-ref name="TxLock"/>
<interceptor-ref name="TxUndo"/>
@@ -57,7 +76,7 @@
<interceptor-ref name="Start"/>
<interceptor-ref name="CheckId"/>
<interceptor-ref name="Tx"/>
- <!-- NOTE: Comment this out during production!! MockupTx is for testing only. -->
+ <!-- NOTE: You can comment this out during production although leaving it here is OK. -->
<interceptor-ref name="MockupTx"/>
<interceptor-ref name="TxLock"/>
<interceptor-ref name="TxUndo"/>
@@ -69,9 +88,10 @@
</stack>
<!--
- The following section should be READ-ONLY!!
+ The following section should be READ-ONLY!! It defines the annotation binding to the stack.
-->
- <!-- This bind the jointpoint to specific in-memory operations. Currently in PojoUtil. -->
+
+ <!-- This binds the jointpoint to specific in-memory operations. Currently in PojoUtil. -->
<bind pointcut="execution(*
@org.jboss.cache.pojo.annotation.Reentrant->toString())">
<interceptor-ref name="Reentrant"/>
@@ -95,15 +115,13 @@
</bind>
- <!-- This is declaration file for JDK50 annotation.
- Idea is user will then need only to annotate like:
+ <!--
+ Following is declaration for JDK50 annotation. You use the specific annotation on your
+ POJO such that it can be instrumented. Idea is user will then need only to annotate like:
@org.jboss.cache.pojo.annotation.PojoCacheable
in his POJO. There will be no need of jboss-aop.xml from user's side.
-
- For example, see either Address or Person.
-->
- <!-- PojoCache 2.0 style -->
<!-- If a POJO has PojoCachable annotation, it will be asepctized. -->
<prepare expr="field(* @org.jboss.cache.pojo.annotation.PojoCacheable->*)" />
@@ -138,7 +156,7 @@
</introduction>
- <!-- PojoCache 1.4. Is deprecated. Will be removed in 2.1 release -->
+ <!-- PojoCache 1.4. Is deprecated. Will be removed in the future -->
<!-- This is declaration file for annotation. We are using JDK1.4 now,
so an annotationc pre-compiler is needed for JBossAop.
See build.xml target annoc for details.
More information about the jboss-cvs-commits
mailing list