In this folder can be found a number of examples illustrating how to use
JBossCacheAop (POJO Cache).  Two different sample applications are provided, and
different mechanisms for instrumenting the classes in the applications' domain
model are shown.

In the "sensor" subdirectory, an application that uses JBossCacheAop to model
the state of sensor network on a high speed rail line is shown.  This example
uses JDK 1.4 style annotations, with annoc and aopc used to instrument
the classes before deployment.  The example will be further examined in a
forthcoming issue of OnJava.

The "sensor" example also allows a user to use beanshell to manipulate the
objects in the cache.

In the "annotated50", "annotated14", "non-annotated" and "loadtime" subdirectories,
the example application illustrates using JBossCacheAop (PojoCache) to replicate
over a cluster state information about students and the courses they take.  The
different versions of the example illustrate different mechanisms for
instrumenting the domain model classes for use in JBossCacheAop.

In the "annotated50" example, JDK50 annotation are used (therefore JDK50 is required).
You can either run it directly (through loadtime mode) or using aopc first (compile
time mode). Of course, the annotation has to be attached to the POJOs first. Then,
there is another system-wide "jboss-aop.xml" that is needed but is read-only.

In the "annotated14" example, JDK 1.4 style annotation are used, with
annoc and aopc used to pre-compile the classes.  Because annotations are
used, a standardized jboss-aop.xml can be used to drive aopc.

In the "non-annotated" example, no annotations are used, although aopc
pre-compilation is still used.  In this example, the jboss-aop.xml file used
to drive aopc needs to specifically describe how to instrument the classes in
the domain model.

In the "loadtime" example, no pre-compilation is performed -- the domain model
classes are instrumented at load time. Again, in this example, the jboss-aop.xml
file used to drive aopc needs to specifically describe how to instrument the
classes in the domain model.

See the "readme.txt" file in each subdirectory for more on how to use that
particular example.
