io.micronaut.cache

Interface SyncCache<C>

Type Parameters:

C - The native cache implementation

All Superinterfaces:

Cache<C>

All Known Implementing Classes:

DefaultSyncCache

public interface SyncCache<C>
extends Cache<C>

A synchronous API for accessing cache values that is useful for in-memory caching implementations.

Caching implementations that require blocking IO should implement the async() method to provide a non-blocking implementation of this interface

Implementers of this interface should mark the implementation as Blocking if a blocking operation is required to read or write cache values

Since:

1.0

Author:

Graeme Rocher

See Also:

Cache, AsyncCache

Method Summary

Modifier and Type	Method and Description
default AsyncCache<C>	async() This method should return an async API version of this cache interface implementation.
<T> Optional<T>	get(Object key, Argument<T> requiredType) Resolve the given value for the given key.
<T> T	get(Object key, Argument<T> requiredType, Supplier<T> supplier) Resolve the given value for the given key.
default <T> Optional<T>	get(Object key, Class<T> requiredType) Resolve the given value for the given key.
default <T> T	get(Object key, Class<T> requiredType, Supplier<T> supplier) Resolve the given value for the given key.
void	invalidate(Object key) Invalidate the value for the given key.
void	invalidateAll() Invalidate all cached values within this cache.
void	put(Object key, Object value) Cache the specified value using the specified key.
<T> Optional<T>	putIfAbsent(Object key, T value) Cache the specified value using the specified key if it is not already present.

Methods inherited from interface io.micronaut.cache.Cache

getCacheInfo, getName, getNativeCache

Method Detail

get

@Nonnull
<T> Optional<T> get(@Nonnull
                             Object key,
                             @Nonnull
                             Argument<T> requiredType)

Resolve the given value for the given key.

Type Parameters:

T - The concrete type

Parameters:

key - The cache key

requiredType - The required type

Returns:

An optional containing the value if it exists and is able to be converted to the specified type

get

<T> T get(@Nonnull
          Object key,
          @Nonnull
          Argument<T> requiredType,
          @Nonnull
          Supplier<T> supplier)

Resolve the given value for the given key. If the value is not found the specified Supplier will be invoked and the return value cached.

Type Parameters:

T - The concrete type

Parameters:

key - The cache key

requiredType - The required type

supplier - The supplier that should be invoked if the value is not found

Returns:

An optional containing the value if it exists and is able to be converted to the specified type

putIfAbsent

@Nonnull
<T> Optional<T> putIfAbsent(@Nonnull
                                     Object key,
                                     @Nonnull
                                     T value)

Cache the specified value using the specified key if it is not already present.

Type Parameters:

T - The concrete type

Parameters:

key - the key with which the specified value is to be associated

value - the value to be associated with the specified key

Returns:

An optional of the existing value or Optional.empty() if the specified value parameter was cached

put

void put(@Nonnull
         Object key,
         @Nonnull
         Object value)

Cache the specified value using the specified key.

Parameters:

key - the key with which the specified value is to be associated

value - the value to be associated with the specified key

invalidate

void invalidate(@Nonnull
                Object key)

Invalidate the value for the given key.

Parameters:

key - The key to invalid

invalidateAll

void invalidateAll()

Invalidate all cached values within this cache.

get

default <T> T get(@Nonnull
                  Object key,
                  @Nonnull
                  Class<T> requiredType,
                  @Nonnull
                  Supplier<T> supplier)

Resolve the given value for the given key. If the value is not found the specified Supplier will be invoked and the return value cached.

Type Parameters:

T - The concrete type

Parameters:

key - The cache key

requiredType - The required type

supplier - The supplier that should be invoked if the value is not found

Returns:

An optional containing the value if it exists and is able to be converted to the specified type

get

@Nonnull
default <T> Optional<T> get(@Nonnull
                                     Object key,
                                     @Nonnull
                                     Class<T> requiredType)

Resolve the given value for the given key.

Type Parameters:

T - The concrete type

Parameters:

key - The cache key

requiredType - The required type

Returns:

An optional containing the value if it exists and is able to be converted to the specified type

async

@Nonnull
default AsyncCache<C> async()

This method should return an async API version of this cache interface implementation.

The default behaviour assumes the cache implementation is running in-memory and performs no blocking operations and hence simply delegates to the SyncCache implementation. If I/O operations are required implementors should override this API and provide an API that implements AsyncCache in a non-blocking manner.

Returns:

The AsyncCache implementation for this cache