org.redisson.core

Interface RMapCache<K,V>

Type Parameters:

K - key

V - value

All Superinterfaces:

ConcurrentMap<K,V>, Map<K,V>, RExpirable, RExpirableAsync, RMap<K,V>, RMapAsync<K,V>, RMapCacheAsync<K,V>, RObject, RObjectAsync

All Known Implementing Classes:

RedissonMapCache

public interface RMapCache<K,V>
extends RMap<K,V>, RMapCacheAsync<K,V>

Map-based cache with ability to set TTL for each entry via put(Object, Object, long, TimeUnit) or putIfAbsent(Object, Object, long, TimeUnit) And therefore has an complex lua-scripts inside.

Current redis implementation doesnt have map entry eviction functionality. Thus entries are checked for TTL expiration during any key/value/entry read operation. If key/value/entry expired then it doesn't returns and clean task runs asynchronous. Clean task deletes removes 100 expired entries at once. In addition there is EvictionScheduler. This scheduler deletes expired entries in time interval between 5 seconds to 2 hours.

If eviction is not required then it's better to use RedissonMapReactive.

Author:

Nikita Koksharov

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Method Summary

Methods

Modifier and Type	Method and Description
V	put(K key, V value, long ttl, TimeUnit unit)
V	putIfAbsent(K key, V value, long ttl, TimeUnit unit)
int	size() Returns the number of entries in cache.

Methods inherited from interface org.redisson.core.RMap

addAndGet, entryIterator, fastPut, fastRemove, filterEntries, filterKeys, filterValues, getAll, keyIterator, valueIterator

Methods inherited from interface java.util.concurrent.ConcurrentMap

putIfAbsent, remove, replace, replace

Methods inherited from interface java.util.Map

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, values

Methods inherited from interface org.redisson.core.RExpirable

clearExpire, expire, expireAt, expireAt, remainTimeToLive

Methods inherited from interface org.redisson.core.RObject

delete, getName, isExists, migrate, move, rename, renamenx

Methods inherited from interface org.redisson.core.RMapCacheAsync

putAsync, putIfAbsentAsync, sizeAsync

Methods inherited from interface org.redisson.core.RMapAsync

addAndGetAsync, containsKeyAsync, containsValueAsync, fastPutAsync, fastRemoveAsync, getAllAsync, getAsync, putAllAsync, putAsync, putIfAbsentAsync, removeAsync, removeAsync, replaceAsync, replaceAsync

Methods inherited from interface org.redisson.core.RExpirableAsync

clearExpireAsync, expireAsync, expireAtAsync, expireAtAsync, remainTimeToLiveAsync

Methods inherited from interface org.redisson.core.RObjectAsync

deleteAsync, isExistsAsync, migrateAsync, moveAsync, renameAsync, renamenxAsync

Method Detail

putIfAbsent

V putIfAbsent(K key,
            V value,
            long ttl,
            TimeUnit unit)

put

V put(K key,
    V value,
    long ttl,
    TimeUnit unit)

size

int size()

Returns the number of entries in cache. This number can reflects expired entries too due to non realtime cleanup process.

Specified by:

size in interface Map<K,V>