https://github.com/vnt-dev/raft
使用java基于raft协议实现的kv数据库
https://github.com/vnt-dev/raft
raft rocksdb
Last synced: 11 months ago
JSON representation
使用java基于raft协议实现的kv数据库
- Host: GitHub
- URL: https://github.com/vnt-dev/raft
- Owner: vnt-dev
- Created: 2020-12-12T06:28:46.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2021-01-16T13:08:07.000Z (about 5 years ago)
- Last Synced: 2025-04-03T15:04:56.945Z (11 months ago)
- Topics: raft, rocksdb
- Language: Java
- Homepage:
- Size: 2.52 MB
- Stars: 6
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 使用java基于raft协议实现的kv数据库
## 简介
1. 使用java实现的raft协议，在半数以上节点正常时服务可用，系统满足线性一致性；
2. 使用netty实现底层通信，利用protobuf进行编解码；
3. 使用rocksDB进行日志和状态机的持久化，数据基于磁盘，消耗内存小；
4. 使用rocksDB存储状态机快照，对日志落后过多的节点传输快照可以快速恢复数据；
5. 主节点请求复制日志的缓冲区会根据并发量动态调配，既能适应高吞吐量场景又能降低单次请求的响应时间；
6. 支持简单kv操作，支持过期时间的设置。
## 简单使用
### 一、搭建服务端集群
```
#运行jar即可(第一次启动jar会创建默认配置文件以及日志、状态机、快照文件目录，如需更换端口可修改对应配置)
#本机地址端口
ip=127.0.0.1
port=8040
#所有节点
nodes=127.0.0.1:8040,127.0.0.1:8041,127.0.0.1:8042
```
### 二、客户端使用
- 配置服务端节点，可以写在配置文件中，也可使用api配置
```
//这里简单使用api进行设置节点
PropertiesUtil.setValue("nodes", "127.0.0.1:8041,127.0.0.1:8042,127.0.0.1:8043");
```
- 同步调用(所有修改操作均支持过期时间的设置)
```
StringKvOperations operations = new StringKvOperations();
//设值
operations.opsForValue().set("test","v1");
//删除
operations.opsForValue().delete("test");
//设置key，并附带过期时间
operations.opsForValue().set("test","v1",1000L);
//存在时修改
boolean setIfPresent = operations.opsForValue().setIfPresent("test", "0");
//不存在时修改
boolean setIfAbsent = operations.opsForValue().setIfAbsent("test", "0");
//设置过期时间
boolean expire = operations.opsForValue().expire("test", 100L);
//获取
String testValue = operations.opsForValue().get("test");
//自增
long incr = operations.opsForValue().incr("test");
long incrBy = operations.opsForValue().incrBy("test",10L);
//自减
long decr = operations.opsForValue().decr("test");
//是否存在
boolean hasKey = operations.opsForValue().hasKey("test");
```
- 异步调用（数据操作和同步api一致，增加回调函数即可）
```
StringKvOperations operations = new StringKvOperations();
//异步自增
operations.opsForValueAsync().incr("async", v -> {
//自增成功后调用
System.out.println("async incr:"+v)
});
```