863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainenuser-friendly-name=FIFO Entry Cache

863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainenuser-friendly-plural-name=FIFO Entry Caches

3faa1040e5a3f9f35ffad29110216094ab2f5880Timo Sirainensynopsis=FIFO Entry Caches use a FIFO queue to keep track of the cached entries.

8d3278a82b964217d95c340ec6f82037cdc59d19Timo Sirainendescription=Entries that have been in the cache the longest are the most likely candidates for purging if space is needed. In contrast to other cache structures, the selection of entries to purge is not based on how frequently or recently the entries have been accessed. This requires significantly less locking (it will only be required when an entry is added or removed from the cache, rather than each time an entry is accessed). Cache sizing is based on the percentage of free memory within the JVM, such that if enough memory is free, then adding an entry to the cache will not require purging, but if more than a specified percentage of the available memory within the JVM is already consumed, then one or more entries will need to be removed in order to make room for a new entry. It is also possible to configure a maximum number of entries for the cache. If this is specified, then the number of entries will not be allowed to exceed this value, but it may not be possible to hold this many entries if the available memory fills up first. Other configurable parameters for this cache include the maximum length of time to block while waiting to acquire a lock, and a set of filters that may be used to define criteria for determining which entries are stored in the cache. If a filter list is provided, then only entries matching at least one of the given filters will be stored in the cache.

8d3278a82b964217d95c340ec6f82037cdc59d19Timo Sirainenproperty.cache-level.synopsis=Specifies the cache level in the cache order if more than one instance of the cache is configured.

8d3278a82b964217d95c340ec6f82037cdc59d19Timo Sirainenproperty.enabled.synopsis=Indicates whether the FIFO Entry Cache is enabled.

e479250007aaa49c9f38aa294f5cfb024cbcec73Timo Sirainenproperty.exclude-filter.synopsis=The set of filters that define the entries that should be excluded from the cache.

8d3278a82b964217d95c340ec6f82037cdc59d19Timo Sirainenproperty.include-filter.synopsis=The set of filters that define the entries that should be included in the cache.

cf3894a2a22dc76247275e7ad7a5417fa5f27a28Timo Sirainenproperty.java-class.synopsis=Specifies the fully-qualified name of the Java class that provides the FIFO Entry Cache implementation.

b8efab7ea8876c0a33a73ee0d08eddada31320f8Timo Sirainenproperty.lock-timeout.synopsis=Specifies the length of time to wait while attempting to acquire a read or write lock.

96d19229e5f322411eb84446e5477d8170cfa5afTimo Sirainenproperty.max-entries.synopsis=Specifies the maximum number of entries that we will allow in the cache.

863f2bc9983c33221f5936421fc9c06caf21639aTimo Sirainenproperty.max-memory-percent.synopsis=Specifies the maximum memory usage for the entry cache as a percentage of the total JVM memory.

7ab70e15c63c172c1715a40c8ffcff0285b6f05eTimo Sirainen