[jboss-cvs] JBossCache/docs/faq/en ...

Manik Surtani msurtani at jboss.com
Tue Oct 31 20:58:42 EST 2006


  User: msurtani
  Date: 06/10/31 20:58:42

  Modified:    docs/faq/en  Tag: Branch_JBossCache_1_4_0 master.xml
  Log:
  Updated FAQ layout
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.34.2.8  +2166 -2120JBossCache/docs/faq/en/master.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: master.xml
  ===================================================================
  RCS file: /cvsroot/jboss/JBossCache/docs/faq/en/master.xml,v
  retrieving revision 1.34.2.7
  retrieving revision 1.34.2.8
  diff -u -b -r1.34.2.7 -r1.34.2.8
  --- master.xml	1 Nov 2006 00:56:41 -0000	1.34.2.7
  +++ master.xml	1 Nov 2006 01:58:42 -0000	1.34.2.8
  @@ -2,10 +2,10 @@
   <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
           "../../../../docbook-support/support/docbook-dtd/docbookx.dtd"
           >
  -<article class="faq" lang="en">
  -   <articleinfo>
  +<book lang="en">
  +   <bookinfo>
         <title>Frequently Asked Questions about JBoss Cache</title>
  -      <releaseinfo>Release 1.4.1 "Jalapeno"</releaseinfo>
  +      <releaseinfo>Release 1.4.1 "Cayenne"</releaseinfo>
         <pubdate>November 2006</pubdate>
   
         <author>
  @@ -37,14 +37,27 @@
            <surname>Marlow</surname>
            <email>smarlow at novell.com</email>
         </author>
  -   </articleinfo>
   
  -   <para>These are frequently asked questions regarding JBoss Cache.</para>
  +      <abstract>
  +         <para>This is a compilation of the most frequently asked
  +            questions about JBoss Cache. Please report any bugs,
  +            inconsistencies, or omissions you find in this FAQ to
  +            <email>jbosscache-dev at jboss.org</email>
  +            . Please do not mail your questions
  +            to this list. Post them to the
  +            <ulink url="http://www.jboss.org/index.html?module=bb&amp;op=viewforum&amp;f=157">JBoss Cache User Forum
  +            </ulink>
  +            instead.
  +         </para>
  +      </abstract>
  +   </bookinfo>
  +
  +   <chapter id="general">
   
  -   <qandaset defaultlabel="GeneralInformation">
         <title>General Information</title>
  +      <qandaset>
         <qandaentry>
  -         <question id="1">
  +            <question>
               <para>What is JBoss Cache?</para>
            </question>
   
  @@ -79,7 +92,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="2">
  +            <question>
               <para>Who are the JBoss Cache developers?</para>
            </question>
   
  @@ -92,7 +105,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="3">
  +            <question>
               <para>What is the license for JBoss Cache?</para>
            </question>
   
  @@ -105,7 +118,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="4">
  +            <question>
               <para>Where can I download JBoss Cache?</para>
            </question>
   
  @@ -122,7 +135,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="5">
  +            <question>
               <para>How do I build JBoss Cache from CVS sources?</para>
            </question>
   
  @@ -141,13 +154,14 @@
                  this will produce
                  <literal>dist/jboss-cache-dist.zip</literal>
                  Note that you will need to
  -               use JDK 5.0 to build the distribution. You can still use the binaries you build with J2SE 1.4.x though.
  +                  use JDK 5.0 to build the distribution. You can still use the binaries you build with J2SE 1.4.x
  +                  though.
               </para>
            </answer>
         </qandaentry>
   
         <qandaentry>
  -         <question id="6">
  +            <question>
               <para>Which JVMs are supported by JBoss Cache?</para>
            </question>
   
  @@ -160,7 +174,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="7">
  +            <question>
               <para>From JBoss Cache 1.3.0 onwards, there is a new directory
                  <code>lib-50</code>
                  ,
  @@ -188,7 +202,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="8">
  +            <question>
               <para>How do I know the version of JBoss Cache that I am using?</para>
            </question>
   
  @@ -201,7 +215,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="9">
  +            <question>
               <para>Can I run JBoss Cache outside of JBoss Application
                  Server?
               </para>
  @@ -226,7 +240,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="10">
  +            <question>
               <para>Where can I report bugs or problems?</para>
            </question>
   
  @@ -241,12 +255,12 @@
            </answer>
         </qandaentry>
      </qandaset>
  -
  -   <qandaset defaultlabel="TreeCache">
  -      <title>JBoss Cache in general and TreeCache</title>
  -
  +   </chapter>
  +   <chapter id="Tree Cache">
  +      <title>JBoss Cache - Tree Cache</title>
  +      <qandaset>
         <qandaentry>
  -         <question id="11">
  +            <question>
               <para>How do I deploy JBoss Cache as a MBean service?</para>
            </question>
   
  @@ -267,7 +281,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="12">
  +            <question>
               <para>How do I know if my JBoss Cache MBean has been deployed?</para>
            </question>
   
  @@ -282,7 +296,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="13">
  +            <question>
               <para>How do I access the JBoss Cache MBean?</para>
            </question>
   
  @@ -336,7 +350,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="14">
  +            <question>
               <para>Can I run JBoss Cache on JBoss AS 3.2.x releases?</para>
            </question>
   
  @@ -349,7 +363,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="15">
  +            <question>
               <para>Can I run multiple JBoss Cache instances on the same VM?</para>
            </question>
   
  @@ -364,7 +378,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="16">
  +            <question>
               <para>Can TreeCache run as a second level cache inside
                  Hibernate?
               </para>
  @@ -387,7 +401,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="17">
  +            <question>
               <para>What about using PojoCache as a Hibernate cache?</para>
            </question>
   
  @@ -401,7 +415,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="18">
  +            <question>
               <para>How can I configure JBoss Cache?</para>
            </question>
   
  @@ -414,7 +428,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="19">
  +            <question>
               <para>In the configuration xml file, there are tags such as
                  <literal>class</literal>
                  ,
  @@ -436,7 +450,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="20">
  +            <question>
               <para>What is the difference between the different cache
                  modes?
               </para>
  @@ -463,7 +477,8 @@
                  .
                  For asynchronous replication, use
                  <literal>AYSNC_REPL</literal>
  -               . If you do not wish to replicate cached data but simply inform other caches in a cluster that data under
  +                  . If you do not wish to replicate cached data but simply inform other caches in a cluster that data
  +                  under
                  specific addresses are now stale and should be evicted from memory, use
                  <literal>INVALIDATION_SYNC</literal>
                  or
  @@ -477,13 +492,14 @@
                  <literal>INVALIDATION_ASYNC</literal>
                  are non-blocking. This
                  can be useful when you want to have another JBoss Cache serving as a
  -               mirror or backup and you don't want to wait for confirmation that this mirror has received your messages.
  +                  mirror or backup and you don't want to wait for confirmation that this mirror has received your
  +                  messages.
               </para>
            </answer>
         </qandaentry>
   
         <qandaentry>
  -         <question id="21">
  +            <question>
               <para>How does JBoss Cache's replication mechanism work?</para>
            </question>
   
  @@ -511,7 +527,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="22">
  +            <question>
               <para>I run a 2 node cluster. If the network dies, do the caches continue to run?</para>
            </question>
   
  @@ -528,20 +544,21 @@
   
   
         <qandaentry>
  -         <question id="23">
  +            <question>
               <para>Can I plug in library X instead of JGroups to handle remote calls and group communications?</para>
            </question>
   
            <answer>
               <para>At this stage (JBoss Cache 1.x) the answer is no. We do have an abstraction layer between the
  -               communication suite and JBoss Cache in the pipelines, and this may appear as a feature at some stage in
  +                  communication suite and JBoss Cache in the pipelines, and this may appear as a feature at some stage
  +                  in
                  the future.
               </para>
            </answer>
         </qandaentry>
   
         <qandaentry>
  -         <question id="24">
  +            <question>
               <para>Does the cache need to replicate to every other instance in the cluster? Isn't this slow if the
                  cluster is large?
               </para>
  @@ -555,14 +572,15 @@
                  very easily with no extra impact on memory or network traffic with each node added.
               </para>
               <para>
  -               See the User Guide for more information on Buddy Replication, and how it can be used to achieve very high
  +                  See the User Guide for more information on Buddy Replication, and how it can be used to achieve very
  +                  high
                  scalability.
               </para>
            </answer>
         </qandaentry>
   
         <qandaentry>
  -         <question id="25">
  +            <question>
               <para>If I have the need for different TreeCache properties (e.g.,
                  <literal>CacheMode</literal>
                  and
  @@ -581,7 +599,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="26">
  +            <question>
               <para>Does the Tree Cache config
                  <literal>ClusterName</literal>
                  have
  @@ -600,7 +618,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="27">
  +            <question>
               <para>When using multiple JGroups based components
                  [cluster-service.xml, treecache (multiple instances)], what is the
                  correct/valid way to configure those components to make sure my
  @@ -620,7 +638,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="28">
  +            <question>
               <para>Does JBoss Cache currently support cache persistence
                  storage?
               </para>
  @@ -634,7 +652,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="29">
  +            <question>
               <para>Does JBoss Cache currently support cache passivation/ overflow
                  to a data store?
               </para>
  @@ -649,7 +667,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="30">
  +            <question>
               <para>Is JBoss Cache thread safe?</para>
            </question>
   
  @@ -659,7 +677,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="31">
  +            <question>
               <para>Does JBoss Cache support XA (2PC) transactions now?</para>
            </question>
   
  @@ -672,7 +690,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="32">
  +            <question>
               <para>Which TransactionManagers are supported by
                  JBoss Cache?
               </para>
  @@ -696,7 +714,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="33">
  +            <question>
               <para>How do I set up the cache to be transactional?</para>
            </question>
   
  @@ -733,7 +751,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="34">
  +            <question>
               <para>How do I control the cache locking level?</para>
            </question>
   
  @@ -755,7 +773,8 @@
                  <literal>REPEATABLE_READ</literal>
                  , and
                  <literal>SERIALIZABLE</literal>
  -               . Note that these isolation levels are ignored if optimistic locking is used. For details, please refer
  +                  . Note that these isolation levels are ignored if optimistic locking is used. For details, please
  +                  refer
                  to the
                  user manual.
               </para>
  @@ -763,13 +782,14 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="35">
  +            <question>
               <para>How does JBoss Cache lock data for concurrent access?</para>
            </question>
   
            <answer>
               <para>By default JBoss Cache uses pessimistic locking to lock data nodes, based on the isolation level
  -               configured. Since JBoss Cache 1.3.0, we also offer optimistic locking to allow for greater concurrency at
  +                  configured. Since JBoss Cache 1.3.0, we also offer optimistic locking to allow for greater concurrency
  +                  at
                  the cost of slight processing overhead and performance. See the documentation for a more detailed
                  discussion on concurrency and locking in JBoss Cache.
               </para>
  @@ -778,7 +798,7 @@
   
   
         <qandaentry>
  -         <question id="36">
  +            <question>
               <para>How do I enable Optimistic Locking in JBoss Cache?</para>
            </question>
   
  @@ -802,7 +822,7 @@
   
   
         <qandaentry>
  -         <question id="37">
  +            <question>
               <para>How does the write lock apply to an Fqn node, say,
                  "/org/jboss/test"?
               </para>
  @@ -827,7 +847,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="38">
  +            <question>
               <para>Can I use the cache locking level even without a transaction
                  context?
               </para>
  @@ -846,7 +866,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="39">
  +            <question>
               <para>With replication (REPL_SYNC/REPL_ASYNC) or invalidation (INVALIDATION_SYNC/INVALIDATION_ASYNC), how
                  often does the cache broadcast messages over the network?
               </para>
  @@ -865,7 +885,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="40">
  +            <question>
               <para>How can I do a mass removal?</para>
            </question>
   
  @@ -877,12 +897,13 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="41">
  +            <question>
               <para>Can I monitor and manage the JBoss Cache?</para>
            </question>
   
            <answer>
  -            <para>With JBoss Cache 1.3.0, you can if you are running JBoss Cache within JBoss AS or are using JDK 5.0's
  +               <para>With JBoss Cache 1.3.0, you can if you are running JBoss Cache within JBoss AS or are using JDK
  +                  5.0's
                  <literal>jconsole</literal>
                  utility. See the chapter titled
                  <emphasis role="bold">Management Information</emphasis>
  @@ -892,7 +913,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="42">
  +            <question>
               <para>Can I disable JBoss Cache management attributes in JBoss Cache 1.3.0?</para>
            </question>
   
  @@ -911,7 +932,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="43">>
  +            <question>>
               <para>What is jboss-serialization.jar, introduced in JBoss Cache 1.4.x and do I need this?</para>
            </question>
            <answer>
  @@ -920,7 +941,8 @@
                     JBoss Serialization
                  </ulink>
                  library, which is much more efficient in terms
  -               of speed and CPU usage as well as the generated byte stream size than standard Java serialization. This
  +                  of speed and CPU usage as well as the generated byte stream size than standard Java serialization.
  +                  This
                  very
                  significantly improves replication performance of custom objects placed in the cache.
               </para>
  @@ -931,7 +953,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="44">
  +            <question>
               <para>Can I disable JBoss Serialization and revert back to standard Java serialization?</para>
            </question>
   
  @@ -945,7 +967,7 @@
   
   
         <qandaentry>
  -         <question id="45">
  +            <question>
               <para>Does JBoss Cache support partitioning?</para>
            </question>
   
  @@ -959,7 +981,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="46">
  +            <question>
               <para>Does JBoss Cache handle the concept of application classloading
                  inside, say, a J2EE container?
               </para>
  @@ -1060,7 +1082,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="47">
  +            <question>
               <para>Does JBoss Cache currently support pre-event and post-event
                  notification?
               </para>
  @@ -1077,7 +1099,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="48">
  +            <question>
               <para>How do I implement a custom listener to listen to
                  <literal>TreeCache</literal>
                  events?
  @@ -1113,12 +1135,15 @@
            </answer>
         </qandaentry>
      </qandaset>
  +   </chapter>
  +   <chapter
  +           id="PojoCache">
  +      <title>JBoss Cache - Pojo Cache</title>
  +      <qandaset>
   
  -   <qandaset defaultlabel="PojoCache">
  -      <title>PojoCache</title>
   
         <qandaentry>
  -         <question id="49">
  +            <question>
               <para>What is PojoCache?</para>
            </question>
   
  @@ -1149,7 +1174,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="50">
  +            <question>
               <para>What's the relationship between PojoCache and TreeCacheAop classes?</para>
            </question>
   
  @@ -1161,7 +1186,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="51">
  +            <question>
               <para>Does PojoCache have all the functional capabilities of
                  TreeCache?
               </para>
  @@ -1176,7 +1201,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="52">
  +            <question>
               <para>What is the difference between TreeCache and
                  PojoCache?
               </para>
  @@ -1203,7 +1228,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="53">
  +            <question>
               <para>What are the steps to use the PojoCache feature?</para>
            </question>
   
  @@ -1216,7 +1241,8 @@
               <itemizedlist>
                  <listitem>
                     <para>prepare POJO. You can do either via xml declaration or annotation. For annotation, you can
  -                     use either the JDK1.4 style or JDK50 one (of which is part of JVM spec). If you use JDK14, you will
  +                        use either the JDK1.4 style or JDK50 one (of which is part of JVM spec). If you use JDK14, you
  +                        will
                        also need
                        a annotation pre-compiler (annoc) to pre-process it.
                     </para>
  @@ -1231,7 +1257,8 @@
                     </para>
                  </listitem>
               </itemizedlist>
  -            <para>So if you use JDK50, for example, with annotation and load-time instrumentation, then you won't need
  +               <para>So if you use JDK50, for example, with annotation and load-time instrumentation, then you won't
  +                  need
                  any pre-processing step to use PojoCache. For a full example, please refer to the distro examples
                  directory.
                  There are numerous PojoCache examples that uses different options.
  @@ -1240,7 +1267,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="54">
  +            <question>
               <para>Can I run PojoCache in JBoss AS 3.2.x application
                  server?
               </para>
  @@ -1256,7 +1283,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="55">
  +            <question>
               <para>Can PojoCache run as a MBean as well?</para>
            </question>
   
  @@ -1275,7 +1302,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="56">
  +            <question>
               <para>Can I pre-compile the aop classes such that I don't need to
                  use the system classloader and jboss-aop configuration xml?
               </para>
  @@ -1313,7 +1340,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="57">
  +            <question>
               <para>How do I use aopc on multiple module directories?</para>
            </question>
   
  @@ -1326,7 +1353,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="58">
  +            <question>
               <para>What's in the
                  <literal>jboss-aop.xml</literal>
                  configuration?
  @@ -1359,7 +1386,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="59">
  +            <question>
               <para>Can I use annotation instead of the xml declaration?</para>
            </question>
   
  @@ -1371,21 +1398,23 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="60">
  +            <question>
               <para>What are the pro and con of xml vs. annotation?</para>
            </question>
   
            <answer>
               <para>It really depends on your organization environment, I'd say, since this can be turned into a
  -               hot debate. Having said that, I feel strongly that POJO annotation is well suited for PojoCache. This is
  -               because once you specify the annotation, you'd probably change it rarely since there is no parameters to
  +                  hot debate. Having said that, I feel strongly that POJO annotation is well suited for PojoCache. This
  +                  is
  +                  because once you specify the annotation, you'd probably change it rarely since there is no parameters
  +                  to
                  tune, for example.
               </para>
            </answer>
         </qandaentry>
   
         <qandaentry>
  -         <question id="61">
  +            <question>
               <para>What are the
                  <literal>@org.jboss.cache.aop.annotation.Transient</literal>
                  and
  @@ -1414,13 +1443,14 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="62">
  +            <question>
               <para>What about compile-time vs. load-time instrumentation then?</para>
            </question>
   
            <answer>
               <para>Again it depends. But my preference is to do compile-time instrumentation via aopc. I prefer this
  -               approach because it is easier to debug (at least at the development stage). In addition, once I generate
  +                  approach because it is easier to debug (at least at the development stage). In addition, once I
  +                  generate
                  the
                  new class, there is no more steps needed.
               </para>
  @@ -1428,7 +1458,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="63">
  +            <question>
               <para>Is it possible to store the same object multiple times but
                  with different Fqn paths? Like /foo/byName and /foo/byId ?
               </para>
  @@ -1443,7 +1473,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="64">
  +            <question>
               <para>Do I need to declare all my objects "prepared" in
                  <literal>jboss-aop.xml</literal>
                  ?
  @@ -1462,7 +1492,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="65">
  +            <question>
               <para>Can the cache aop intercept update via reflection?</para>
            </question>
   
  @@ -1475,7 +1505,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="66">
  +            <question>
               <para>When I declare my POJO to be "aspectized", what happens to the
                  fields with transient, static, and final modifiers?
               </para>
  @@ -1490,7 +1520,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="67">
  +            <question>
               <para>What are those keys such as
                  <literal>JBoss:internal:class</literal>
                  and
  @@ -1507,7 +1537,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="68">
  +            <question>
               <para>What about Collection classes? Do I need to declare them
                  "prepared"?
               </para>
  @@ -1540,7 +1570,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="69">
  +            <question>
               <para>How do I use
                  <literal>List</literal>
                  ,
  @@ -1580,7 +1610,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="70">
  +            <question>
               <para>What is the proper way of assigning two different keys with
                  Collection class object?
               </para>
  @@ -1610,7 +1640,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="71">
  +            <question>
               <para>OK, so I know I am supposed to use proxy when manipulating the
                  Collection classes once they are managed by the cache. But what
                  happens to Pojos that share the Collection objects, e.g., a
  @@ -1630,7 +1660,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="72">
  +            <question>
               <para>What happens when my "aspectized" POJO has field members that
                  are of Collection class ?
               </para>
  @@ -1654,7 +1684,7 @@
   
   
         <qandaentry>
  -         <question id="73">
  +            <question>
               <para>What are the limitation of Collection classes in PojoCache?</para>
            </question>
   
  @@ -1671,9 +1701,11 @@
                  to java.util.ArrayList implementation. The Map interface maps to java.util.HashMap
                  implementation.
               </para>
  -            <para>Another related issue is the expected performance. For example, the current implementation is ordered,
  +               <para>Another related issue is the expected performance. For example, the current implementation is
  +                  ordered,
                  so
  -               that makes insert/delete from the Collection slow. Performance between Set, Map and List collections also
  +                  that makes insert/delete from the Collection slow. Performance between Set, Map and List collections
  +                  also
                  vary.
                  Adding items to a Set is slower than a List or Map, since Set does not allow duplicate entries.
               </para>
  @@ -1682,7 +1714,7 @@
   
   
         <qandaentry>
  -         <question id="74">
  +            <question>
               <para>What are the pros and cons of PojoCache?</para>
            </question>
   
  @@ -1734,12 +1766,15 @@
            </answer>
         </qandaentry>
      </qandaset>
  -
  -   <qandaset defaultlabel="EvictionPolicies">
  +   </chapter>
  +   <chapter id="eviction">
         <title>Eviction Policies</title>
   
  +      <qandaset>
  +
  +
         <qandaentry>
  -         <question id="75">
  +            <question>
               <para>Does JBoss Cache support eviction policies?</para>
            </question>
   
  @@ -1764,7 +1799,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="76">
  +            <question>
               <para>Why can't I use
                  <literal>org.jboss.cache.eviction.LRUPolicy</literal>
                  for
  @@ -1783,7 +1818,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="77">
  +            <question>
               <para>Does JBoss Cache's implemented LRU eviction policy operates in
                  replication mode?
               </para>
  @@ -1822,7 +1857,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="78">
  +            <question>
               <para>Does JBoss Cache support
                  <literal>Region</literal>
                  ?
  @@ -1854,7 +1889,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="79">
  +            <question>
               <para>What are the
                  <literal>EvictionPolicyConfig</literal>
                  tag
  @@ -1867,6 +1902,7 @@
            <answer>
               <para>They are:</para>
   
  +
               <table>
                  <title>Parameters</title>
   
  @@ -1912,7 +1948,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="80">
  +            <question>
               <para>I have turned on the eviction policy, why do I still get "out
                  of memory" (OOM) exception?
               </para>
  @@ -1939,12 +1975,15 @@
            </answer>
         </qandaentry>
      </qandaset>
  -
  -   <qandaset defaultlabel="CacheLoaders">
  +   </chapter>
  +   <chapter id="cacheloaders">
         <title>Cache Loaders</title>
   
  +      <qandaset>
  +
  +
         <qandaentry>
  -         <question id="81">
  +            <question>
               <para>What is a CacheLoader?</para>
            </question>
   
  @@ -1988,13 +2027,15 @@
                           transactional database. It uses a single file for the entire
                           store. Note that if you use Sleepycat's CacheLoader with
                           JBoss Cache and wish to ship your product, you will have to acquire a
  -                        <ulink url="http://www.sleepycat.com/jeforjbosscache">commercial license from Sleepycat</ulink>
  +                           <ulink url="http://www.sleepycat.com/jeforjbosscache">commercial license from Sleepycat
  +                           </ulink>
                           .
                        </para>
                     </listitem>
   
                     <listitem>
  -                     <para>JDBCCacheLoader: this implementation uses the relational database as the persistent storage.
  +                        <para>JDBCCacheLoader: this implementation uses the relational database as the persistent
  +                           storage.
                        </para>
                     </listitem>
   
  @@ -2013,7 +2054,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="82">
  +            <question>
               <para>Can writing to CacheLoaders be asynchronous?</para>
            </question>
   
  @@ -2027,7 +2068,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="83">
  +            <question>
               <para>Can I write my own CacheLoader ?</para>
            </question>
   
  @@ -2042,7 +2083,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="84">
  +            <question>
               <para>Does a CacheLoader have to use a persistent store ?</para>
            </question>
   
  @@ -2058,7 +2099,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="85">
  +            <question>
               <para>What can I use a CacheLoader for?</para>
            </question>
   
  @@ -2109,7 +2150,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="86">
  +            <question>
               <para>How do I configure JBossCache with a CacheLoader?</para>
            </question>
   
  @@ -2123,7 +2164,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="87">
  +            <question>
               <para>Do I have to pay to use Sleepycat's CacheLoader?</para>
            </question>
   
  @@ -2140,7 +2181,7 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="88">
  +            <question>
               <para>Can I use more than one cache loader?</para>
            </question>
   
  @@ -2158,8 +2199,9 @@
         </qandaentry>
   
         <qandaentry>
  -         <question id="89">
  -            <para>Why do cache loaders go into an inconsistent state when I use transactions, pessimistic locking, and I
  +            <question>
  +               <para>Why do cache loaders go into an inconsistent state when I use transactions, pessimistic locking,
  +                  and I
                  attempt to read a node after removing it from within the same transaction scope?
               </para>
            </question>
  @@ -2169,7 +2211,8 @@
                  <ulink url="http://jira.jboss.com/jira/browse/JBCACHE-477">JBCACHE-477</ulink>
                  and
                  <ulink url="http://jira.jboss.com/jira/browse/JBCACHE-352">JBCACHE-352</ulink>
  -               ), which have been fixed in JBoss Cache 1.4.0. A very simple workaround if you're using JBoss Cache 1.3.x
  +                  ), which have been fixed in JBoss Cache 1.4.0. A very simple workaround if you're using JBoss Cache
  +                  1.3.x
                  is to use optimistic locking.
               </para>
               <para>
  @@ -2182,11 +2225,13 @@
   
   
      </qandaset>
  -
  -   <qandaset defaultlabel="Troubleshooting">
  +   </chapter>
  +   <chapter id="troubleshooting">
         <title>Troubleshooting</title>
  +      <qandaset>
  +
         <qandaentry>
  -         <question id="90">
  +            <question>
               <para>I am having problems getting JBoss Cache to work, where can I get information on troubleshooting?
               </para>
            </question>
  @@ -2198,4 +2243,5 @@
            </answer>
         </qandaentry>
      </qandaset>
  -</article>
  +   </chapter>
  +</book>
  \ No newline at end of file
  
  
  



More information about the jboss-cvs-commits mailing list