Class DefaultCache

java.lang.Object

io.fluxzero.sdk.persisting.caching.DefaultCache

All Implemented Interfaces:

AutoCloseable

public final class DefaultCache
extends Object
implements AutoCloseable

Default aggregate cache facade that selects the current SDK cache implementation from Fluxzero cache properties.

Existing applications without a defaults version or explicit MODE_PROPERTY keep the legacy SoftReferenceCache. Newer applications that use Fluxzero defaults >= 2026.05.25, or set fluxzero.cache.mode = adaptive, use AdaptiveObjectCache.

Field Summary

Fields

Modifier and Type	Field	Description
static final LocalDate	ADAPTIVE_DEFAULTS_VERSION	Fluxzero defaults version from which DefaultCache uses AdaptiveObjectCache by default.
static final String	MAX_SIZE_PROPERTY	Property that configures the maximum entry count for AdaptiveObjectCache when selected by DefaultCache.
static final String	MODE_ADAPTIVE	MODE_PROPERTY value that selects AdaptiveObjectCache.
static final String	MODE_PROPERTY	Property that selects the cache implementation used by DefaultCache.
static final String	MODE_SOFT_REFERENCE	MODE_PROPERTY value that selects SoftReferenceCache.

Constructor Summary

Constructors

Constructor	Description
DefaultCache()	Constructs a cache using the active Fluxzero property source, or the default property source when no Fluxzero instance is active.
DefaultCache(int maxSize)	Constructs a cache with a specified max size for the selected implementation.
DefaultCache(int maxSize, Duration expiry)	Constructs a cache with specified size and expiration for the selected implementation.
DefaultCache(io.fluxzero.common.application.PropertySource propertySource)	Constructs a cache using the given property source for cache mode and defaults-version selection.
DefaultCache(io.fluxzero.common.application.PropertySource propertySource, int maxSize)	Constructs a cache using the given property source for cache mode and defaults-version selection, with a custom max size for the selected implementation.

Method Summary

Modifier and Type	Method	Description
void	clear()
void	close()
<T> T	compute(Object id, BiFunction<? super Object, ? super T, ? extends T> mappingFunction)
<T> T	computeIfAbsent(Object id, Function<? super Object, T> mappingFunction)
<T> T	computeIfPresent(Object id, BiFunction<? super Object, ? super T, ? extends T> mappingFunction)
boolean	containsKey(Object id)
io.fluxzero.common.caching.Cache	delegate()	Returns the selected cache implementation.
<T> T	get(Object id)
default <T> T	getOrDefault(Object arg0, T arg1)
default boolean	isEmpty()
<T> void	modifyEach(BiFunction<? super Object, ? super T, ? extends T> modifierFunction)
Object	put(Object id, Object value)
Object	putIfAbsent(Object id, Object value)
io.fluxzero.common.caching.Cache	rebuild()
io.fluxzero.common.Registration	registerEvictionListener(Consumer<io.fluxzero.common.caching.CacheEviction> listener)
<T> T	remove(Object id)
int	size()

Methods inherited from class Object

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

Field Details

ADAPTIVE_DEFAULTS_VERSION

public static final LocalDate ADAPTIVE_DEFAULTS_VERSION

Fluxzero defaults version from which DefaultCache uses AdaptiveObjectCache by default.

MODE_PROPERTY

public static final String MODE_PROPERTY

Property that selects the cache implementation used by DefaultCache.

See Also:

• Constant Field Values

MODE_SOFT_REFERENCE

public static final String MODE_SOFT_REFERENCE

MODE_PROPERTY value that selects SoftReferenceCache.

See Also:

• Constant Field Values

MODE_ADAPTIVE

public static final String MODE_ADAPTIVE

MODE_PROPERTY value that selects AdaptiveObjectCache.

See Also:

• Constant Field Values

MAX_SIZE_PROPERTY

public static final String MAX_SIZE_PROPERTY

Property that configures the maximum entry count for AdaptiveObjectCache when selected by DefaultCache.

See Also:

• Constant Field Values

Constructor Details

DefaultCache

public DefaultCache()

Constructs a cache using the active Fluxzero property source, or the default property source when no Fluxzero instance is active.

DefaultCache

public DefaultCache(io.fluxzero.common.application.PropertySource propertySource)

Constructs a cache using the given property source for cache mode and defaults-version selection.

DefaultCache

public DefaultCache(io.fluxzero.common.application.PropertySource propertySource,
 int maxSize)

Constructs a cache using the given property source for cache mode and defaults-version selection, with a custom max size for the selected implementation.

DefaultCache

public DefaultCache(int maxSize)

Constructs a cache with a specified max size for the selected implementation.

DefaultCache

public DefaultCache(int maxSize,
 Duration expiry)

Constructs a cache with specified size and expiration for the selected implementation.

Method Details

delegate

public io.fluxzero.common.caching.Cache delegate()

Returns the selected cache implementation.

put

public Object put(Object id,
 Object value)

putIfAbsent

public Object putIfAbsent(Object id,
 Object value)

computeIfAbsent

public <T> T computeIfAbsent(Object id,
 Function<? super Object, T> mappingFunction)

computeIfPresent

public <T> T computeIfPresent(Object id,
 BiFunction<? super Object, ? super T, ? extends T> mappingFunction)

compute

public <T> T compute(Object id,
 BiFunction<? super Object, ? super T, ? extends T> mappingFunction)

modifyEach

public <T> void modifyEach(BiFunction<? super Object, ? super T, ? extends T> modifierFunction)

get

public <T> T get(Object id)

containsKey

public boolean containsKey(Object id)

remove

public <T> T remove(Object id)

clear

public void clear()

size

public int size()

registerEvictionListener

public io.fluxzero.common.Registration registerEvictionListener(Consumer<io.fluxzero.common.caching.CacheEviction> listener)

rebuild

public io.fluxzero.common.caching.Cache rebuild()

close

public void close()

Specified by:

close in interface AutoCloseable

getOrDefault

default <T> T getOrDefault(Object arg0,
 T arg1)

isEmpty

default boolean isEmpty()