Chapter 18. Cache Writing Modes

Procedure 18.1. Configure a Write-Through Local File Cache Store

1. Identify the namedCache

   The name parameter specifies the name of the namedCache to use.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   

2. Configure the Cache Loader

   The shared parameter is used when multiple cache instances share a cache store. This parameter can be set to prevent multiple cache instances writing the same modification multiple times. Valid values for this parameter are true and false.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   		<persistence shared="false">
   

3. Specify the Loader Class

   The class attribute defines the class of the cache loader implementation.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   		<persistence shared="false">
   		<store class="org.infinispan.loaders.file.FileCacheStore"
   

4. Configure the fetchPersistentState Parameter

   The fetchPersistentState parameter determines whether the persistent state is fetched when joining a cluster. Set this to true if using a replication and invalidation in a clustered environment. Additionally, if multiple cache stores are chained, only one cache store can have this property enabled. If a shared cache store is used, the cache does not allow a persistent state transfer despite this property being set to true. The fetchPersistentState parameter is false by default.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   		<persistence shared="false">
   		<store class="org.infinispan.loaders.file.FileCacheStore" 
   	       			fetchPersistentState="true"
   

5. Set the ignoreModifications Parameter

   The ignoreModifications parameter determines whether operations that modify the cache (e.g. put, remove, clear, store, etc.) do not affect the cache store. As a result, the cache store can become out of sync with the cache.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   		<persistence shared="false">
   		<store class="org.infinispan.loaders.file.FileCacheStore" 
   	       			fetchPersistentState="true" 
   	       			ignoreModifications="false"
   

6. Configure Purge On Startup

   The purgeOnStartup parameter specifies whether the cache is purged when initially started.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   		<persistence shared="false">
   		<store class="org.infinispan.loaders.file.FileCacheStore" 
   	       			fetchPersistentState="true" 
   	       			ignoreModifications="false"
   	       			purgeOnStartup="false">
   

7. The property Element

   The property element contains information about properties related to the cache store.
   1. The name parameter specifies the name of the property.

   <?xml version="1.0" encoding="UTF-8"?>
   <infinispan xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns="urn:infinispan:config:5.0">
   	<global />
   	<default />
   	<namedCache name="persistentCache">
   		<persistence shared="false">
   		<store class="org.infinispan.loaders.file.FileCacheStore" 
   	       			fetchPersistentState="true" 
   	       			ignoreModifications="false"
   	       			purgeOnStartup="false">
   				<properties>
   					<property name="location" 
   						  value="${java.io.tmpdir}" />
   				</properties>
   			</store>
   		</persistence>
     	</namedCache>
   </infinispan>