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">
   

   Copy to Clipboard Toggle word wrap

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">
   

   Copy to Clipboard Toggle word wrap

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"
   

   Copy to Clipboard Toggle word wrap

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"
   

   Copy to Clipboard Toggle word wrap

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"
   

   Copy to Clipboard Toggle word wrap

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">
   

   Copy to Clipboard Toggle word wrap

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>
   
   

   Copy to Clipboard Toggle word wrap