Package org.springframework.boot.actuate.cache

Class CachesEndpoint

java.lang.Object

org.springframework.boot.actuate.cache.CachesEndpoint

@Endpoint(id="caches")
public class CachesEndpoint
extends Object

@Endpoint to expose available caches.

Since:

2.1.0

Author:

Johannes Edmeier, Stephane Nicoll

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CachesEndpoint.CacheDescriptor	Description of a Cache.
static final class	CachesEndpoint.CacheEntryDescriptor	Description of a Cache entry.
static final class	CachesEndpoint.CacheManagerDescriptor	Description of a CacheManager.
static final class	CachesEndpoint.CachesDescriptor	Description of the caches.

Constructor Summary

Constructors

Constructor	Description
CachesEndpoint(Map<String,CacheManager> cacheManagers)	Create a new endpoint with the CacheManager instances to use.

Method Summary

Modifier and Type	Method	Description
CachesEndpoint.CacheEntryDescriptor	cache(String cache, String cacheManager)	Return a CachesEndpoint.CacheDescriptor for the specified cache.
CachesEndpoint.CachesDescriptor	caches()	Return a CachesEndpoint.CachesDescriptor of all available caches.
boolean	clearCache(String cache, String cacheManager)	Clear the specific Cache.
void	clearCaches()	Clear all the available caches.

Methods inherited from class java.lang.Object

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

Constructor Details

CachesEndpoint

public CachesEndpoint(Map<String,CacheManager> cacheManagers)

Create a new endpoint with the CacheManager instances to use.

Parameters:

cacheManagers - the cache managers to use, indexed by name

Method Details

caches

@ReadOperation
public CachesEndpoint.CachesDescriptor caches()

Return a CachesEndpoint.CachesDescriptor of all available caches.

Returns:

a caches reports

cache

@ReadOperation
public CachesEndpoint.CacheEntryDescriptor cache(@Selector
 String cache,
 @Nullable
 String cacheManager)

Return a CachesEndpoint.CacheDescriptor for the specified cache.

Parameters:

cache - the name of the cache

cacheManager - the name of the cacheManager (can be null

Returns:

the descriptor of the cache or null if no such cache exists

Throws:

NonUniqueCacheException - if more than one cache with that name exists and no cacheManager was provided to identify a unique candidate

clearCaches

@DeleteOperation
public void clearCaches()

Clear all the available caches.

clearCache

@DeleteOperation
public boolean clearCache(@Selector
 String cache,
 @Nullable
 String cacheManager)

Clear the specific Cache.

Parameters:

cache - the name of the cache

cacheManager - the name of the cacheManager (can be null to match all)

Returns:

true if the cache was cleared or false if no such cache exists

Throws:

NonUniqueCacheException - if more than one cache with that name exists and no cacheManager was provided to identify a unique candidate