raw.hpp

#pragma once
 
#include <cstdint>
#include <cstring>
 
#include "flash.hpp"
#include "interface.hpp"
 
namespace LibXR
{
 
template <size_t MinWriteSize>
class DatabaseRaw : public Database
{
  static constexpr uint32_t FLASH_HEADER =
      0x12345678 + LIBXR_DATABASE_VERSION;
 
  static constexpr uint32_t CHECKSUM_BYTE = 0x9abcedf0;
 
  // 存储布局定义：块角色、位图编码、键头与块头。
  // Storage layout definitions: block roles, bitmap encodings, key headers,
  // and block headers.
#include "layout.hpp"
 
  size_t recycle_threshold_ = 0;
 
  Flash& flash_;
 
  uint32_t block_size_;
 
  uint8_t write_buffer_[MinWriteSize];
 
  // 底层 Flash 读写辅助：按最小写入单元对齐、补齐、复制。
  // Low-level Flash I/O helpers: minimum-write-unit alignment, tail padding,
  // and raw copying.
#include "flash_io.hpp"
 
  // 块级语义：初始化、校验、失效、已用空间计算和块间复制。
  // Block-level semantics: initialization, validation, invalidation,
  // used-space accounting, and block-to-block copying.
#include "block_ops.hpp"
 
  // 键级语义：查找、追加、逻辑更新、条目地址计算。
  // Key-level semantics: lookup, append, logical replacement, and entry
  // address calculations.
#include "key_ops.hpp"
 
 public:
  // 对外生命周期与主流程：构造、初始化、读写、恢复、回收。
  // Public lifecycle and main flow: construction, initialization, read/write,
  // restore, and recycle.
#include "lifecycle.hpp"
};
 
}  // namespace LibXR