QtMybatis：简化 Qt 数据库开发与 UI 组件实战

《告别手写 SQL：QtMybatis 让 Qt 数据库开发像 Mybatis 一样简单》

一、Qt 数据库开发的痛点

Qt 自带的 QSqlQuery/QSqlDatabase 虽能实现数据库操作，但在实际开发中存在诸多痛点：

• 手写 SQL 繁琐且易出错，字段名拼写、参数绑定稍不注意就会引发 bug；

• SQL 与业务代码耦合严重，修改表结构需逐行修改 SQL 语句，维护成本高；

• 缺乏统一的实体映射机制，查询结果需手动封装为业务对象，重复代码多；

• 分页、条件查询等通用操作需重复造轮子，效率低下。

而 Java 生态的 Mybatis 凭借「ORM 映射」「动态 SQL」「简化 CRUD」等特性，大幅降低了数据库开发成本。QtMybatis 正是借鉴 Mybatis 设计思想，为 Qt 开发者打造的轻量级数据库框架，让 Qt 数据库开发告别手写 SQL，回归业务逻辑本身。

二、QtMybatis 核心特性：像 Mybatis 一样开发

QtMybatis 基于 Qt 元对象系统和宏注解实现，核心解决「SQL 与业务解耦」「实体自动映射」「通用 CRUD」三大问题，核心特性包括：

1. 实体注解驱动：通过注解定义实体与数据库表的映射关系，无需手动维护字段映射；

2. BaseMapper 通用 CRUD：内置增删改查、批量操作、分页查询，零 SQL 实现基础数据库操作；

3. QueryWrapper 条件构造：通过链式调用构建复杂查询条件，替代手写动态 SQL；

4. Session 统一会话：封装数据库连接、SQL 执行、结果映射，简化操作流程。

三、快速上手：零 SQL 实现用户表 CRUD

步骤1：定义实体类（注解映射表与字段）

// Models.h
#include "QtMybatisMacros.h"
class User {
  QMP_ENTITY(User)          // 声明为Mybatis实体
  QMP_TABLE("t_user")       // 绑定数据库表名

public:
  QMP_ID(int, id, column = "user_id", idType = "AUTO") // 主键映射（自增）
  QMP_FIELD(QString, username, column = "user_name")   // 普通字段映射
  QMP_FIELD(int, age)                                  // 字段名与列名一致可省略column
  QMP_FIELD(bool, deleted, logicDelete = true)         // 逻辑删除字段
};
Q_DECLARE_METATYPE(User) // 注册元类型

步骤2：初始化数据库配置

// main.cpp
#include "QtMybatisDbManager.h"
#include "QtMybatisSession.h"

// 初始化SQLite数据库配置
QtMybatis::DbConfig config;
config.driver = "QSQLITE";
config.databaseName = "test.db";
QtMybatis::DbManager::instance().init(config);

// 创建会话（自动管理数据库连接）
QtMybatis::Session session("default");

步骤3：BaseMapper 实现零 SQL CRUD

#include "QtMybatisMapper.h"

// 1. 新增用户
QtMybatis::BaseMapper<User> userMapper(session);
User user;
user.username = "QtMybatis测试";
user.age = 25;
userMapper.insert(user); // 自动生成INSERT SQL，无需手写
qDebug() << "新增用户ID：" << user.id; // 自动回填自增ID

// 2. 更新用户
user.age = 26;
userMapper.updateById(user); // 自动生成UPDATE SQL

// 3. 条件查询
QtMybatis::QueryWrapper<User> query;
query.ge(&User::age, 25)    // 年龄>=25
      .like(&User::username, "测试") // 用户名包含"测试"
      .orderBy(&User::age, false);  // 按年龄降序
auto users = userMapper.selectList(query).data; // 自动映射为User列表

// 4. 分页查询
auto pageResult = userMapper.selectPage(query, {1, 10}).data; // 第1页，每页10条
qDebug() << "总条数：" << pageResult.total << "本页数据：" << pageResult.records.size();

四、QtMybatis 对比原生 Qt 开发的优势

五、总结

QtMybatis 无需依赖额外库（仅依赖 Qt 核心模块），以「注解 + 通用 Mapper」的方式，将 Mybatis 的便捷性带入 Qt 开发。无论是简单的 CRUD，还是复杂的条件查询、分页操作，都能大幅减少手写 SQL 的工作量，让开发者聚焦业务逻辑，而非数据库操作细节。

项目地址：qtmybatisplus