0

0

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

裘德小鎮的故事

裘德小鎮的故事

发布时间:2025-12-03 14:16:39

|

700人浏览过

|

来源于php中文网

原创

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 并进行简单增删查改的例子。

九歌
九歌

九歌--人工智能诗歌写作系统

下载
#include 
#include 
#include 

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 rs = (sql.prepare 
            << "SELECT name, age FROM users WHERE age > :min_age",
            use(20));

        for (auto const& row : rs) {
            query_name = row.get(0);
            query_age = row.get(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 find_by_age(session& sql, int min_age) {
        std::vector result;
        rowset 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(0);
            u.name = r.get(1);
            u.age = r.get(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 (...) {
    // 自动回滚
}

注意事项与建议

  • SOCI 不是全自动 ORM,不要期望像 Hibernate 那样通过注解映射类到表。
  • 推荐配合 SQLite 使用快速原型开发;生产环境注意连接池和异常处理。
  • 字段类型映射需确保兼容,例如 SQLite 中 INTEGER 对应 int,TEXT 对应 string。
  • 调试时可启用日志输出查看实际执行的 SQL。

基本上就这些。SOCI 提供了足够简洁又不失灵活的方式让 C++ 操作数据库变得直观安全,适合中小型项目构建自己的数据访问层。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

758

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

639

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

761

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1265

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

548

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

579

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

708

2023.08.11

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

43

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
MySQL 教程
MySQL 教程

共48课时 | 1.8万人学习

MySQL 初学入门(mosh老师)
MySQL 初学入门(mosh老师)

共3课时 | 0.3万人学习

简单聊聊mysql8与网络通信
简单聊聊mysql8与网络通信

共1课时 | 797人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号