基于已有的 KV 引擎，本文详细解析文章型键值扩展的完整流程，包括多行正文解析、切片存储机制、增量日志绑定，以及客户端交互反馈示例。
一、文章型键值扩展概览
为了支持 大文本、多行正文 的存储，KVStore 引入了 article.c 扩展模块，提供如下能力：
多行 SET 命令：
SET key <多行正文>
...
END
支持正文超过 CHUNK_SIZE 的自动切片存储
切片存储绑定增量日志，实现持久化
提供 GET、MOD、DEL、EXIST 命令，兼容普通键值与切片键值
核心函数：article_protocol()（协议解析）、article_handler()（网络层接口）
二、切片存储机制（chunked storage）
1. 保存正文
核心函数 save_chunked_value()：
cpp
static void save_chunked_value(const char *key, const char *value) {
int len = strlen(value);
int chunks = (len + CHUNK_SIZE - 1) / CHUNK_SIZE;
char subkey[512];
char chunkbuf[CHUNK_SIZE + 1];
for (int i = 0; i < chunks; i++) {
snprintf(subkey, sizeof(subkey), "%s#%d", key, i);
int start = i * CHUNK_SIZE;
int size = (len - start > CHUNK_SIZE) ? CHUNK_SIZE : (len - start);
strncpy(chunkbuf, value + start, size);
chunkbuf[size] = '\0';
kvs_set(subkey, chunkbuf);
journal_append("SET", subkey, chunkbuf);
}
snprintf(subkey, sizeof(subkey), "%s#meta", key);
char meta[32];
sprintf(meta, "%d", chunks);
kvs_set(subkey, meta);
journal_append("SET", subkey, meta);
}将正文拆分为若干片段，每片不超过 4KB
每片单独存储，键名为 key#0, key#1, ...
元信息存储在 key#meta，记录切片数量
每片写入 journal，保证增量持久化
2. 读取正文
核心函数 load_chunked_value()：
cpp
static char *load_chunked_value(const char *key) {
char meta_key[512];
snprintf(meta_key, sizeof(meta_key), "%s#meta", key);
char *meta_val = kvs_get(meta_key);
if (!meta_val) return NULL;
int chunks = atoi(meta_val);
char *result = malloc(chunks * CHUNK_SIZE + 1);
result[0] = '\0';
char subkey[512];
for (int i = 0; i < chunks; i++) {
snprintf(subkey, sizeof(subkey), "%s#%d", key, i);
char *chunk = kvs_get(subkey);
if (chunk) strcat(result, chunk);
}
return result;
}根据 meta 信息获取切片数量
按序拼接每片正文，恢复完整内容
3. 删除正文
核心函数 delete_chunked_value()：
cpp
static void delete_chunked_value(const char *key) {
char meta_key[512];
snprintf(meta_key, sizeof(meta_key), "%s#meta", key);
char *meta_val = kvs_get(meta_key);
if (!meta_val) return;
int chunks = atoi(meta_val);
char subkey[512];
for (int i = 0; i < chunks; i++) {
snprintf(subkey, sizeof(subkey), "%s#%d", key, i);
kvs_del(subkey);
journal_append("DEL", subkey, "");
}
kvs_del(meta_key);
journal_append("DEL", meta_key, "");
}遍历删除所有切片和 meta
日志记录每条 DEL 操作
三、协议解析与客户端交互
核心函数 article_protocol() 解析客户端命令：
SET：
普通模式：SET key value
正文大于 CHUNK_SIZE 自动切片
写入 journal
多行模式：
SET key
<多行正文>
END
循环读取客户端发送的多行数据
超长正文切片保存
GET：
自动检测切片或普通键值
返回完整内容
MOD：
删除旧切片
保存新内容（切片或普通）
DEL / EXIST：
支持普通键值与切片键值
SAVE / LOAD：
调用 snapshot 持久化接口
SAVE 后清空日志
LOAD 后可回放 journal，保证数据完整性
1. SET 命令示例
客户端发送多行：
SET MESSAGE
The Digital Crossroads: Navigating Human Connection in the Age of Technological Ubiquity
We stand at an unprecedented juncture...
END
服务器处理：
cpp
char buf[MAX_BODY_SIZE] = {0};
char line[1024];
while (fgets(line, sizeof(line), fp)) {
if (strncmp(line, "END", 3) == 0) break;
strcat(buf, line);
}
if (strlen(buf) > CHUNK_SIZE) save_chunked_value(key, buf);
else { kvs_set(key, buf); journal_append("SET", key, buf); }
sprintf(response, "OK\n");自动累积多行内容
超长正文切片存储
日志记录每条操作
2. GET 命令示例
cpp
char *val = load_chunked_value(key);
if (val) { sprintf(response, "%s\n", val); free(val); }
else { sprintf(response, "(nil)\n"); }检测是否存在切片
返回完整正文
3. MOD / DEL / EXIST
MOD 自动删除旧片段，保存新内容
DEL 删除所有片段
EXIST 同时检查普通键值与切片键值
四、与持久化机制结合
切片操作 完全兼容 snapshot 和 journal
SAVE/LOAD 调用 snapshot 接口
journal_append 记录每片写入和删除
系统恢复时：
LOAD 恢复全量 snapshot
journal 回放切片 SET/MOD/DEL 操作
保证多行大文本数据完整恢复
五、总结
多行文章型键值扩展：
支持任意长度正文（64KB 上限）
自动切片存储，配合 journal 实现增量持久化
客户端交互：
SET/GET/MOD/DEL/EXIST 命令支持多行正文
超长正文自动切片，透明给客户端
数据恢复：
SAVE/LOAD + journal 回放保证完整性
与普通 KV 引擎兼容
文章型键值扩展，使 KVStore 不仅可以处理简单键值，还能高效存储大文本、多行数据，并确保持久化与恢复完整
根据零声教育教学写作https://github.com/0voice