org.agrona.collections

Class IntLruCache<E>

java.lang.Object

org.agrona.collections.IntLruCache<E>

Type Parameters:

E - the type of element that this cache holds.

All Implemented Interfaces:

java.io.Serializable, java.lang.AutoCloseable

public final class IntLruCache<E>
extends java.lang.Object
implements java.lang.AutoCloseable, java.io.Serializable

A fixed capacity cache of int keyed values that evicts the least-recently-used element when it runs out of space.

When an element is evicted it is closed by calling the closer function with the element as an argument.

When a new key arrives the factory function is called in order to create the new element associated with that key.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
IntLruCache(int capacity, java.util.function.IntFunction<E> factory, java.util.function.Consumer<E> closer) Constructor.

Method Summary

Modifier and Type	Method and Description
int	capacity()
void	close()
E	lookup(int key) Looks up an element in the cache, creating a new element if it doesn't exist and evicting the least recently used element if there's no space left in the cache.

Methods inherited from class java.lang.Object

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

Constructor Detail

IntLruCache

public IntLruCache(int capacity,
                   java.util.function.IntFunction<E> factory,
                   java.util.function.Consumer<E> closer)

Constructor.

Parameters:

capacity - this is the fixed capacity of the cache.

factory - a function for constructing new elements based upon keys.

closer - a function for cleaning up resources associated with elements.

Method Detail

lookup

public E lookup(int key)

Looks up an element in the cache, creating a new element if it doesn't exist and evicting the least recently used element if there's no space left in the cache.

Parameters:

key - the key to lookup the element by.

Returns:

the element associated with this key.

capacity

public int capacity()

close

public void close()

Specified by:

close in interface java.lang.AutoCloseable