From: Manik S. <msu...@jb...> - 2006-07-10 14:50:07
|
User: msurtani Date: 06/07/10 10:50:02 Modified: docs/tutorial/en master.xml Log: merged in changes from 1.4.0 Revision Changes Path 1.14 +68 -71 JBossCache/docs/tutorial/en/master.xml (In the diff below, changes in quantity of whitespace are not shown.) Index: master.xml =================================================================== RCS file: /cvsroot/jboss/JBossCache/docs/tutorial/en/master.xml,v retrieving revision 1.13 retrieving revision 1.14 diff -u -b -r1.13 -r1.14 --- master.xml 29 Apr 2006 07:31:51 -0000 1.13 +++ master.xml 10 Jul 2006 14:50:02 -0000 1.14 @@ -2,9 +2,8 @@ <article lang="en"> <articleinfo> <title>JBossCache TreeCache and PojoCache Tutorial</title> - <releaseinfo>Release 1.4.0 "Jalapeno"</releaseinfo> - <pubdate>May 2006</pubdate> - +<releaseinfo>Release 1.4.0 "Jalapeno"</releaseinfo> + <pubdate>July 2006</pubdate> <author> <firstname>Ben</firstname> <surname>Wang</surname> @@ -27,8 +26,8 @@ In this tutorial, we will demonstrate the usage of both cache features. For details of the usage and APIs, please refer to the user manuals for <ulink - url="http://www.jboss.org/products/jbosscache/docs">TreeCache</ulink> and <ulink - url="http://www.jboss.org/products/jbosscache/docs">PojoCache</ulink>.</para> + url="http://labs.jboss.org/portal/jbosscache/docs/index.html">TreeCache</ulink> and <ulink + url="http://labs.jboss.org/portal/jbosscache/docs/index.html">PojoCache</ulink>.</para> </section> <section> @@ -57,7 +56,7 @@ <title>Configuration</title> <para>First download the standalone TreeCache code from <ulink - url="http://www.jboss.com/products/jbosscache/downloads">here</ulink>. + url="http://labs.jboss.org/portal/jbosscache/download/index.html">here</ulink>. Unzip it, and you will get a root directory (jboss-cache in our example).</para> @@ -67,13 +66,13 @@ <itemizedlist> <listitem> - <para>log4j.xml. Logging output. You can turn on logging level or + <para><literal>log4j.xml</literal>. Logging output. You can turn on logging level or change log file directory (default is - <literal>/tmp/test.log</literal>).</para> + <literal>/tmp/jbosscache.log</literal>).</para> </listitem> <listitem> - <para>replSync-service.xml. Tree cache configuration file (file name + <para><literal>replSync-service.xml</literal>. Tree cache configuration file (file name is not fixed. You specify the file to be read in in <literal>PropertyConfigurator</literal>). The settings are for a replicated, synchronous, and transactional cache. The default @@ -86,7 +85,7 @@ </listitem> <listitem> - <para>jboss-aop.xml. AOP pointcut and advice definition for the + <para><literal>jboss-aop.xml</literal>. AOP pointcut and advice definition for the example POJO classes, Person and Address, respectively. For details of how to put your own class under AOP, please refer to the <ulink url="http://www.jboss.org/products/jbosscache/docs">PojoCache</ulink>. This file is read in @@ -103,7 +102,7 @@ <itemizedlist> <listitem> - <para>build.sh (or build.bat for DOS). Simple build script that wraps + <para><literal>build.sh</literal> (or <literal>build.bat</literal> for DOS/Windows). Simple build script that wraps around ant. Users can simply type <literal>sh build.sh</literal> for help. Note from now on, we will only refer to the Unix version with the understanding that there is a corresponding DOS counterpart. The @@ -111,24 +110,24 @@ </listitem> <listitem> - <para>runDemoShell.sh. Simple run script that wraps around BeanShell. + <para><literal>runDemoShell.sh</literal>. Simple run script that wraps around BeanShell. This is used to operate the replicated cache through interactive command line.</para> </listitem> <listitem> - <para>plain.bsh. Java codes that instantiate and configure the cache. + <para><literal>plain.bsh</literal>. Java code that instantiate and configure the cache. It also creates an example cache entry.</para> </listitem> <listitem> - <para>aop.bsh. Java codes that instantiate and configure the aop + <para><literal>aop.bsh</literal>. Java codes that instantiate and configure the aop cache. In addition, it also sets up the example POJO (plaing old Java object) classes (e.g., Person and Address).</para> </listitem> <listitem> - <para>aopWithTx.bsh. Same with aop.bsh except it also instantiates a + <para><literal>aopWithTx.bsh</literal>. Same with aop.bsh except it also instantiates a transaction context.</para> </listitem> </itemizedlist> @@ -185,9 +184,6 @@ <itemizedlist> <listitem>For each demo example, it'd be best if you re-start the whole setup.</listitem> - <listitem>IMPORTANT: When you do an update on the BSH window, you will need to refresh the GUI manually. This is - usually done by clicking on other node in the GUI and then click back to the one that you are interested - in</listitem> <listitem>While you can modify the cache content on the GUI window and it will show up on the BSH cache content (e.g., through <literal>cache.printDetails()</literal>), this won't work on PojoCache demo. That is, you can only modify the cache content on the BSH window.</listitem> @@ -377,7 +373,8 @@ </programlisting> <para>Then start the beanshell and source <literal>oodb.bsh</literal> - into it:</para> + into it. Note that <literal>oodb.bsh</literal> already contains code to create and retrieve POJO + from the cache. So remember to comment them out if you decide to create the Person instance yourself.</para> <programlisting>bela@laptop /cygdrive/c/jboss-cache $ ./runShellDemo.sh |