cz.gyarab.util.collection

Class ExpiringMap<K,V>

java.lang.Object

cz.gyarab.util.collection.ExpiringMap<K,V>

Type Parameters:

K - typ klíče mapy

V - typ hodnoty mapy

All Implemented Interfaces:

java.util.Map<K,V>

public class ExpiringMap<K,V>
extends java.lang.Object
implements java.util.Map<K,V>

Mapa obsahuje vztahy, které mohou expirovat. Když vztah expiruje, bude (někdy po tom) odstraněn z kolekce. Dotaz na objekt po jeho expiraci nebude mít kladnou odpověd. Expiraci (dočasně) je možné zabránit, pokud hodnota implementuje rozhraní ExpiringMap.Permanent a při zavolání metody ExpiringMap.Permanent.isPermanent() vrátí true. Tato hodnota je kontrolována jen při testu expirace a při každém použití objektu, např. při zavolání get(java.lang.Object). Zejména po změně z permanentního stavu na nepermanentní je třeba kolekci informovat, že došlo k této změně (např. zavoláním uvedené metody).

Since:

1.4

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ExpiringMap.Permanent Toto rozhraní může volitelně implementovat hodnota v kolekci.

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

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

Constructor Summary

Constructors

Constructor and Description
ExpiringMap(long expiration) Vytvoří novou mapu s poskytnutou dobou životnosti klíčů a hodnot.

Method Summary

Modifier and Type	Method and Description
void	clear() V souladu s běžným významem této metody budou odstraněny všechny elementy, expirované, neexpirované i premanentní.
boolean	containsKey(java.lang.Object key)
boolean	containsValue(java.lang.Object value)
java.util.Set<java.util.Map.Entry<K,V>>	entrySet()
void	forEach(java.util.function.BiConsumer<? super K,? super V> action)
V	get(java.lang.Object key) Nad rámec běžného významu této metody, pokud klíč existuje, prodlouží se mu životnost na plnou dobu.
long	getExpiration() Zjistí dobu expirace pro elementy kolekce.
boolean	isEmpty()
java.util.Set<K>	keySet()
V	put(K key, V value) Nad rámec běžného významu této metody se životnost nového vztahu nastaví na plnou dobu.
void	putAll(java.util.Map<? extends K,? extends V> m)
V	remove(java.lang.Object key)
void	replaceAll(java.util.function.BiFunction<? super K,? super V,? extends V> function)
int	size()
java.util.Collection<V>	values()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, equals, getOrDefault, hashCode, merge, putIfAbsent, remove, replace, replace

Constructor Detail

ExpiringMap

public ExpiringMap(long expiration)

Vytvoří novou mapu s poskytnutou dobou životnosti klíčů a hodnot.

Parameters:

expiration - čas v milisekudnách, pokud po dobu delší než tento interval není objekt v kolekci použit, bude z ní odstraněn (ne nutně hned)

Method Detail

getExpiration

public long getExpiration()

Zjistí dobu expirace pro elementy kolekce. Ta je pro všechny elementy stejná a neměnná.

Returns:

expirační dobu v milisekundách

size

public int size()

Specified by:

size in interface java.util.Map<K,V>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface java.util.Map<K,V>

containsKey

public boolean containsKey(java.lang.Object key)

Specified by:

containsKey in interface java.util.Map<K,V>

containsValue

public boolean containsValue(java.lang.Object value)

Specified by:

containsValue in interface java.util.Map<K,V>

get

public V get(java.lang.Object key)

Nad rámec běžného významu této metody, pokud klíč existuje, prodlouží se mu životnost na plnou dobu. Expirované klíče se odstraní ještě před návratem z metody. Pokud dotazovaný klíč v kolekci byl, ale expiroval, metoda příslušnou hodnotu nevrátí.

Specified by:

get in interface java.util.Map<K,V>

put

public V put(K key,
             V value)

Nad rámec běžného významu této metody se životnost nového vztahu nastaví na plnou dobu. Ještě před návratem se odstraní všechny expirované vztahy.

Specified by:

put in interface java.util.Map<K,V>

remove

public V remove(java.lang.Object key)

Specified by:

remove in interface java.util.Map<K,V>

putAll

public void putAll(java.util.Map<? extends K,? extends V> m)

Specified by:

putAll in interface java.util.Map<K,V>

clear

public void clear()

V souladu s běžným významem této metody budou odstraněny všechny elementy, expirované, neexpirované i premanentní.

Specified by:

clear in interface java.util.Map<K,V>

keySet

public java.util.Set<K> keySet()

Specified by:

keySet in interface java.util.Map<K,V>

values

public java.util.Collection<V> values()

Specified by:

values in interface java.util.Map<K,V>

entrySet

public java.util.Set<java.util.Map.Entry<K,V>> entrySet()

Specified by:

entrySet in interface java.util.Map<K,V>

forEach

public void forEach(java.util.function.BiConsumer<? super K,? super V> action)

Specified by:

forEach in interface java.util.Map<K,V>

replaceAll

public void replaceAll(java.util.function.BiFunction<? super K,? super V,? extends V> function)

Specified by:

replaceAll in interface java.util.Map<K,V>