FOpen* 的 SQLite VFS 实施指南

Question

我即将使用 FOpen、FRead、FWrite、FSeek 和 FClose 为 Netburner 嵌入式设备（非 Windows）实现自定义 VFS（虚拟文件系统）。我很惊讶我找不到可用的 VFS 的 FOpen* 版本。这将使它更容易移植到嵌入式设备。

我在这里找到了一些有关为 SQLite 创建 VFS 的信息 http://sqlite.org/c3ref/vfs.html 但信息非常详细，我对实施还有很多其他问题。

我在 Win、OS2、Linux 的 SQLite 源代码中有一些示例 VFS，但它们没有很多注释，只有源代码。

我可以使用上面链接中提供的信息和示例来创建我的自定义 VFS，但我确信如果我这样做的话我会错过一些东西。

我的问题是：

• 是否还有我缺少的有关 SQLite VFS 的更多文档？也许是实施指南？
• 是否有可用的 SQLite VFS 的 Fopen 版本？
• 创建自定义 SQLite VFS 后，是否有单元测试代码可用于测试它？
• 您想分享的建议、评论、实施 SQLite VFS 的经验。

Answer 1

您是否注意到头文件 sqlite3.h 中有一个额外的文档来源？此外，Google 代码搜索也是您的朋友。

不要太担心遗漏东西，这就是测试套件的用途。从每个方法的名称、文档和示例实现中猜测其用途；进行初稿实施；在您的目标平台上运行测试；迭代直到条变成绿色。通过粗略地阅读您引用的界面文档，以下是一些有根据的猜测：

  int (*xOpen)(sqlite3_vfs*, const char *zName, sqlite3_file*,
               int flags, int *pOutFlags);
  int (*xDelete)(sqlite3_vfs*, const char *zName, int syncDir);
  int (*xAccess)(sqlite3_vfs*, const char *zName, int flags, int *pResOut);
  int (*xFullPathname)(sqlite3_vfs*, const char *zName, int nOut, char *zOut);

这些是您的常规文件管理功能。您会注意到，xOpen() 又返回一个结构 sqlite3_file，它具有自己的用于读取和写入的指针方法。

  void *(*xDlOpen)(sqlite3_vfs*, const char *zFilename);
  void (*xDlError)(sqlite3_vfs*, int nByte, char *zErrMsg);
  void (*(*xDlSym)(sqlite3_vfs*,void*, const char *zSymbol))(void);
  void (*xDlClose)(sqlite3_vfs*, void*);

这些用于共享库（请参阅 Linux 上的 dlopen() 手册页）。在嵌入式环境中，您可能可以不实现这些（尝试将它们设置为 NULL）。

  int (*xRandomness)(sqlite3_vfs*, int nByte, char *zOut);

如果您的操作系统的标准库尚未提供随机数生成器，您可能必须实现随机数生成器。我建议使用线性反馈寄存器，它虽小但很好。

  int (*xSleep)(sqlite3_vfs*, int microseconds);
  int (*xCurrentTime)(sqlite3_vfs*, double*);
  int (*xCurrentTimeInt64)(sqlite3_vfs*, sqlite3_int64*);

这些是时间管理功能，用于与您的操作系统连接。

  int (*xGetLastError)(sqlite3_vfs*, int, char *);

您可以通过在此处始终返回 0 来逃脱:-) 请参阅 os_unix.c 中的 unixGetLastError （感谢 Google 代码搜索！）祝您

好运！

Answer 2

一种选择是使用基于内存的 VFS，然后在完成后将内存转储到文件。请参阅：http://article.gmane.org/gmane.comp.db .sqlite.general/46450 用于已经支持序列化/反序列化的基于内存的 VFS。

缺点是您必须手动写出文件才能使其保留。如果您的应用程序突然终止，对数据库的任何中间更改都将不会被持久化。