Class AccessTracker

java.lang.Object

com.loomcache.server.cache.AccessTracker

public class AccessTracker
extends Object

Tracks key access frequencies for hot-key preloading. Periodically flushes statistics to disk for cross-restart persistence.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	AccessTracker.AccessDistribution	Aggregate access distribution statistics.
static final record	AccessTracker.AccessStats	Access statistics for a single key.

Constructor Summary

Constructors

Constructor	Description
AccessTracker()	Create an AccessTracker without persistence.
AccessTracker(@Nullable String persistencePath, long flushIntervalMs)	Create an AccessTracker with optional persistence.

Method Summary

Modifier and Type	Method	Description
void	flush()	Flush statistics to disk.
AccessTracker.AccessDistribution	getAccessPattern()	Get access distribution statistics.
Map<String, AccessTracker.AccessStats>	getAllStats()	Get all access statistics.
@Nullable AccessTracker.AccessStats	getStats(String key)	Get access statistics for a specific key.
List<String>	getTopKeys(int n)	Get the top N most accessed keys.
void	load()	Load persisted statistics from disk.
void	recordAccess(String key)	Record an access to a key.
void	reset()	Reset all tracking data.

Methods inherited from class Object

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

Constructor Details

AccessTracker

public AccessTracker(@Nullable String persistencePath,
 long flushIntervalMs)

Create an AccessTracker with optional persistence.

Parameters:

persistencePath - path to persist stats (null to disable persistence)

flushIntervalMs - how often to flush stats to disk

AccessTracker

public AccessTracker()

Create an AccessTracker without persistence.

Method Details

recordAccess

public void recordAccess(String key)

Record an access to a key.

getTopKeys

public List<String> getTopKeys(int n)

Get the top N most accessed keys.

getStats

public @Nullable AccessTracker.AccessStats getStats(String key)

Get access statistics for a specific key.

getAllStats

public Map<String, AccessTracker.AccessStats> getAllStats()

Get all access statistics.

getAccessPattern

public AccessTracker.AccessDistribution getAccessPattern()

Get access distribution statistics.

reset

public void reset()

Reset all tracking data.

load

public void load()

Load persisted statistics from disk.

flush

public void flush()

Flush statistics to disk.