Skip to content

LoomCache Documentation

Raft-consistent, virtual-thread-native, and honestly documented. Built in Java 25 from scratch.

LoomCache implements Raft consensus directly over a custom 108-opcode binary protocol.

Raft Consensus Flow

Waiting for client request...

Client
Leader Node
WAL Term
Follower 1
Follower 2

Virtual-Thread TCP Server

Java 25 virtual-thread-per-connection networking. Thousands of concurrent clients per node without thread-pool tuning.

Linearizable by Default

Single-group Raft with pre-vote, leader lease, ReadIndex, and WAL + snapshot persistence. Every committed write is replicated to a majority before acknowledgment.

Honest Data-Structure Story

Client SDK exposes Map, Queue, Set, Topic, and a linearizable AtomicLong today. Production sharding, wire locks/semaphores, local JCache durability, MapStore, SQL indexes, server LRU/LFU/FIFO/RANDOM, finite eviction, max-idle, and implicit POJO object mode remain unsupported in this release.

Zero Cache Dependencies

No Hazelcast port, no Redis fork, and no Netty in the core protocol runtime. Custom binary protocol, Kryo 5.6.2 serialization, optional Netty TLS contexts, Calcite-backed SQL engine, and Spring Boot 4.0.5 auto-configuration.

Chaos-Tested

Java Jepsen-style harness: linearizability / partition / disk / clock / process / combined scenarios with a Wing-Gong checker. 17,000+ test methods across 748 test files.

Observability Built In

Micrometer metrics, Prometheus scrape endpoint, JMX MXBeans, optional OpenTelemetry bridge, cluster health monitor, slow-query log, and a built-in dashboard at /dashboard.

Houston, We Have Zero Failures

14,100+ tests across 637 test files verify linearizability across 35 chaos fault scenarios

Houston mascot
Basic
Network
Leader
Clock Skew
Disk
Concurrency
35
Fault Scenarios
6
Test Categories
100%
Verified