使用C++的ORM框架QxORM

2022-06-26 12:01:13

QxORM中,我們用的最多的無非是這兩點

官方表述是這樣的:

  永續性: 支援最常見的資料庫,如 SQLite、MySQL、PostgreSQL、Oracle、MS SQL Server、MongoDB(具有 1-1、1-n、n-1 和 n-n 關係);
  序列化: JSON、二進位制和 XML 格式;

簡潔一點就是:

  連線存取各類主流資料庫

  能夠將資料匯入匯出

下面我們進入主題:

  第一步:建立物件模型。相對於常規的結構體,只是多了一些宏定義與宣告。

  標頭檔案:QxModels.h

#include "precompiled.h"

/***************************************************************
* @projectName  pluqt
* @brief        自定義ORM模型
* @author       lzw
* @date         2022-01-04
***************************************************************/
struct User
{
    long id;
    QString name;
    int age;
    QString hobbies;
};

QX_REGISTER_HPP_QX_DLL1(User, qx::trait::no_base_class_defined, 1)

  原始檔:QxModels.cpp

#include "precompiled.h"
#include "qxmodels.h"
#include <QxOrm_Impl.h>

QX_REGISTER_CPP_QX_DLL1(User)

namespace qx
{
    template <> void register_class(QxClass<User> & t)
    {
        // 設定表名
        t.setName("User");
        // 註冊 User::id <=> 資料庫中的主鍵
        t.id(&User::id, "id");
        // 註冊 User::name 屬性,使用的 key 是 name,version 是 1。
        t.data(&User::name, "name", 1);
        // 註冊 User::age 屬性,使用的 key 是 age。
        t.data(&User::age, "age");
        // 註冊 User::hobbies 屬性,使用的 key 是 hobbies。
        t.data(&User::hobbies, "hobbies");
    }
}

  第二步:連線資料庫。

    QString in_db = QCoreApplication::applicationDirPath();
    in_db.append("/database/plulocal.db");

    QFile::remove(in_db);

    qx::QxSqlDatabase::getSingleton()->setDriverName("QSQLITE");
    qx::QxSqlDatabase::getSingleton()->setDatabaseName(in_db);
    qx::QxSqlDatabase::getSingleton()->setHostName("localhost");
    qx::QxSqlDatabase::getSingleton()->setUserName("root");
    qx::QxSqlDatabase::getSingleton()->setPassword("");
    qx::QxSqlDatabase::getSingleton()->setSqlPlaceHolderStyle(qx::QxSqlDatabase::ph_style_2_point_name);
    qx::QxSqlDatabase::getSingleton()->setTraceSqlQuery(true);
    qx::QxSqlDatabase::getSingleton()->setTraceSqlRecord(false);

  第三步:使用ORM。建表,新增,簡單查詢,複雜查詢等等

    // 建表
    QSqlError daoError1 = qx::dao::create_table<User>();

    // 產生100條模擬資料
    for(int in_idx=0; in_idx<100; ++in_idx)
    {
        auto in_user = new User();
        in_user->name = "lzw"+QString::number(in_idx);
        in_user->age = 20+in_idx;
        in_user->hobbies = "play";

        auto daoError1 = qx::dao::insert(in_user);
    }

    // 查詢單條記錄
    User in_pointUser; in_pointUser.id = 3;
    qDebug()<<in_pointUser.name;
    QSqlError daoError11 = qx::dao::fetch_by_id(in_pointUser);
    qDebug()<<in_pointUser.name;

    // 查詢一定年齡段的集合記錄
    //typedef std::shared_ptr<User> UserPtr;
    //typedef qx::QxCollection<long, UserPtr> UserList;
    UserList in_userList;
    qx_query in_query("select * from user where age>=20 and age<=25");
    daoError11 = qx::dao::execute_query(in_query, in_userList);
    qAssert(! daoError11.isValid()); qAssert(in_userList.count() > 0);
    qx::dump(in_userList);

有圖有真相。執行前:

 

 

  執行後:(並不需要寫一條sql語句,當然也支援寫原生sql語句)

 

 補充:序列化的兩個函數

    // 匯出binary流
    qx::serialization::qt::to_file(in_pointUser, "user.txt");
    // 匯出json文字
    qx::serialization::json::to_file(in_userList, "list_of_user.json");

 

  一氣呵成,大功告成。各位很簡單吧