2.持久化FileTxnLog

本文涉及的产品
RDS MySQL DuckDB 分析主实例,集群系列 4核8GB
RDS AI 助手,专业版
简介: 本文深入分析Zookeeper持久化机制的源码实现,重点解析`TxnLog`与`FileTxnLog`类。涵盖事务日志结构、文件格式、核心方法如append、commit、truncate及日志迭代器实现,揭示数据如何通过日志追加、校验、刷盘与截断保障持久化可靠性,为理解Zookeeper数据存储奠定基础。(238字)

一、前言
  前一篇已经分析了序列化,这篇接着分析Zookeeper的持久化过程源码,持久化对于数据的存储至关重要,下面进行详细分析。
二、持久化总体框架
  持久化的类主要在包org.apache.zookeeper.server.persistence下,此次也主要是对其下的类进行分析,其包下总体的类结构如下图所示。
  
  
· TxnLog,接口类型,读取事务性日志的接口。
  · FileTxnLog,实现TxnLog接口,添加了访问该事务性日志的API。
  · Snapshot,接口类型,持久层快照接口。
  · FileSnap,实现Snapshot接口,负责存储、序列化、反序列化、访问快照。
  · FileTxnSnapLog,封装了TxnLog和SnapShot。
  · Util,工具类,提供持久化所需的API。
  下面先来分析TxnLog和FileTxnLog的源码。
三、TxnLog源码分析
  TxnLog是接口,规定了对日志的响应操作。
其中,TxnLog除了提供读写事务日志的API外,还提供了一个用于读取日志的迭代器接口TxnIterator。
四、FileTxnLog源码分析
  对于LogFile而言,其格式可分为如下三部分
  LogFile:
    FileHeader TxnList ZeroPad
  FileHeader格式如下  
  FileHeader: {
    magic 4bytes (ZKLG)
    version 4bytes
    dbid 8bytes
  }
  TxnList格式如下
  TxnList:
    Txn || Txn TxnList
  Txn格式如下
  Txn:
    checksum Txnlen TxnHeader Record 0x42
  Txnlen格式如下
  Txnlen:
    len 4bytes
  TxnHeader格式如下
  TxnHeader: {
    sessionid 8bytes
    cxid 4bytes
    zxid 8bytes
    time 8bytes
    type 4bytes
  }
  ZeroPad格式如下
  ZeroPad:
    0 padded to EOF (filled during preallocation stage)
  了解LogFile的格式对于理解源码会有很大的帮助。
4.1 属性 
4.2. 核心函数 

  1. append函数
    说明:append函数主要用做向事务日志中添加一个条目,其大体步骤如下
      ① 检查TxnHeader是否为空,若不为空,则进入②,否则,直接返回false
      ② 检查logStream是否为空(初始化为空),若不为空,则进入③,否则,进入⑤
      ③ 初始化写数据相关的流和FileHeader,并序列化FileHeader至指定文件,进入④
      ④ 强制刷新(保证数据存到磁盘),并获取当前写入数据的大小。进入⑤
      ⑤ 填充数据,填充0,进入⑥
      ⑥ 将事务头和事务序列化成ByteBuffer(使用Util.marshallTxnEntry函数),进入⑦
      ⑦ 使用Checksum算法更新步骤⑥的ByteBuffer。进入⑧
      ⑧ 将更新的ByteBuffer写入磁盘文件,返回true
    append间接调用了padLog函数,其源码如下 
    说明:padLog其主要作用是当文件大小不满64MB时,向文件填充0以达到64MB大小。
  2. getLogFiles函数 
    说明:该函数的作用是找出刚刚小于或者等于snapshot的所有log文件。其步骤大致如下。
      ① 对所有log文件按照zxid进行升序排序,进入②
      ② 遍历所有log文件并记录刚刚小于或等于给定snapshotZxid的log文件的logZxid,进入③
      ③ 再次遍历log文件,添加zxid大于等于步骤②中的logZxid的所有log文件,进入④
      ④ 转化后返回
    getLogFiles函数调用了sortDataDir,其源码如下
    说明:getLogFiles其用于排序log文件,可以选择根据zxid进行升序或降序。
    getLogFiles函数间接调用了getZxidFromName,其源码如下: 
    说明:getZxidFromName主要用作从文件名中解析zxid,并且需要从指定的前缀开始。
  3. getLastLoggedZxid函数 
    说明:该函数主要用于获取记录在log中的最后一个zxid。其步骤大致如下
      ① 获取已排好序的所有log文件,并从最后一个文件中取出zxid作为候选的最大zxid,进入②
      ② 新生成FileTxnLog并读取步骤①中zxid之后的所有事务,进入③
      ③ 遍历所有事务并提取出相应的zxid,最后返回。
    其中getLastLoggedZxid调用了read函数,其源码如下 
    说明:read函数会生成一个FileTxnIterator,其是TxnLog.TxnIterator的子类,之后在FileTxnIterator构造函数中会调用init函数,其源码如下
    说明:init函数用于进行初始化操作,会根据zxid的不同进行不同的初始化操作,在init函数中会调用goToNextLog函数,其源码如下  
    说明:goToNextLog表示选取下一个log文件,在init函数中还调用了next函数,其源码如下  
    说明:next表示将迭代器移动至下一个事务,方便读取,next函数的步骤如下。
      ① 读取事务的crcValue值,用于后续的验证,进入②
      ② 读取事务,使用CRC32进行更新并与①中的结果进行比对,若不相同,则抛出异常,否则,进入③
      ③ 将事务进行反序列化并保存至相应的属性中(如事务头和事务体),会确定具体的事务操作类型。
      ④ 在读取过程抛出异常时,会首先关闭流,然后再尝试调用next函数(即进入下一个事务进行读取)。
  4. commit函数  
    Java
    运行代码
    复制代码
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    public synchronized void commit() throws IOException {
    if (logStream != null) {

     // 强制刷到磁盘
     logStream.flush();
    

    }
    for (FileOutputStream log : streamsToFlush) { // 遍历流

     // 强制刷到磁盘
     log.flush();
     if (forceSync) { // 是否强制同步
         long startSyncNS = System.nanoTime();
    
         log.getChannel().force(false);
         // 计算流式的时间
         long syncElapsedMS =
             TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - startSyncNS);
         if (syncElapsedMS > fsyncWarningThresholdMS) { // 大于阈值时则会警告
             LOG.warn("fsync-ing the write ahead log in "
                      + Thread.currentThread().getName()
                      + " took " + syncElapsedMS
                      + "ms which will adversely effect operation latency. "
                      + "See the ZooKeeper troubleshooting guide");
         }
     }
    

    }
    while (streamsToFlush.size() > 1) { // 移除流并关闭

     streamsToFlush.removeFirst().close();
    

    }
    }
    说明:该函数主要用于提交事务日志至磁盘,其大致步骤如下
      ① 若日志流logStream不为空,则强制刷新至磁盘,进入②
      ② 遍历需要刷新至磁盘的所有流streamsToFlush并进行刷新,进入③
      ③ 判断是否需要强制性同步,如是,则计算每个流的流式时间并在控制台给出警告,进入④
      ④ 移除所有流并关闭。

  5. truncate函数 
    Java
    运行代码
    复制代码
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    public boolean truncate(long zxid) throws IOException {
    FileTxnIterator itr = null;
    try {
     // 获取迭代器
     itr = new FileTxnIterator(this.logDir, zxid);
     PositionInputStream input = itr.inputStream;
     long pos = input.getPosition();
     // now, truncate at the current position
     // 从当前位置开始清空
     RandomAccessFile raf = new RandomAccessFile(itr.logFile, "rw");
     raf.setLength(pos);
     raf.close();
     while (itr.goToNextLog()) { // 存在下一个log文件
         if (!itr.logFile.delete()) { // 删除
             LOG.warn("Unable to truncate {}", itr.logFile);
         }
     }
    
    } finally {
     // 关闭迭代器
     close(itr);
    
    }
    return true;
    }
    说明:该函数用于清空大于给定zxid的所有事务日志。
    五、总结
      对于持久化中的TxnLog和FileTxnLog的源码分析就已经完成了,本章节需重点记住:
    append函数实现日志追加,记录
    通过事务的crcValue验证,决定是否更新
    通过getLogFiles获取全部日志文件并排序
    通过getLastLoggedZxid找到最大的zxid,保证后续函数决定下一个日志文件id
    通过commit提交,真正生成日志文件
    通过trancate清空指定事务日志
相关文章
|
12天前
|
人工智能 自然语言处理 Shell
🦞 如何在 OpenClaw (Clawdbot/Moltbot) 配置阿里云百炼 API
本教程指导用户在开源AI助手Clawdbot中集成阿里云百炼API,涵盖安装Clawdbot、获取百炼API Key、配置环境变量与模型参数、验证调用等完整流程,支持Qwen3-max thinking (Qwen3-Max-2026-01-23)/Qwen - Plus等主流模型,助力本地化智能自动化。
🦞 如何在 OpenClaw (Clawdbot/Moltbot) 配置阿里云百炼 API
|
7天前
|
人工智能 安全 机器人
OpenClaw(原 Clawdbot)钉钉对接保姆级教程 手把手教你打造自己的 AI 助手
OpenClaw(原Clawdbot)是一款开源本地AI助手,支持钉钉、飞书等多平台接入。本教程手把手指导Linux下部署与钉钉机器人对接,涵盖环境配置、模型选择(如Qwen)、权限设置及调试,助你快速打造私有、安全、高权限的专属AI助理。(239字)
4294 12
OpenClaw(原 Clawdbot)钉钉对接保姆级教程 手把手教你打造自己的 AI 助手
|
8天前
|
人工智能 机器人 Linux
保姆级 OpenClaw (原 Clawdbot)飞书对接教程 手把手教你搭建 AI 助手
OpenClaw(原Clawdbot)是一款开源本地AI智能体,支持飞书等多平台对接。本教程手把手教你Linux下部署,实现数据私有、系统控制、网页浏览与代码编写,全程保姆级操作,240字内搞定专属AI助手搭建!
4674 17
保姆级 OpenClaw (原 Clawdbot)飞书对接教程 手把手教你搭建 AI 助手
|
6天前
|
人工智能 机器人 Linux
OpenClaw(Clawdbot、Moltbot)汉化版部署教程指南(零门槛)
OpenClaw作为2026年GitHub上增长最快的开源项目之一,一周内Stars从7800飙升至12万+,其核心优势在于打破传统聊天机器人的局限,能真正执行读写文件、运行脚本、浏览器自动化等实操任务。但原版全英文界面对中文用户存在上手门槛,汉化版通过覆盖命令行(CLI)与网页控制台(Dashboard)核心模块,解决了语言障碍,同时保持与官方版本的实时同步,确保新功能最快1小时内可用。本文将详细拆解汉化版OpenClaw的搭建流程,涵盖本地安装、Docker部署、服务器远程访问等场景,同时提供环境适配、问题排查与国内应用集成方案,助力中文用户高效搭建专属AI助手。
2994 8
|
10天前
|
人工智能 JavaScript 应用服务中间件
零门槛部署本地AI助手:Windows系统Moltbot(Clawdbot)保姆级教程
Moltbot(原Clawdbot)是一款功能全面的智能体AI助手,不仅能通过聊天互动响应需求,还具备“动手”和“跑腿”能力——“手”可读写本地文件、执行代码、操控命令行,“脚”能联网搜索、访问网页并分析内容,“大脑”则可接入Qwen、OpenAI等云端API,或利用本地GPU运行模型。本教程专为Windows系统用户打造,从环境搭建到问题排查,详细拆解全流程,即使无技术基础也能顺利部署本地AI助理。
7202 16
|
8天前
|
存储 人工智能 机器人
OpenClaw是什么?阿里云OpenClaw(原Clawdbot/Moltbot)一键部署官方教程参考
OpenClaw是什么?OpenClaw(原Clawdbot/Moltbot)是一款实用的个人AI助理,能够24小时响应指令并执行任务,如处理文件、查询信息、自动化协同等。阿里云推出的OpenClaw一键部署方案,简化了复杂配置流程,用户无需专业技术储备,即可快速在轻量应用服务器上启用该服务,打造专属AI助理。本文将详细拆解部署全流程、进阶功能配置及常见问题解决方案,确保不改变原意且无营销表述。
4925 5
|
10天前
|
人工智能 JavaScript API
零门槛部署本地 AI 助手:Clawdbot/Meltbot 部署深度保姆级教程
Clawdbot(Moltbot)是一款智能体AI助手,具备“手”(读写文件、执行代码)、“脚”(联网搜索、分析网页)和“脑”(接入Qwen/OpenAI等API或本地GPU模型)。本指南详解Windows下从Node.js环境搭建、一键安装到Token配置的全流程,助你快速部署本地AI助理。(239字)
4815 23
|
16天前
|
人工智能 API 开发者
Claude Code 国内保姆级使用指南:实测 GLM-4.7 与 Claude Opus 4.5 全方案解
Claude Code是Anthropic推出的编程AI代理工具。2026年国内开发者可通过配置`ANTHROPIC_BASE_URL`实现本地化接入:①极速平替——用Qwen Code v0.5.0或GLM-4.7,毫秒响应,适合日常编码;②满血原版——经灵芽API中转调用Claude Opus 4.5,胜任复杂架构与深度推理。
8948 13