Infinispan 9.0 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. Configuration . 3 2.1. Configuring caches declaratively . 3 2.1.1. Cache configuration templates . 4 2.1.2. Declarative configuration reference . 6 2.2. Configuring caches programmatically . 6 2.2.1. ConfigurationBuilder Programmatic Configuration API . 7 2.2.2. Advanced programmatic configuration . 9 2.3. Configuration Migration Tools . 10 2.4. Clustered Configuration . 10 2.4.1. Using an external JGroups file . 10 2.4.2. Use one of the pre-configured JGroups files . 11 2.4.3. Further reading . 13 3. The CacheManager API . 14 3.1. Clustering Information . 14 3.1.1. Member Information. 14 3.1.2. Other methods. 14 3.2. Cluster Executor . 14 3.2.1. Example: Dynamically Start and Stop Clustered Cache . 15 4. The Cache API . 16 4.1. The Cache interface . 16 4.1.1. Performance Concerns of Certain Map Methods . 16 4.1.2. Mortal and Immortal Data . 16 4.1.3. Example of Using Expiry and Mortal Data . 16 4.1.4. putForExternalRead operation . 17 4.2. The AdvancedCache interface. 18 4.2.1. Flags . 18 4.2.2. Custom Interceptors . 18 4.3. Listeners and Notifications . 18 4.3.1. Cache-level notifications. 19 4.3.2. Cache manager-level notifications . 21 4.3.3. Synchronicity of events. 21 4.4. Asynchronous API . 22 4.4.1. Why use such an API? . 22 4.4.2. Which processes actually happen asynchronously? . 22 4.4.3. Notifying futures . 23 4.4.4. Further reading . 23 4.5. Invocation Flags . 23 4.5.1. DecoratedCache . 24 4.5.2. Examples . 24 4.6. Tree API Module . 25 4.6.1. What is Tree API about? . 25 4.6.2. Using the Tree API . 25 4.6.3. Creating a Tree Cache . 26 4.6.4. Manipulating data in a Tree Cache . 26 4.6.5. Common Operations . 27 4.6.6. Locking in the Tree API. 28 4.6.7. Listeners for tree cache events . 29 4.7. Functional Map API . ..