c++如何实现一个简单的ORM框架_c++ ODB与SQLite实例【数据库】_技术教程

用ODB+SQLite实现简单ORM框架，即通过ODB编译器将C++类自动映射为数据库表，生成类型安全的CRUD代码，无需手写SQL或运行时反射，兼顾性能与开发效率。

用 C++ 实现一个“简单 ORM 框架”不等于从零手写完整 ORM（那工作量极大），而是指：用成熟轻量的库（如 ODB）+ SQLite 做数据持久化，以极简方式达成“对象 ↔ 数据库表”的自动映射。下面直接讲清楚怎么做、关键步骤和避坑点。

选 ODB 而不是手撸 ORM 的理由

ODB 是 C++ 领域少有的生产级、无运行时反射、编译期代码生成的 ORM 工具。它不依赖 RTTI 或宏魔法，生成的是纯 C++ 代码，性能高、可调试、兼容标准。相比自己实现序列化 + SQL 拼接 + 类型转换，ODB 省掉 90% 重复逻辑，且天然支持 SQLite、PostgreSQL、MySQL。

注意：ODB 不是头文件库，需安装 + 使用 odb 编译器生成数据库操作代码。

环境准备与最小依赖

确保已安装：

SQLite3 开发库（含 sqlite3.h 和动态/静态库）
ODB 编译器（odb）及对应 SQLite profile（libodb-sqlite）
C++11 或更高（ODB 2.5+ 推荐 C++14）

Ubuntu 示例：
sudo apt install sqlite3 libsqlite3-dev
从 ODB 官网下载预编译版或源码编译，启用 SQLite profile

定义类并添加 ODB 指令（.h 文件）

比如一个用户类，保存到 user.hxx：

#pragma once
#include 
#include 

#pragma db object
struct user
{
  #pragma db id auto
  unsigned long id;

  #pragma db not_null
  std::string name;

  #pragma db not_null
  unsigned int age;
};

说明：

#pragma db object 告诉 ODB 这是个映射类
#pragma db id auto 表示主键由 SQLite 自增（对应 INTEGER PRIMARY KEY）
not_null 保证字段非空，ODB 会生成约束检查

用 odb 编译器生成数据库代码

在终端执行（假设文件叫 user.hxx）：

odb --sqlite --generate-query --generate-schema user.hxx

会生成 5 个文件：
user-odb.hxx, user-odb.ixx, user-odb.cxx, user-odb.sql, user-odb.hpp

其中：

.sql 是建表语句（可直接执行或嵌入程序）
.cxx 和 .hxx 是核心操作类（database, transaction, query, result）

把生成的 .cxx 加入项目编译；.hxx 在你的主程序中 #include 即可。

实际使用：增删改查四行代码

主程序示例（main.cpp）：

#include 
#include 
#include 
#include "user-odb.hxx" // 生成的头

int main()
{
  odb::sqlite::database db("test.db"); // 自动创建文件
  odb::core::database& db_ref = db;

  // 插入
  user u{0, "Alice", 28};
  db_ref.persist(u);

  // 查询所有
  odb::transaction t(db_ref);
  auto r = db_ref.query(odb::query::age > 18);
  for (const auto& x : r) {
    std::cout << x.name << ", " << x.age << "\n";
  }
  t.commit();

  return 0;
}

关键点：