RocksDB is an embedded KV database designed with write-ahead-log and log-structured-merge-tree. This project is a java version implementing persistent queue on RocksDB. It's very suitable for:

• Applications want to persistent data on local disk for preventing data loss in memory if a crash.
• Client and server speed do not match, but usually in memory queue are bounded, rocks-queue provides unlimited storage capacity.

1. RocksQueue consists of queue_name and _queue_name two column families. queue_name column family for storing data, _queue_name for storing queue's head and tail pointer.
2. RocksStore is a rocks queue factory and maintaining the <queue_name, RocksQueue> relationship.

StoreOptions storeOptions = StoreOptions.builder().database("rocks_db").build();
                    
rocksStore = new RocksStore(storeOptions);
queue = rocksStore.createQueue(generateQueueName());

byte[] something = "something".getBytes();
long id = queue.enqueue(something);

QueueItem dequeue = queue.dequeue();
assertArrayEquals(dequeue.getValue(), something);

You can also consume out the head of the queue and process it, and then invoke the removeHead method to delete it.

QueueItem head = queue.consume();
log.info("Processing queue head {}", head);

queue.removeHead()

This project can expose JMX metrics for monitoring.