C++如何实现一个简单的ORM_C++对象关系映射框架soci的使用教程-C++-PHP中文网

C++如何实现一个简单的ORM_C++对象关系映射框架soci的使用教程

裘德小鎮的故事

发布： 2025-12-03 14:16:39

原创

632人浏览过

SOCI是一个C++数据库访问库，提供类型安全的SQL嵌入式操作，支持SQLite、MySQL等数据库；通过use和into实现C++变量与字段映射，结合session和rowset完成增删查改，可手动封装类实现伪ORM功能，并利用RAII事务管理确保操作原子性，适用于中小型项目的数据访问层构建。

c++如何实现一个简单的orm_c++对象关系映射框架soci的使用教程

在C++中实现一个轻量级的ORM（对象关系映射）通常不追求像Python或Java那样全自动的映射机制，而是借助第三方库来简化数据库操作。SOCI 是一个流行的 C++ ORM 库，它提供了简洁的接口，将 SQL 查询与 C++ 类型安全地结合，支持多种数据库后端（如 SQLite、MySQL、PostgreSQL 等）。

什么是 SOCI

SOCI 是一个用于 C++ 的数据库访问库，它不是传统意义上的“全自动 ORM”，而更像是一种类型安全的 SQL 嵌入式访问方式。你可以用接近原生 SQL 的语法操作数据库，同时自动完成 C++ 变量与数据库字段之间的映射。

环境准备与安装 SOCI

使用 SOCI 前需要安装其核心库和对应的数据库后端驱动。以 Ubuntu + SQLite 为例：

安装依赖：sudo apt-get install libsqlite3-dev libsoci-core-dev libsoci-sqlite3-dev
编译时链接库：-lsoci_core -lsoci_sqlite3

如果你使用的是 MySQL 或 PostgreSQL，还需安装对应驱动包，如 libsoci-mysql-dev。

立即学习“C++免费学习笔记（深入）”；

基本使用示例：连接数据库并执行查询

下面是一个使用 SOCI 连接 SQLite 并进行简单增删查改的例子。

Codeium

一个免费的AI代码自动完成和搜索工具

228

查看详情

#include <iostream>
#include <soci/soci.h>
#include <soci/sqlite3/soci-sqlite3.h>

using namespace soci;

int main() {
    try {
        // 建立数据库会话
        session sql(sqlite3, "test.db");

        // 创建表
        sql << "CREATE TABLE IF NOT EXISTS users ("
                "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                "name TEXT, "
                "age INTEGER)";

        // 插入数据
        std::string name = "Alice";
        int age = 25;
        sql << "INSERT INTO users(name, age) VALUES(:name, :age)",
             use(name), use(age);

        // 查询数据
        std::string query_name;
        int query_age;
        rowset<row> rs = (sql.prepare 
            << "SELECT name, age FROM users WHERE age > :min_age",
            use(20));

        for (auto const& row : rs) {
            query_name = row.get<std::string>(0);
            query_age = row.get<int>(1);
            std::cout << "Name: " << query_name 
                      << ", Age: " << query_age << std::endl;
        }

    } catch (const std::exception& e) {
        std::cerr << "Error: " << e.what() << std::endl;
    }

    return 0;
}

登录后复制

说明：

session 是数据库连接的核心对象。
use(var) 表示将 C++ 变量绑定为 SQL 参数。
rowset 用于遍历查询结果集，支持按索引或列名获取字段。

实现简单的对象映射（伪 ORM）

虽然 SOCI 不直接支持类到表的自动映射，但可以手动封装一个简单的映射逻辑。

struct User {
    int id;
    std::string name;
    int age;

    // 映射到数据库插入
    void save(session& sql) {
        if (id == 0) {
            sql << "INSERT INTO users(name, age) VALUES(:name, :age)",
                 use(name), use(age);
            sql << "SELECT last_insert_rowid()", into(id);
        } else {
            sql << "UPDATE users SET name=:name, age=:age WHERE id=:id",
                 use(name), use(age), use(id);
        }
    }

    static std::vector<User> find_by_age(session& sql, int min_age) {
        std::vector<User> result;
        rowset<row> rs = (sql.prepare 
            << "SELECT id, name, age FROM users WHERE age >= :age",
            use(min_age));

        for (auto const& r : rs) {
            User u;
            u.id = r.get<int>(0);
            u.name = r.get<std::string>(1);
            u.age = r.get<int>(2);
            result.push_back(u);
        }
        return result;
    }
};

登录后复制

这样就实现了最基本的“对象持久化”功能，接近 ORM 的使用体验。

事务处理

SOCI 支持 RAII 风格的事务管理：

try {
    transaction tr(sql);
    sql << "DELETE FROM users WHERE age < 18";
    // 如果没有调用 tr.commit()，析构时自动回滚
    tr.commit();
} catch (...) {
    // 自动回滚
}

登录后复制