Class MemoryManager

java.lang.Object

com.loomcache.server.cache.MemoryManager

public class MemoryManager
extends Object

Monitors JVM heap usage and cache memory consumption. Triggers eviction callbacks when soft/hard limits are reached.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	MemoryManager.MemoryStats	Memory usage statistics.
static final record	MemoryManager.MemoryThreshold	Memory threshold configuration. softLimit: 80% of heap — triggers background eviction hardLimit: 90% of heap — rejects new writes

Constructor Summary

Constructors

Constructor	Description
MemoryManager(MemoryManager.MemoryThreshold thresholds)

Method Summary

Modifier and Type	Method	Description
boolean	checkHardLimit(long cacheBytes)	Check if memory is above hard limit.
boolean	checkSoftLimit(long cacheBytes)	Check if memory is above soft limit.
long	getHardLimitBytes()	Get hard limit threshold in bytes.
long	getSoftLimitBytes()	Get soft limit threshold in bytes.
MemoryManager.MemoryStats	getStats(long cacheBytes)	Get current memory statistics from the JVM.
void	registerEvictionCallback(Runnable callback)	Register a callback to be invoked when soft limit is reached.
void	unregisterEvictionCallback(Runnable callback)	Unregister an eviction callback.
static MemoryManager	withDefaultThresholds()	Create a MemoryManager with default thresholds (80%/90% of max heap).

Methods inherited from class Object

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

Constructor Details

MemoryManager

public MemoryManager(MemoryManager.MemoryThreshold thresholds)

Method Details

withDefaultThresholds

public static MemoryManager withDefaultThresholds()

Create a MemoryManager with default thresholds (80%/90% of max heap).

getStats

public MemoryManager.MemoryStats getStats(long cacheBytes)

Get current memory statistics from the JVM.

checkSoftLimit

public boolean checkSoftLimit(long cacheBytes)

Check if memory is above soft limit. If so, trigger eviction callbacks.

checkHardLimit

public boolean checkHardLimit(long cacheBytes)

Check if memory is above hard limit.

registerEvictionCallback

public void registerEvictionCallback(Runnable callback)

Register a callback to be invoked when soft limit is reached.

unregisterEvictionCallback

public void unregisterEvictionCallback(Runnable callback)

Unregister an eviction callback.

getSoftLimitBytes

public long getSoftLimitBytes()

Get soft limit threshold in bytes.

getHardLimitBytes

public long getHardLimitBytes()

Get hard limit threshold in bytes.