C/C++?Qt數(shù)據(jù)庫與SqlTableModel組件應用教程

更新時間：2021年12月09日 14:08:24 作者：Lyshark

SqlTableModel?組件可以將數(shù)據(jù)庫中的特定字段動態(tài)顯示在TableView表格組件中,這篇文章將主要介紹SqlTableModel組件一些常用的操作，需要的朋友可以參考一下

SqlTableModel 組件可以將數(shù)據(jù)庫中的特定字段動態(tài)顯示在TableView表格組件中，通常設置QSqlTableModel類的變量作為數(shù)據(jù)模型后就可以顯示數(shù)據(jù)表內容，界面組件中則通過QDataWidgetMapper類實例設置為與某個數(shù)據(jù)庫字段相關聯(lián)，則可以實現(xiàn)自動顯示字段的內容，不僅是顯示，其還支持動態(tài)增刪改查等各種復雜操作，期間不需要使用任何SQL語句。

首先繪制好UI界面,本次案例界面稍顯復雜，左側是一個TableView組件，其他地方均為LineEdit組件與Button組件。

先來生成數(shù)據(jù)庫表記錄，此處我們只需要增加一個Student學生表，并插入兩條測試數(shù)據(jù)即可，運行以下代碼完成數(shù)據(jù)創(chuàng)建。

#include <iostream>
#include <QSqlDatabase>
#include <QSqlError>
#include <QSqlQuery>
#include <QSqlRecord>
#include <QtSql>
#include <QDataWidgetMapper>

QSqlDatabase DB;                     // 數(shù)據(jù)庫連接
void MainWindow::InitSQL()
{
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("./lyshark.db");
     if (!db.open())
     {
            return;
     }

    // 執(zhí)行SQL創(chuàng)建表
    // https://Www.cnbloGs.com/lyshark
    db.exec("DROP TABLE Student");
    db.exec("CREATE TABLE Student ("
                    "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                    "name VARCHAR(40) NOT NULL, "
                    "sex VARCHAR(40) NOT NULL, "
                    "age INTEGER NOT NULL,"
                    "mobile VARCHAR(40) NOT NULL,"
                    "city VARCHAR(40) NOT NULL)"
         );

    // 逐條插入數(shù)據(jù)
    db.exec("INSERT INTO Student(name,sex,age,mobile,city) ""VALUES ('lyshark.cnblogs.com','m','25','1234567890','beijing')");
    db.exec("INSERT INTO Student(name,sex,age,mobile,city) ""VALUES ('www.lyshark.com','x','22','4567890987','shanghai')");

    db.commit();
    db.close();
}

數(shù)據(jù)庫創(chuàng)建后表內記錄如下:

程序運行后我們將在MainWindow::MainWindow(QWidget *parent)構造函數(shù)內完成數(shù)據(jù)庫表記錄與TableView組件字段的對應關系綁定，將數(shù)據(jù)庫綁定到QDataWidgetMapper對象上，綁定代碼如下。

MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    // 打開數(shù)據(jù)庫
    DB=QSqlDatabase::addDatabase("QSQLITE"); // 添加 SQL LITE數(shù)據(jù)庫驅動
    DB.setDatabaseName("./lyshark.db");     // 設置數(shù)據(jù)庫名稱
    if (!DB.open())
    {
        return;
    }

    // 打開數(shù)據(jù)表
    tabModel=new QSqlTableModel(this,DB);                             // 數(shù)據(jù)表
    tabModel->setTable("Student");                                    // 設置數(shù)據(jù)表
    tabModel->setEditStrategy(QSqlTableModel::OnManualSubmit);        // 數(shù)據(jù)保存方式，OnManualSubmit , OnRowChange
    tabModel->setSort(tabModel->fieldIndex("id"),Qt::AscendingOrder); // 排序
    if (!(tabModel->select()))                                        // 查詢數(shù)據(jù)
    {
       return;
    }

    // 設置字段名稱
    tabModel->setHeaderData(tabModel->fieldIndex("id"),Qt::Horizontal,"Uid");
    tabModel->setHeaderData(tabModel->fieldIndex("name"),Qt::Horizontal,"Uname");
    tabModel->setHeaderData(tabModel->fieldIndex("sex"),Qt::Horizontal,"Usex");
    tabModel->setHeaderData(tabModel->fieldIndex("age"),Qt::Horizontal,"Uage");
    tabModel->setHeaderData(tabModel->fieldIndex("mobile"),Qt::Horizontal,"Umobile");
    tabModel->setHeaderData(tabModel->fieldIndex("city"),Qt::Horizontal,"Ucity");

    theSelection=new QItemSelectionModel(tabModel);                       // 關聯(lián)選擇模型
    ui->tableView->setModel(tabModel);                                    // 設置數(shù)據(jù)模型
    ui->tableView->setSelectionModel(theSelection);                       // 設置選擇模型
    ui->tableView->setSelectionBehavior(QAbstractItemView::SelectRows);   // 行選擇模式

    // 添加數(shù)據(jù)映射,將選中字段映射到指定編輯框中
    // https://www.cnblogs.com/lysharK
    dataMapper= new QDataWidgetMapper();
    dataMapper->setModel(tabModel);
    dataMapper->setSubmitPolicy(QDataWidgetMapper::AutoSubmit);

    dataMapper->addMapping(ui->lineEdit_name,tabModel->fieldIndex("name"));          // 設置映射字段
    dataMapper->addMapping(ui->lineEdit_mobile,tabModel->fieldIndex("mobile"));      // 第二個映射字段
    dataMapper->toFirst();                                                           // 默認選中首條映射記錄

    // 綁定信號,當鼠標選擇時,在底部編輯框中輸出
    connect(theSelection,SIGNAL(currentRowChanged(QModelIndex,QModelIndex)),this,SLOT(on_currentRowChanged(QModelIndex,QModelIndex)));
    getFieldNames();
}

MainWindow::~MainWindow()
{
    delete ui;
}

綁定成功后運行程序即可看到如下效果,數(shù)據(jù)庫中的記錄被映射到了組件內.

當用戶點擊TableView組件內的某一行記錄時，則觸發(fā)MainWindow::on_currentRowChanged函數(shù)。

執(zhí)行獲取name/mobile字段,并放入映射數(shù)據(jù)集中的 lineEdit編輯框中

void MainWindow::on_currentRowChanged(const QModelIndex &current, const QModelIndex &previous)
{
    Q_UNUSED(previous);

    dataMapper->setCurrentIndex(current.row());      // 更細數(shù)據(jù)映射的行號
    int curRecNo=current.row();                      // 獲取行號
    QSqlRecord  curRec=tabModel->record(curRecNo);   // 獲取當前記錄

    QString uname = curRec.value("name").toString();     // 取出數(shù)據(jù)
    QString mobile = curRec.value("mobile").toString();

    ui->lineEdit_name->setText(uname);                   // 設置到編輯框
    ui->lineEdit_mobile->setText(mobile);
}

運行效果如下:

增加插入與刪除記錄實現(xiàn)方法都是調用TabModel提供的默認函數(shù)，通過獲取當前選中行號，并對該行號執(zhí)行增刪改查方法即可。

// 新增一條記錄
// https://www.cnblogS.com/lyshark
void MainWindow::on_pushButton_add_clicked()
{
    tabModel->insertRow(tabModel->rowCount(),QModelIndex());                 // 在末尾添加一個記錄
    QModelIndex curIndex=tabModel->index(tabModel->rowCount()-1,1);          // 創(chuàng)建最后一行的ModelIndex
    theSelection->clearSelection();                                          // 清空選擇項
    theSelection->setCurrentIndex(curIndex,QItemSelectionModel::Select);     // 設置剛插入的行為當前選擇行

    int currow=curIndex.row();                                              // 獲得當前行
    tabModel->setData(tabModel->index(currow,0),1000+tabModel->rowCount()); // 自動生成編號
    tabModel->setData(tabModel->index(currow,2),"M");                       // 默認為男
    tabModel->setData(tabModel->index(currow,3),"0");                       // 默認年齡0
}

// 插入一條記錄
void MainWindow::on_pushButton_insert_clicked()
{
    QModelIndex curIndex=ui->tableView->currentIndex();
    int currow=curIndex.row();                                              // 獲得當前行

    tabModel->insertRow(curIndex.row(),QModelIndex());
    tabModel->setData(tabModel->index(currow,0),1000+tabModel->rowCount()); // 自動生成編號

    theSelection->clearSelection();                                         // 清除已有選擇
    theSelection->setCurrentIndex(curIndex,QItemSelectionModel::Select);
}

// 刪除一條記錄
void MainWindow::on_pushButton_delete_clicked()
{
    QModelIndex curIndex=theSelection->currentIndex();  // 獲取當前選擇單元格的模型索引
    tabModel->removeRow(curIndex.row());                // 刪除最后一行
}

// 保存修改數(shù)據(jù)
void MainWindow::on_pushButton_save_clicked()
{
    bool res=tabModel->submitAll();
    if (!res)
    {
        std::cout << "save as ok" << std::endl;
    }
}

// 恢復原始狀態(tài)
void MainWindow::on_pushButton_reset_clicked()
{
    tabModel->revertAll();
}

增刪改查實現(xiàn)如下:

針對與排序與過濾的實現(xiàn)方式如下，同樣是調用了標準函數(shù)。

// 以Combox中的字段對目標 升序排列
void MainWindow::on_pushButton_ascending_clicked()
{
    tabModel->setSort(ui->comboBox->currentIndex(),Qt::AscendingOrder);
    tabModel->select();
}

// 以Combox中的字段對目標 降序排列
// https://www.Cnblogs.com/LyShark
void MainWindow::on_pushButton_descending_clicked()
{
    tabModel->setSort(ui->comboBox->currentIndex(),Qt::DescendingOrder);
    tabModel->select();
}

// 過濾出所有男記錄
void MainWindow::on_pushButton_filter_man_clicked()
{
    tabModel->setFilter(" sex = 'M' ");
}
// 恢復默認過濾器
void MainWindow::on_pushButton_default_clicked()
{
    tabModel->setFilter("");
}

過濾效果如下所示:

批量修改某個字段，其實現(xiàn)原理是首先通過i<tabModel->rowCount()獲取記錄總行數(shù)，然后通過aRec.setValue設置指定字段數(shù)值，并最終tabModel->submitAll()提交到表格中。

void MainWindow::on_pushButton_clicked()
{
    if (tabModel->rowCount()==0)
        return;

    for (int i=0;i<tabModel->rowCount();i++)
    {
        QSqlRecord aRec=tabModel->record(i);            // 獲取當前記錄
        aRec.setValue("age",ui->lineEdit->text());      // 設置數(shù)據(jù)
        tabModel->setRecord(i,aRec);
    }
    tabModel->submitAll();                              // 提交修改
}

循環(huán)修改實現(xiàn)效果如下:

上方代碼中，如果需要修改或增加特定行或記錄我們只需要點擊相應的按鈕，并在選中行直接編輯即可實現(xiàn)向數(shù)據(jù)庫中插入數(shù)據(jù)，而有時我們不希望通過在原表上操作，而是通過新建窗體并在窗體中完成增刪改，此時就需要使用Dialog窗體并配合原生SQL語句來實現(xiàn)對記錄的操作了。

以增加為例，主窗體中直接彈出增加選項卡，并填寫相關參數(shù)，直接提交即可。

// https://www.cnblogs.com/LyShark
void MainWindow::on_pushButton_insert_clicked()
{
    QSqlQuery query;
    query.exec("select * from Student where id =-1");    // 查詢字段信息,是否存在
    QSqlRecord curRec=query.record();                    // 獲取當前記錄,實際為空記錄
    curRec.setValue("id",qryModel->rowCount()+1001);

    WindowPtr->setWindowFlags(flags | Qt::MSWindowsFixedSizeDialogHint); // 設置對話框固定大小
    WindowPtr->setInsertRecord(curRec);                                  // 插入記錄
    int ret=WindowPtr->exec();                                           // 以模態(tài)方式顯示對話框
    if (ret==QDialog::Accepted)                                          // OK鍵被按下
    {
        query.prepare("INSERT INTO Student(id,name,sex,age,mobile,city)"
                      " VALUES(:Id, :Name, :Sex, :Age, :Mobile, :City)");

        query.bindValue(":Id",recData.value("id"));
        query.bindValue(":Name",recData.value("name"));
        query.bindValue(":Sex",recData.value("sex"));
        query.bindValue(":Age",recData.value("age"));
        query.bindValue(":Mobile",recData.value("mobile"));
        query.bindValue(":City",recData.value("city"));

        if (query.exec())
        {
            QString sqlStr=qryModel->query().executedQuery(); // 執(zhí)行過的SELECT語句
            qryModel->setQuery(sqlStr);                       // 重新查詢數(shù)據(jù)
        }
    }
    delete WindowPtr;
}

Dialog增加效果如下: