com.fr.collections.api

接口 FineCacheMap<K,V>

所有超级接口:

java.util.concurrent.ConcurrentMap<K,V>, FineCacheObject, FineMap<K,V>, java.util.Map<K,V>

所有已知子接口:

FineCapacityCacheMap<K,V>

所有已知实现类:

RedisCacheMap, StandaloneCacheMap

public interface FineCacheMap<K,V>
extends FineMap<K,V>, FineCacheObject

作者:

andrew_asa

嵌套类概要

从接口继承的嵌套类/接口 java.util.Map

java.util.Map.Entry<K,V>

方法概要

方法

限定符和类型	方法和说明
void	destroy() 销毁 因为有清过期key线程，所以需要支持 外层手动调用销毁方法
java.util.Set<K>	keySet()
V	put(K key, V value, long ttl) 设置一个key-value 值，可以设置过期时间，单位毫秒
V	put(K key, V value, long ttl, long maxIdleTime) 设置key-value值单位为毫秒
V	put(K key, V value, long ttl, java.util.concurrent.TimeUnit unit) 设置一个key-value 值，可以设置过期时间
V	put(K key, V value, long ttl, java.util.concurrent.TimeUnit ttlUnit, long maxIdleTime, java.util.concurrent.TimeUnit maxIdleUnit) 设置一个key-value 值，可以设置过期时间，最大空闲时间
void	putAll(java.util.Map<? extends K,? extends V> map, long ttl)
void	putAll(java.util.Map<? extends K,? extends V> map, long ttl, java.util.concurrent.TimeUnit ttlUnit)
V	putIfAbsent(K key, V value, long ttl) 当且仅当key不存在是进行保存，如果存在则返回原先的值
V	putIfAbsent(K key, V value, long ttl, long maxIdleTime) 缺失则设置key-value值单位为毫秒
V	putIfAbsent(K key, V value, long ttl, java.util.concurrent.TimeUnit ttlUnit) 当且仅当key不存在是进行保存，如果存在则返回原先的值
V	putIfAbsent(K key, V value, long ttl, java.util.concurrent.TimeUnit ttlUnit, long maxIdleTime, java.util.concurrent.TimeUnit maxIdleUnit) 缺失则设置一个key-value 值，可以设置过期时间，最大空闲时间
long	remainTimeToLive(K key) 关联的key值还有多久才过期
int	size() 注意这边返回的大小可能包括已经失效的key值 如果清理进程没有来的急清理过期的key KeySet， Values，Entry 这些对象的迭代器的能保证获取出来的对象不是过期的

从接口继承的方法 java.util.concurrent.ConcurrentMap

putIfAbsent, remove, replace, replace

从接口继承的方法 java.util.Map

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

方法详细资料

put

V put(K key,
    V value,
    long ttl,
    java.util.concurrent.TimeUnit ttlUnit,
    long maxIdleTime,
    java.util.concurrent.TimeUnit maxIdleUnit)

设置一个key-value 值，可以设置过期时间，最大空闲时间

参数:

key -

value -

ttl - 过期时间 为0时表示没有过期时间

ttlUnit - 时间单位

maxIdleTime - 最大过期时间应该大于最大空闲时间，最大空闲时间表示，如果有多长时间这个key值没有用 则失效 为0时表示没有最大空闲时间期限

maxIdleUnit - 最大空闲时间时间单位

返回:

put

V put(K key,
    V value,
    long ttl,
    long maxIdleTime)

设置key-value值单位为毫秒

参数:

key -

value -

ttl -

maxIdleTime -

返回:

put

V put(K key,
    V value,
    long ttl,
    java.util.concurrent.TimeUnit unit)

设置一个key-value 值，可以设置过期时间

参数:

key -

value -

ttl - 过期时间 为0时表示没有过期时间

unit - 时间单位

返回:

put

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

设置一个key-value 值，可以设置过期时间，单位毫秒

参数:

key -

value -

ttl - 过期时间

返回:

putIfAbsent

V putIfAbsent(K key,
            V value,
            long ttl,
            java.util.concurrent.TimeUnit ttlUnit,
            long maxIdleTime,
            java.util.concurrent.TimeUnit maxIdleUnit)

缺失则设置一个key-value 值，可以设置过期时间，最大空闲时间

参数:

key -

value -

ttl - 过期时间 为0时表示没有过期时间

ttlUnit - 时间单位

maxIdleTime - 最大过期时间应该大于最大空闲时间，最大空闲时间表示，如果有多长时间这个key值没有用 则失效 为0时表示没有最大空闲时间期限

maxIdleUnit - 最大空闲时间时间单位

返回:

putIfAbsent

V putIfAbsent(K key,
            V value,
            long ttl,
            long maxIdleTime)

缺失则设置key-value值单位为毫秒

参数:

key -

value -

ttl -

maxIdleTime -

返回:

putIfAbsent

V putIfAbsent(K key,
            V value,
            long ttl,
            java.util.concurrent.TimeUnit ttlUnit)

当且仅当key不存在是进行保存，如果存在则返回原先的值

参数:

key -

value -

ttl - 过期时间 为0时表示没有过期时间

ttlUnit - 时间单位

返回:

之前key值存放value

putIfAbsent

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

当且仅当key不存在是进行保存，如果存在则返回原先的值

参数:

key -

value -

ttl - 过期时间 为0时表示没有过期时间 时间毫秒

返回:

之前key值存放value

putAll

void putAll(java.util.Map<? extends K,? extends V> map,
          long ttl,
          java.util.concurrent.TimeUnit ttlUnit)

参数:

map -

ttl - 过期时间

ttlUnit - - 时间单位

putAll

void putAll(java.util.Map<? extends K,? extends V> map,
          long ttl)

参数:

map -

ttl - 过期时间 单位毫秒

size

int size()

注意这边返回的大小可能包括已经失效的key值 如果清理进程没有来的急清理过期的key KeySet， Values，Entry 这些对象的迭代器的能保证获取出来的对象不是过期的

指定者:

size 在接口中 java.util.Map<K,V>

remainTimeToLive

long remainTimeToLive(K key)

关联的key值还有多久才过期

参数:

key - - map key

返回:

time in milliseconds -2 key 不存在 -1 没有设置过期时间

keySet

java.util.Set<K> keySet()

指定者:

keySet 在接口中 java.util.Map<K,V>

destroy

void destroy()

销毁 因为有清过期key线程，所以需要支持 外层手动调用销毁方法