com.deviceatlas.cloud.deviceidentification.service

Class CacheService

java.lang.Object

com.deviceatlas.cloud.deviceidentification.service.CacheService

public class CacheService
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CACHE_NAME Deprecated.
static java.lang.String	CACHE_NAME_SERVERS_AUTO Deprecated.
static java.lang.String	CACHE_NAME_SERVERS_MANUAL Deprecated.

Constructor Summary

Constructors

Constructor and Description
CacheService(CacheProvider cachePropsProvider)

Method Summary

Methods

Modifier and Type	Method and Description
void	clearCache() Clear all cached data.
EndPoint[]	convertServerMapListToServerList(java.util.List<java.util.Map> listOfServerMaps) Convert a list of (server-data HashMaps) to an Array of EndPoint objects ehcache stores (server-data HashMaps)
EndPoint[]	getCachedServerList(java.lang.String cacheKey) Get cached server list.
CacheProvider	getCacheProvider() Gets the cache Provider
java.util.List<java.util.Map>	getCacheServersAutoRanking() Returns the list of auto ranked servers
java.util.List<java.util.Map>	getCacheServersManualRanking() Returns the list of manual ranked servers
int	getServerRankingLifetime() Returns the server ranking cache lifetime
boolean	getUseCache() Is device data being cached by the API or not.
void	setServerCache(EndPoint[] endPoints, boolean isManual) Write server list to cache.
void	setServerRankingLifetime(int serverRankListLifetime) Sets the server ranking cache lifetime
void	setUseCache(boolean useCache) Setter to cache or not to cache device data.
void	shutdown() This should be called when shutting down your application.

Methods inherited from class java.lang.Object

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

Field Detail

CACHE_NAME

@Deprecated
public static final java.lang.String CACHE_NAME

Deprecated.

Please see ClientConstants.CACHE_NAME.toString()

CACHE_NAME_SERVERS_AUTO

@Deprecated
public static final java.lang.String CACHE_NAME_SERVERS_AUTO

Deprecated.

Please see ClientConstants.CACHE_NAME_SERVERS_AUTO.toString()

CACHE_NAME_SERVERS_MANUAL

@Deprecated
public static final java.lang.String CACHE_NAME_SERVERS_MANUAL

Deprecated.

Please see ClientConstants.CACHE_NAME_SERVERS_MANUAL.toString()

Constructor Detail

CacheService

public CacheService(CacheProvider cachePropsProvider)
             throws CacheException

Throws:

CacheException

Method Detail

getServerRankingLifetime

public int getServerRankingLifetime()

Returns the server ranking cache lifetime

Returns:

serverRankingLifetime

setServerRankingLifetime

public void setServerRankingLifetime(int serverRankListLifetime)

Sets the server ranking cache lifetime

Parameters:

serverRankListLifetime -

getCacheProvider

public CacheProvider getCacheProvider()

Gets the cache Provider

Returns:

cachePropsProvider

getUseCache

public boolean getUseCache()

Is device data being cached by the API or not.

Returns:

true(default) = data is being cached.

setUseCache

public void setUseCache(boolean useCache)

Setter to cache or not to cache device data.

Parameters:

useCache - true = cache data after getting device data from DeviceAtlas cloud

clearCache

public void clearCache()

Clear all cached data.

shutdown

public void shutdown()

This should be called when shutting down your application. It asks the cache manager to shutdown the cache and write the cache to disk. See http://ehcache.org/documentation/code-samples#shutdown-the-cachemanager

getCachedServerList

public EndPoint[] getCachedServerList(java.lang.String cacheKey)
                               throws CacheException

Get cached server list. For debugging cache contents.

Parameters:

cacheKey - cache key Client.CACHE_NAME_SERVERS_AUTO or Client.CACHE_NAME_SERVERS_MANUAL

Returns:

array of EndPoint objects or null if cache is empty

Throws:

CacheException

convertServerMapListToServerList

public EndPoint[] convertServerMapListToServerList(java.util.List<java.util.Map> listOfServerMaps)

Convert a list of (server-data HashMaps) to an Array of EndPoint objects ehcache stores (server-data HashMaps)

setServerCache

public void setServerCache(EndPoint[] endPoints,
                  boolean isManual)
                    throws CacheException

Write server list to cache. Depending on the key auto ranked server list or manual ranking fail-over server list will be set

Throws:

CacheException

getCacheServersAutoRanking

public java.util.List<java.util.Map> getCacheServersAutoRanking()
                                                         throws CacheException

Returns the list of auto ranked servers

Returns:

List

Throws:

CacheException

getCacheServersManualRanking

public java.util.List<java.util.Map> getCacheServersManualRanking()
                                                           throws CacheException

Returns the list of manual ranked servers

Returns:

List

Throws:

CacheException