DataFly Lib

DataFly Lib

为Adrenaline模组最初编写的简单异步I/O库

基础库

Datafly

一个面向 Fly 的 Minecraft 模组的共享异步 I/O 库,提供集中式、高性能的磁盘持久化。

特性

  • 所有模组共用一个线程池——不浪费线程,不重复编写 I/O 代码
  • 可从任意线程写入数据,并通过 DataTask 获取结果——无阻塞,无回调地狱
  • 读己之写保证——即使在数据落盘之前,读取也始终返回最新提交的值
  • 合并对同一键的突发写入——时间窗口内只有最后一个值真正写入磁盘
  • 通过 tmp → fsync → rename 实现原子写入——崩溃时不会留下写了一半或损坏的文件
  • 缓冲区内存不足时进行紧急 gzip 压缩——用 CPU 换取堆内存空间
  • 将超大写入溢写到临时 spool 目录,而不是阻塞或丢弃数据
  • 崩溃恢复——遗留的 spool 文件会在下次启动时重新排空到其目标位置
  • 可插拔编解码系统——JSON、NBT、TOML、YAML、原始字节,或自带编解码器
  • 按模组配置写入器——每个模组控制自己的堆内存上限、编解码器、合并窗口和缓存大小
  • 可选 LRU 读缓存——热点键完全跳过磁盘
  • update()——在整个周期内持有写锁的原子读-改-写
  • computeIfAbsent()——在一次原子调用中完成创建或更新
  • 与世界无关——可在主菜单、客户端、专用服务器等任何环境使用