How muhammadtahanasir/apexkv works
ApexKV is a Java in-memory cache with Redis-style TCP commands, an interactive CLI, and an HTTP dashboard. The main workflow accepts commands through the TCP server and command processor, then delegates cache operations to the engine and in-memory storage; the dashboard provides a separate HTTP control and inspection surface. The engine also coordinates typed values, eviction, TTL cleanup, persistence, metrics, and messaging. Relationships involving unsampled modules are included only where the README or SOURCE INDEX supports them; the index does not establish every runtime call.
Main entry points: CacheEngine.java Cache engine · DashboardHttpServer.java HTTP dashboard · CommandProcessor.java Command processor · ExpirationScheduler.java TTL scheduler
Components 22
Access surfaces
- Redis TCP server
src/main/java/com/apexkv/server/RedisTcpServer.java - Command processor
src/main/java/com/apexkv/server/CommandProcessor.java - Interactive CLI
src/main/java/com/apexkv/cli/MiniRedisCli.java - HTTP dashboard
src/main/java/com/apexkv/server/DashboardHttpServer.java
Cache engine
- Cache API contracts
src/main/java/com/apexkv/api/CacheOperations.java - Cache engine
src/main/java/com/apexkv/core/CacheEngine.java - In-memory storage
src/main/java/com/apexkv/core/StorageEngine.java - Cache entries
src/main/java/com/apexkv/core/CacheEntry.java - Namespaces
src/main/java/com/apexkv/core/NamespaceManager.java - Typed values
src/main/java/com/apexkv/value
Cache lifecycle
- Eviction strategies
src/main/java/com/apexkv/eviction/EvictionFactory.java - TTL scheduler
src/main/java/com/apexkv/expiration/ExpirationScheduler.java - Cache event publisher
src/main/java/com/apexkv/event/CacheEventPublisher.java
Durability and messaging
- Write-ahead log
src/main/java/com/apexkv/persistence/WriteAheadLog.java - Snapshot manager
src/main/java/com/apexkv/persistence/SnapshotManager.java - Pub/sub engine
src/main/java/com/apexkv/pubsub/PubSubEngine.java
Analytics
- Metrics collector
src/main/java/com/apexkv/metrics/MetricsCollector.java - Memory statistics
src/main/java/com/apexkv/metrics/MemoryStats.java - Hot-key tracker
src/main/java/com/apexkv/metrics/HotKeyTracker.java - Cache benchmark
src/main/java/com/apexkv/benchmark/CacheBenchmark.java
Other components
- Cache client
- Operator
Connections 27
- Cache client → Redis TCP server: sends commands
README.md - Redis TCP server → Command processor: dispatches commands
src/main/java/com/apexkv/server/RedisTcpServer.java - Command processor → Cache engine: executes operations
src/main/java/com/apexkv/server/CommandProcessor.java - Operator → Interactive CLI: enters commands
README.md - Interactive CLI → Command processor: uses processor
src/main/java/com/apexkv/cli/MiniRedisCli.java - Operator → HTTP dashboard: uses dashboard
README.md - HTTP dashboard → Cache engine: reads and mutates
src/main/java/com/apexkv/server/DashboardHttpServer.java - HTTP dashboard → Cache benchmark: runs benchmarks
src/main/java/com/apexkv/server/DashboardHttpServer.java - Cache engine → In-memory storage: reads and writes
src/main/java/com/apexkv/core/CacheEngine.java - In-memory storage → Cache entries: stores entries
src/main/java/com/apexkv/core/StorageEngine.java - Cache engine → Typed values: creates values
src/main/java/com/apexkv/core/CacheEngine.java - Cache engine → Cache API contracts: implements contracts
src/main/java/com/apexkv/core/CacheEngine.java - Command processor → Namespaces: uses namespaces
src/main/java/com/apexkv/server/CommandProcessor.java - Cache engine → Eviction strategies: selects policy
src/main/java/com/apexkv/core/CacheEngine.java - Cache engine → TTL scheduler: registers TTL
src/main/java/com/apexkv/core/CacheEngine.java - TTL scheduler → In-memory storage: removes expired
src/main/java/com/apexkv/expiration/ExpirationScheduler.java - Cache engine → Cache event publisher: publishes changes
src/main/java/com/apexkv/core/CacheEngine.java - TTL scheduler → Cache event publisher: publishes expiry
src/main/java/com/apexkv/expiration/ExpirationScheduler.java - Cache engine → Write-ahead log: logs mutations
src/main/java/com/apexkv/core/CacheEngine.java - Cache engine → Snapshot manager: saves snapshots
src/main/java/com/apexkv/core/CacheEngine.java - Command processor → Pub/sub engine: publishes messages
src/main/java/com/apexkv/server/CommandProcessor.java - HTTP dashboard → Pub/sub engine: publishes messages
src/main/java/com/apexkv/server/DashboardHttpServer.java - Cache engine → Pub/sub engine: owns messaging
src/main/java/com/apexkv/core/CacheEngine.java - Cache engine → Metrics collector: records operations
src/main/java/com/apexkv/core/CacheEngine.java - Metrics collector → Hot-key tracker: tracks hot keys
src/main/java/com/apexkv/metrics/MetricsCollector.java - Cache engine → Memory statistics: reports capacity
src/main/java/com/apexkv/core/CacheEngine.java - HTTP dashboard → Metrics collector: displays analytics