Class JedisGeoCache<T extends Cacheable>

java.lang.Object

org.deltava.util.cache.Cache<T>

org.deltava.util.cache.JedisCache<T>

org.deltava.util.cache.JedisGeoCache<T>

Type Parameters:

T - the Cacheable object type

All Implemented Interfaces:

GeoCache<T>

public class JedisGeoCache<T extends Cacheable>
extends JedisCache<T>
implements GeoCache<T>

A cache to store geographic lookups in Redis. Lat/long coordinates are automatically reduced to a set number of decimal places.

Since:

7.3

Version:

11.3

Author:

Luke

Field Summary

Fields inherited from class Cache

_cache

Modifier and Type	Field	Description
protected final ConcurrentMap<Object, CacheEntry<T>>	_cache

Constructor Summary

Constructors

Constructor	Description
JedisGeoCache(String bucket, int expiry, double roundAmt)	Creates the cache.

Method Summary

Modifier and Type	Method	Description
void	add(GeoLocation loc, T data)	Adds a geographically located object to the cache.
void	addNull(GeoLocation loc)	Adds a null entry to the cache.
boolean	contains(GeoLocation loc)	Returns whether the cache contains an entry for a particular location.
T	get(GeoLocation loc)	Retrieves an object from the cache.
double	getRoundingAmount()	Returns the precision of the lat/long key rounding.
void	remove(GeoLocation loc)	Removes a location entry from the cache.

Methods inherited from class JedisCache

addAll, addEntry, addNullEntry, clear, contains, createKey, get, getAll, getErrors, getExpiryTime, getMaxSize, isRemote, remove, size

Modifier and Type	Method	Description
void	addAll(Collection<? extends T> entries)	Adds a number of entries to the cache.
protected void	addEntry(T entry)	Adds an entry to the cache.
protected void	addNullEntry(Object key)	Adds a null entry to the cache.
void	clear()	Clears the cache.
boolean	contains(Object key)	Returns if the cache contains a particular cache key.
protected String	createKey(Object key)	Creates a Jedis bucket:key key.
T	get(Object key)	Retrieves an entry from the cache.
Map<Object,T>	getAll(Collection<?> keys)	Returns multiple objects from the cache.
long	getErrors()	Returns the total number of cache errors.
protected long	getExpiryTime(T entry)	Returns the expiration time for a cache entry, based on the cache or the entry's expiration time.
int	getMaxSize()	This method is repurposed to deliver the round-trip latency to the cache server.
boolean	isRemote()	Returns if the cache is a remote cache.
void	remove(Object key)	Invalidate a cache entry.
int	size()	Returns the current size of the cache.

Methods inherited from class Cache

add, addNull, checkOverflow, getHits, getRequests, hit, request, setMaxSize

Modifier and Type	Method	Description
final void	add(T entry)	Adds an entry to the cache.
final void	addNull(String key)	Adds a null entry to the cache.
protected void	checkOverflow()	Automatically resizes the cache in the case of an overflow.
final long	getHits()	Returns the total number of cache hits.
final long	getRequests()	Returns the total number of cache requests.
protected void	hit()	Log a cache hit.
protected void	request()	Log a cache request.
final void	setMaxSize(int size)	Sets the maximum size of the cache.

Methods inherited from class Object

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

Methods inherited from interface GeoCache

createGeoKey

Modifier and Type	Method	Description
default String	createGeoKey(GeoLocation loc)	Creates a lat/long key by rounding to the specific number of decimal places.

Constructor Details

JedisGeoCache

public JedisGeoCache(String bucket,
 int expiry,
 double roundAmt)

Creates the cache.

Parameters:

bucket - the Redis bucket name

expiry - the expirty time in seconds

roundAmt - the rounding factot to apply to latitude/longitude

Method Details

getRoundingAmount

public double getRoundingAmount()

Description copied from interface: GeoCache

Returns the precision of the lat/long key rounding.

Specified by:

getRoundingAmount in interface GeoCache<T extends Cacheable>

Returns:

the rounding amount

add

public void add(GeoLocation loc,
 T data)

Adds a geographically located object to the cache.

Specified by:

add in interface GeoCache<T extends Cacheable>

Parameters:

loc - the GeoLocation

data - the data to cache

addNull

public void addNull(GeoLocation loc)

Adds a null entry to the cache.

Specified by:

addNull in interface GeoCache<T extends Cacheable>

Parameters:

loc - the GeoLocation

contains

public boolean contains(GeoLocation loc)

Returns whether the cache contains an entry for a particular location.

Specified by:

contains in interface GeoCache<T extends Cacheable>

Parameters:

loc - the GeoLocation

Returns:

TRUE if the cache contains an entry, otherwise FALSE

get

public T get(GeoLocation loc)

Retrieves an object from the cache.

Specified by:

get in interface GeoCache<T extends Cacheable>

Parameters:

loc - the GeoLocation

Returns:

the Object, or null if not found

remove

public void remove(GeoLocation loc)

Removes a location entry from the cache.

Specified by:

remove in interface GeoCache<T extends Cacheable>

Parameters:

loc - the GeoLocation