使用C++的ORM框架QxORM

李濤賢賢發表於2022-06-26
C++ORM框架

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語句）

 

 補充：序列化的兩個函式

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

 

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

 

相關文章