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

[Manik Surtani]

  User: msurtani
  Date: 07/03/30 13:22:07

  Modified:    docs/faq/en  master.xml
  Log:
  JBCACHE-807
  
  Revision  Changes    Path
  1.45      +37 -5     JBossCache/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.44
  retrieving revision 1.45
  diff -u -b -r1.44 -r1.45
  --- master.xml	26 Mar 2007 13:30:03 -0000	1.44
  +++ master.xml	30 Mar 2007 17:22:07 -0000	1.45
  @@ -1446,6 +1446,38 @@
   
            <qandaentry>
               <question>
  +               <para>Is the FileCacheLoader recommended for production use?</para>
  +            </question>
  +
  +            <answer>
  +               <para>
  +                  No, it is not. The FileCacheLoader has some severe limitations which restrict it's use in a production
  +                  environment, or if used in such an environment, it should be used with due care and sufficient
  +                  understanding of these limitations.
  +                  <itemizedlist>
  +                     <listitem>Due to the way the FileCacheLoader represents a tree structure on disk (directories and
  +                        files) traversal is inefficient for deep trees.
  +                     </listitem>
  +                     <listitem>Usage on shared filesystems like NFS, Windows shares, etc. should be avoided as these do
  +                        not implement proper file locking and can cause data corruption.
  +                     </listitem>
  +                     <listitem>Usage with an isolation level of NONE can cause corrupt writes as multiple threads
  +                        attempt to write to the same file.
  +                     </listitem>
  +                     <listitem>File systems are inherently not transactional, so when attempting to use your cache in a
  +                        transactional context, failures when writing to the file (which happens during the commit phase)
  +                        cannot be recovered.
  +                     </listitem>
  +                  </itemizedlist>
  +
  +                  As a rule of thumb, it is recommended that the FileCacheLoader not be used in a highly concurrent,
  +                  transactional or stressful environment, and it's use is restricted to testing.
  +               </para>
  +            </answer>
  +         </qandaentry>
  +
  +         <qandaentry>
  +            <question>
                  <para>Can writing to cache loaders be asynchronous?</para>
               </question>