[jboss-cvs] JBossCache/docs/JBossCache-UserGuide/en/modules ...

[Galder Zamarreno]

  User: gzamarreno
  Date: 07/04/20 13:40:29

  Modified:    docs/JBossCache-UserGuide/en/modules  cache_loaders.xml
  Log:
  [JBCACHE-964] documentation: users guide update and added an FAQ entry
  
  Revision  Changes    Path
  1.12      +34 -0     JBossCache/docs/JBossCache-UserGuide/en/modules/cache_loaders.xml
  
  (In the diff below, changes in quantity of whitespace are not shown.)
  
  Index: cache_loaders.xml
  ===================================================================
  RCS file: /cvsroot/jboss/JBossCache/docs/JBossCache-UserGuide/en/modules/cache_loaders.xml,v
  retrieving revision 1.11
  retrieving revision 1.12
  diff -u -b -r1.11 -r1.12
  --- cache_loaders.xml	30 Mar 2007 17:22:07 -0000	1.11
  +++ cache_loaders.xml	20 Apr 2007 17:40:29 -0000	1.12
  @@ -916,6 +916,40 @@
            </para>
   
         </section>
  +
  +      <section id="cl.transforming">
  +         <title>Transforming Cache Loaders</title>
  +
  +         <para>The way cached data is written to <literal>FileCacheLoader</literal> and
  +            <literal>JDBCCacheLoader</literal> based cache stores has changed in JBoss Cache 2.0 in such way that
  +            these cache loaders now write and read data using the same marhalling framework used to replicate data
  +            accross the network. Such change is trivial for replication purpouses as it just requires the rest of the
  +            nodes to understand this format. However, changing the format of the data in cache stores brings up a new
  +            problem: how do users, which have their data stored in JBoss Cache 1.x.x format, migrate their stores to
  +            JBoss Cache 2.0 format?
  +         </para>
  +
  +         <para>With this in mind, JBoss Cache 2.0 comes with two cache loader implementations called
  +            <literal>org.jboss.cache.loader.TransformingFileCacheLoader</literal> and
  +            <literal>org.jboss.cache.loader.TransformingJDBCCacheLoader</literal> located within the optional
  +            jbosscache-cacheloader-migration.jar file. These are one-off cache loaders that read data from the
  +            cache store in JBoss Cache 1.x.x format and write data to cache stores in JBoss Cache 2.0 format.
  +         </para>
  +
  +         <para>The idea is for users to modify their existing cache configuration file(s) momentarily to use these
  +            cache loaders and for them to create a small Java application that creates an instance of this cache,
  +            recursively reads the entire cache and writes the data read back into the cache. Once the data is
  +            transformed, users can revert back to their original cache configuration file(s). In order to help the users
  +            with this task, a cache loader migration example has been constructed which can be located under the
  +            <literal>examples/cacheloader-migration</literal> directory within the JBoss Cache distribution. This
  +            example, called <literal>examples.TransformStore</literal>, is independent of the actual data stored in
  +            the cache as it writes back whatever it was read recursively. It is highly recommended that anyone
  +            interested in porting their data run this example first, which contains a <literal>readme.txt</literal>
  +            file with detailed information about the example itself, and also use it as base for their own application.  
  +         </para>
  +
  +      </section>
  +
      </section>