| Name | Type | Default | Description |
|---|---|---|---|
| append-cache-name-to-path | boolean | false | Whether to append the name of the cache to the path. |
| path | string | /rest/___defaultcache | The path portion of the URI of the remote REST endpoint. |
| key-to-string-mapper | string | org.infinispan.persistence.keymappers.MarshalledValueOrPrimitiveMapper | The name of a class to use for converting keys to strings. Defaults to org.infinispan.persistence.keymappers.MarshalledValueOrPrimitiveMapper |
remote-server+
connection-pool+
| Name | Type | Default | Description |
|---|---|---|---|
| buffer-size | int | 8192 | The size of the socket buffer. |
| connection-timeout | int | 60000 | A connection timeout for remote cache communication. |
| max-connections-per-host | int | 4 | The maximum number of connections per host. |
| max-total-connections | int | 20 | The maximum number of total connections. |
| socket-timeout | int | 60000 | A socket timeout for remote cache communication. |
| tcp-no-delay | boolean | true | Enable/disable TCP_NODELAY on socket connections to remote Hot Rod servers. |
| Name | Type | Default | Description |
|---|---|---|---|
| name | string | Unused XML attribute | |
| shared | boolean | false | This setting should be set to true when multiple cache instances share the same cache store (e.g., multiple nodes in a cluster using a JDBC-based CacheStore pointing to the same, shared database.) Setting this to true avoids multiple cache instances writing the same modification multiple times. If enabled, only the node where the modification originated will write to the cache store. If disabled, each individual cache reacts to a potential remote update by storing the data to the cache store. |
| preload | boolean | false | If true, when the cache starts, data stored in the cache store will be pre-loaded into memory. This is particularly useful when data in the cache store will be needed immediately after startup and you want to avoid cache operations being delayed as a result of loading this data lazily. Can be used to provide a 'warm-cache' on startup, however there is a performance penalty as startup time is affected by this process. |
| passivation | boolean | true | If true, data is only written to the cache store when it is evicted from memory, a phenomenon known as 'passivation'. Next time the data is requested, it will be 'activated' which means that data will be brought back to memory and removed from the persistent store. If false, the cache store contains a copy of the contents in memory, so writes to cache result in cache store writes. This essentially gives you a 'write-through' configuration. |
| fetch-state | boolean | true | If true, fetch persistent state when joining a cluster. If multiple cache stores are chained, only one of them can have this property enabled. |
| purge | boolean | true | If true, purges this cache store when it starts up. |
| singleton | boolean | false | If true, the singleton store cache store is enabled. SingletonStore is a delegating cache store used for situations when only one instance in a cluster should interact with the underlying store. |
| read-only | boolean | false | If true, the cache store will only be used to load entries. Any modifications made to the caches will not be applied to the store. |
write-behind?
Configures a cache store as write-behind instead of write-through.
| Name | Type | Default | Description |
|---|---|---|---|
| flush-lock-timeout | int | 1 | Timeout to acquire the lock which guards the state to be flushed to the cache store periodically. |
| modification-queue-size | int | 1024 | Maximum number of entries in the asynchronous queue. When the queue is full, the store becomes write-through. until it can accept new entries |
| shutdown-timeout | int | 25000 | Timeout in milliseconds to stop the cache store. |
| thread-pool-size | int | 1 | Size of the thread pool whose threads are responsible for applying the modifications to the cache store. |
property*
A cache store property with name and value.