How soundvibe/lasher works
Main Components
a. Core Components:
• LasherDB (Main key-value store)
• LasherMap (ConcurrentMap implementation)
• TimeLash (Time-series map implementation)
b. Storage Layer:
• Memory-mapped files (Index and Data files)
• Shard management system
c. Supporting Components:
• Serialization/Deserialization (Serde) framework
• Synchronization mechanisms
• File handling utilities
Component Relationships
• Client APIs → Core Implementation
• Core Implementation → Storage Layer
• All Components → Serde Framework (for data serialization)
• All Components → Synchronization Layer (for thread safety)
Specific Implementation Details
• Rectangles: Main components (LasherDB, LasherMap, TimeLash)
• Hexagons: Core processing components (Lasher, Shard)
• Ovals: Utility components (Serde, Synchronization)
• Blue: Client-facing APIs
• Green: Core processing
• Yellow: Storage
• Gray: Utilities
Following flows:
• Write path: Client → API → Core → Serde → Storage
• Read path: Client → API → Core → Storage → Serde → Client
• Time-series specific flow for TimeLash
• Shard management flow
Important Details to Highlight
• Memory-mapped file architecture (show both index and data files)
• Sharding mechanism
• Time-series partitioning for TimeLash
• Thread-safety mechanisms
• Serialization points
Technical Specifications
• Java version compatibility
• Memory management approach
• Thread safety guarantees
• Performance characteristics
• The lightweight nature of the system
• The memory-mapped file architecture
• The three distinct API options (DB, Map, TimeSeries)
• The efficient sharding and partitioning mechanisms