com.amazonaws.endpointdiscovery

Class EndpointDiscoveryIdentifiersRefreshCache<K>

java.lang.Object

com.amazonaws.endpointdiscovery.EndpointDiscoveryIdentifiersRefreshCache<K>

public abstract class EndpointDiscoveryIdentifiersRefreshCache<K>
extends Object

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
EndpointDiscoveryIdentifiersRefreshCache(EndpointDiscoveryCacheLoader cacheLoader)

Method Summary

Modifier and Type	Method and Description
abstract String	constructKey(String key, AmazonWebServiceRequest discoveryRequest)
URI	discoverEndpoint(String key, AmazonWebServiceRequest request, boolean required, URI defaultEndpoint)
void	evict(String key)
abstract URI	get(K key, AmazonWebServiceRequest discoveryRequest, 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, AmazonWebServiceRequest request, long refreshPeriod, URI defaultEndpoint)
abstract URI	put(String key, AmazonWebServiceRequest discoveryRequest, 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

EndpointDiscoveryIdentifiersRefreshCache

public EndpointDiscoveryIdentifiersRefreshCache(EndpointDiscoveryCacheLoader cacheLoader)

Method Detail

get

public abstract URI get(K key,
                        AmazonWebServiceRequest discoveryRequest,
                        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

discoveryRequest - - An endpoint discovery request containing additional discovery parameters

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,
                        AmazonWebServiceRequest discoveryRequest,
                        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

discoveryRequest - An endpoint discovery request containing additional discovery parameters.

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

Returns:

The endpoint used for this request

constructKey

public abstract String constructKey(String key,
                                    AmazonWebServiceRequest discoveryRequest)

evict

public void evict(String key)

discoverEndpoint

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

loadAndScheduleRefresh

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

loadAndScheduleEvict

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

shutdown

public void shutdown()