Infinispan 9.2 User Guide The Infinispan community Table of Contents 1. Introduction. 1 1.1. What is Infinispan ? . 1 1.2. Why use Infinispan ? . 1 1.2.1. As a local cache . 1 1.2.2. As a clustered cache . 1 1.2.3. As a clustering building block for your applications . 1 1.2.4. As a remote cache . 1 1.2.5. As a data grid . 2 1.2.6. As a geographical backup for your data . 2 2. The Embedded CacheManager . 3 2.1. Configuration. 3 2.1.1. Configuring caches declaratively . 4 2.1.2. Configuring caches programmatically. 7 2.1.3. Configuration Migration Tools . 11 2.1.4. Clustered Configuration . 12 2.2. Obtaining caches. 14 2.3. Clustering Information . 15 2.3.1. Member Information . 16 2.3.2. Other methods . 16 3. The Cache API . 17 3.1. The Cache interface . 17 3.1.1. Performance Concerns of Certain Map Methods . 17 3.1.2. Mortal and Immortal Data . 17 3.1.3. Example of Using Expiry and Mortal Data . 17 3.1.4. putForExternalRead operation . 18 3.2. The AdvancedCache interface . 19 3.2.1. Flags . 19 3.2.2. Custom Interceptors. 19 3.3. Listeners and Notifications . 19 3.3.1. Cache-level notifications . 20 3.3.2. Cache manager-level notifications . 22 3.3.3. Synchronicity of events . 22 3.4. Asynchronous API . 23 3.4.1. Why use such an API? . 23 3.4.2. Which processes actually happen asynchronously? . 23 3.4.3. Notifying futures. 24 3.4.4. Further reading. 24 3.5. Invocation Flags . 24 3.5.1. Examples. 25 3.6. Tree API Module . 25 3.6.1. What is Tree API about? . 26 3.6.2. Using the Tree API . 26 3.6.3. Creating a Tree Cache . 26 3.6.4. Manipulating data in a Tree Cache. 27 3.6.5. Common Operations . 28 3.6.6. Locking in the Tree API . 29 3.6.7. Listeners for tree cache events . 30 3.7. Functional Map API . 30 3.7.1. Asynchronous and Lazy . 30 3.7.2. Function transparency . 31 3.7.3. Constructing Functional Maps. 31 3.7.4. Read-Only Map API. 31 3.7.5. Write-Only Map API . 32 3.7.6. Read-Write Map API. 34 3.7.7. Metadata Parameter Handling . 35 3.7.8. Invocation Parameter . ..