javax.cache.spi

Interface CachingProvider

public interface CachingProvider

Provides mechanisms to create, request and later manage the life-cycle of configured CacheManagers, identified by URIs and scoped by ClassLoaders.

The meaning and semantics of the URI used to identify a CacheManager is defined by CachingProvider implementations. For applications to remain implementation independent, they should avoid attempting to create URIs and instead use the URI returned by getDefaultURI().

Author:

Brian Oliver

Method Summary

Methods

Modifier and Type	Method and Description
void	close() Closes all of the CacheManager instances and associated resources created and maintained by the CachingProvider across all ClassLoaders.
void	close(ClassLoader classLoader) Closes all CacheManager instances and associated resources created by the CachingProvider using the specified ClassLoader.
void	close(URI uri, ClassLoader classLoader) Closes all CacheManager instances and associated resources created by the CachingProvider for the specified URI and ClassLoader.
CacheManager	getCacheManager() Requests a CacheManager configured according to the getDefaultURI() and getDefaultProperties() be made available that using the getDefaultClassLoader() for loading underlying classes.
CacheManager	getCacheManager(URI uri, ClassLoader classLoader) Requests a CacheManager configured according to the vendor specific URI be made available that uses the provided ClassLoader for loading underlying classes.
CacheManager	getCacheManager(URI uri, ClassLoader classLoader, Properties properties) Requests a CacheManager configured according to the vendor specific URI be made available that uses the provided ClassLoader for loading underlying classes.
ClassLoader	getDefaultClassLoader() Obtains the default ClassLoader that will be used by the CachingProvider.
Properties	getDefaultProperties() Obtains the default Properties for the CachingProvider.
URI	getDefaultURI() Obtains the default URI for the CachingProvider.
boolean	isSupported(OptionalFeature optionalFeature) Determines whether an optional feature is supported by the CachingProvider.

Method Detail

getCacheManager

CacheManager getCacheManager(URI uri,
                           ClassLoader classLoader,
                           Properties properties)

Requests a CacheManager configured according to the vendor specific URI be made available that uses the provided ClassLoader for loading underlying classes.

Multiple calls to this method with the same URI and ClassLoader must return the same CacheManager instance, accept if a previously returned CacheManager has been closed.

Parameters:

uri - a vendor specific URI for the CacheManager (null means use getDefaultURI())

classLoader - the ClassLoader to use for the CacheManager (null means use getDefaultClassLoader())

properties - the Properties for the CachingProvider to create the CacheManager (null means no vendor specific Properties are required)

Throws:

CacheException - when a CacheManager for the specified arguments could not be produced

getDefaultClassLoader

ClassLoader getDefaultClassLoader()

Obtains the default ClassLoader that will be used by the CachingProvider.

Returns:

the default ClassLoader for the CachingProvider and javax.caching API calls

getDefaultURI

URI getDefaultURI()

Obtains the default URI for the CachingProvider.

Use this method to obtain a suitable URI for the CachingProvider.

Returns:

the default URI for the CachingProvider

getDefaultProperties

Properties getDefaultProperties()

Obtains the default Properties for the CachingProvider.

Use this method to obtain a suitable Properties for the CachingProvider.

Returns:

the default Properties for the CachingProvider

getCacheManager

CacheManager getCacheManager(URI uri,
                           ClassLoader classLoader)

Requests a CacheManager configured according to the vendor specific URI be made available that uses the provided ClassLoader for loading underlying classes.

Multiple calls to this method with the same URI and ClassLoader must return the same CacheManager instance, accept if a previously returned CacheManager has been closed.

Parameters:

uri - a vendor specific URI for the CacheManager (null means use getDefaultURI())

classLoader - the ClassLoader to use for the CacheManager (null means use getDefaultClassLoader())

Throws:

CacheException - when a CacheManager for the specified arguments could not be produced

getCacheManager

CacheManager getCacheManager()

Requests a CacheManager configured according to the getDefaultURI() and getDefaultProperties() be made available that using the getDefaultClassLoader() for loading underlying classes.

Multiple calls to this method must return the same CacheManager instance, accept if a previously returned CacheManager has been closed.

close

void close()

Closes all of the CacheManager instances and associated resources created and maintained by the CachingProvider across all ClassLoaders.

After closing the CachingProvider will still be operational. It may still be used for acquiring CacheManager instances, though those will now be new.

close

void close(ClassLoader classLoader)

Closes all CacheManager instances and associated resources created by the CachingProvider using the specified ClassLoader.

After closing the CachingProvider will still be operational. It may still be used for acquiring CacheManager instances, though those will now be new for the specified ClassLoader.

Parameters:

classLoader - the ClassLoader to release

close

void close(URI uri,
         ClassLoader classLoader)

Closes all CacheManager instances and associated resources created by the CachingProvider for the specified URI and ClassLoader.

Parameters:

uri - the URI to release

classLoader - the ClassLoader to release

isSupported

boolean isSupported(OptionalFeature optionalFeature)

Determines whether an optional feature is supported by the CachingProvider.

Parameters:

optionalFeature - the feature to check for

Returns:

true if the feature is supported