ORM++终极指南：快速掌握现代C++ ORM框架

1. ORM++核心概念

ORM++是基于现代C++17/20特性的轻量级对象关系映射框架，核心优势：

• 零开销抽象：通过编译期元编程实现运行时零额外开销
• 类型安全：强类型映射避免SQL注入风险
• 跨数据库：统一接口支持SQLite/MySQL/PostgreSQL

关键组件：

// 模型定义示例
struct User {
    int id;        // 主键自动检测
    std::string name;
    double balance;
    ORMPP_TABLE(User, "users") // 表名映射
};

2. 快速配置

环境搭建

# CMake配置
find_package(ormpp REQUIRED)
target_link_libraries(your_target PRIVATE ormpp::ormpp)

数据库连接

// 创建连接池
auto pool = ormpp::connection_pool::create(
    "dbname=test user=postgres password=123", // DSN
    10                                        // 连接数
);

// 获取连接
auto conn = pool->get();

3. CRUD操作

创建数据

User user{0, "Alice", 100.0}; // ID自增设为0
conn.insert(user);            // 自动生成SQL: INSERT INTO users...

查询操作

// 条件查询
auto users = conn.query<User>(
    "where balance > $1",    // 参数化查询
    50.0                     // 条件值
);

// 范围查询
auto res = conn.query_range<User>(
    "order by id desc",      // SQL片段
    0, 10                    // LIMIT 10 OFFSET 0
);

更新与删除

// 更新
user.balance += 50;
conn.update(user);           // 自动检测变更字段

// 删除
conn.delete_records<User>(
    "where id = $1", 
    user.id
);

4. 高级特性

事务管理

conn.execute("begin");       // 显式事务
try {
    conn.update(user1);
    conn.update(user2);
    conn.execute("commit");
} catch (...) {
    conn.execute("rollback");
}

类型转换扩展

// 自定义类型映射
namespace ormpp {
template<>
struct type_to_string<MyCustomType> {
    static const char* value() { return "TEXT"; }
};
}

5. 性能优化技巧

1. 批量操作：

   std::vector<User> users;
   conn.insert(users);  // 自动生成批量INSERT
   

2. 连接池配置：

   pool->set_max_idle(30s);  // 空闲超时
   pool->set_validate(true); // 连接健康检查
   

3. 预处理语句：

   auto stmt = conn.prepare<User>(
       "where name like $1"
   );
   auto res = stmt.execute("%Smith%");
   

6. 实战示例：银行转账

bool transfer_funds(int from, int to, double amount) {
    auto conn = pool->get();
    conn.execute("begin");

    try {
        // 查询账户
        auto user1 = conn.query_by_key<User>(from);
        auto user2 = conn.query_by_key<User>(to);

        // 更新余额
        user1.balance -= amount;
        user2.balance += amount;
        
        conn.update(user1);
        conn.update(user2);
        
        conn.execute("commit");
        return true;
    } catch (const std::exception& e) {
        conn.execute("rollback");
        return false;
    }
}

启用SQL日志：

ormpp::set_logger([](const std::string& sql) {
    std::cout << "[SQL] " << sql << "\n";
});

最佳实践：结合编译时反射库实现自动模型注册，减少样板代码。建议使用CMake集成vcpkg或conan管理依赖，确保编译器开启C++17支持（/std:c++17或-std=c++17）