com.amazonaws.endpointdiscovery

Class EndpointDiscoveryRefreshCache<K>

java.lang.Object

com.amazonaws.endpointdiscovery.EndpointDiscoveryRefreshCache<K>

public abstract class EndpointDiscoveryRefreshCache<K>
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
protected Map<String,URI>	cache

Constructor Summary

Constructors

Constructor and Description
EndpointDiscoveryRefreshCache(CacheLoader cacheLoader)

Method Summary

Modifier and Type	Method and Description
URI	discoverEndpoint(String key, boolean required, URI defaultEndpoint)
void	evict(String key)
abstract URI	get(K key, boolean required, URI defaultEndpoint) Abstract method to be implemented by each service to handle retrieving endpoints from a cache.
ScheduledFuture<?>	loadAndScheduleEvict(String key, long refreshPeriod, TimeUnit refreshPeriodTimeUnit)
ScheduledFuture<URI>	loadAndScheduleRefresh(String key, long refreshPeriod, URI defaultEndpoint)
abstract URI	put(String key, Map<String,String> endpointDetails, URI defaultEndpoint) Abstract method to be implemented by each service to handle storing endpoints in it's cache.
void	shutdown()

Methods inherited from class java.lang.Object

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

Field Detail

cache

protected final Map<String,URI> cache

Constructor Detail

EndpointDiscoveryRefreshCache

public EndpointDiscoveryRefreshCache(CacheLoader cacheLoader)

Method Detail

get

public abstract URI get(K key,
                        boolean required,
                        URI defaultEndpoint)

Abstract method to be implemented by each service to handle retrieving endpoints from a cache. Each service must handle converting a request object into the relevant cache key.

Parameters:

key - - The cache key to use

required - - Whether or not the service requires use of endpoint discovery

defaultEndpoint - - The default endpoint for the service

Returns:

The endpoint to use for this request

put

public abstract URI put(String key,
                        Map<String,String> endpointDetails,
                        URI defaultEndpoint)

Abstract method to be implemented by each service to handle storing endpoints in it's cache. This method must schedule refresh of cache values whenever putting a new endpoint into it's cache.

Parameters:

key - - The cache key

endpointDetails - - The details for an endpoint including the address and cache period.

Returns:

The endpoint used for this request

evict

public void evict(String key)

discoverEndpoint

public URI discoverEndpoint(String key,
                            boolean required,
                            URI defaultEndpoint)

loadAndScheduleRefresh

public ScheduledFuture<URI> loadAndScheduleRefresh(String key,
                                                   long refreshPeriod,
                                                   URI defaultEndpoint)

loadAndScheduleEvict

public ScheduledFuture<?> loadAndScheduleEvict(String key,
                                               long refreshPeriod,
                                               TimeUnit refreshPeriodTimeUnit)

shutdown

public void shutdown()