org.dataloader

Interface CacheMap<U,V>

Type Parameters:

U - type parameter indicating the type of the cache keys

V - type parameter indicating the type of the data that is cached

All Known Implementing Classes:

DefaultCacheMap

public interface CacheMap<U,V>

Cache map interface for data loaders that use caching.

The default implementation used by the data loader is based on a LinkedHashMap. Note that the implementation could also have used a regular Map instead of this CacheMap, but this aligns better to the reference data loader implementation provided by Facebook

Also it doesn't require you to implement the full set of map overloads, just the required methods.

Method Summary

Modifier and Type	Method and Description
CacheMap<U,V>	clear() Clears all entries of the cache map
boolean	containsKey(U key) Checks whether the specified key is contained in the cach map.
CacheMap<U,V>	delete(U key) Deletes the entry with the specified key from the cache map, if it exists.
V	get(U key) Gets the specified key from the cache map.
CacheMap<U,V>	set(U key, V value) Creates a new cache map entry with the specified key and value, or updates the value if the key already exists.
static <U,V> CacheMap<U,java.util.concurrent.CompletableFuture<V>>	simpleMap() Creates a new cache map, using the default implementation that is based on a LinkedHashMap.

Method Detail

simpleMap

static <U,V> CacheMap<U,java.util.concurrent.CompletableFuture<V>> simpleMap()

Creates a new cache map, using the default implementation that is based on a LinkedHashMap.

Type Parameters:

U - type parameter indicating the type of the cache keys

V - type parameter indicating the type of the data that is cached

Returns:

the cache map

containsKey

boolean containsKey(U key)

Checks whether the specified key is contained in the cach map.

Parameters:

key - the key to check

Returns:

true if the cache contains the key, false otherwise

get

V get(U key)

Gets the specified key from the cache map.

May throw an exception if the key does not exists, depending on the cache map implementation that is used, so be sure to check containsKey(Object) first.

Parameters:

key - the key to retrieve

Returns:

the cached value, or null if not found (depends on cache implementation)

set

CacheMap<U,V> set(U key,
                  V value)

Creates a new cache map entry with the specified key and value, or updates the value if the key already exists.

Parameters:

key - the key to cache

value - the value to cache

Returns:

the cache map for fluent coding

delete

CacheMap<U,V> delete(U key)

Deletes the entry with the specified key from the cache map, if it exists.

Parameters:

key - the key to delete

Returns:

the cache map for fluent coding

clear

CacheMap<U,V> clear()

Clears all entries of the cache map

Returns:

the cache map for fluent coding