Package org.gcube.common.clients.cache

Interface EndpointCache<A>

Type Parameters:

A - the type of service addresses

All Known Implementing Classes:

DefaultEndpointCache

public interface EndpointCache<A>

A cross-service cache of endpoint addresses used by DiscoveryDelegates.

Author:

Fabio Simeoni

See Also:

• Key
• DiscoveryDelegate

Method Summary

Modifier and Type	Method	Description
void	clear(Key key)	Resets the cache for a given Key.
A	get(Key key)	Returns the address cached for a given Key
void	put(Key key, A address)	Caches an endpoint address for a given Key

Method Details

clear

void clear(Key key)
    throws IllegalArgumentException

Resets the cache for a given Key.

Parameters:

key - the key

Throws:

IllegalArgumentException - if the key is null

get

A get(Key key)
throws IllegalArgumentException

Returns the address cached for a given Key

Parameters:

key - the key

Returns:

the endpoint address, or null if there is no endpoint address cached for the service

Throws:

IllegalArgumentException - if the key is null

put

void put(Key key,
 A address)
  throws IllegalArgumentException

Caches an endpoint address for a given Key

Parameters:

key - the key

address - the address

Throws:

IllegalArgumentException - if the key or the address are null