C++ Qt開發：資料庫與TableView多組件聯動

Qt 是一個跨平臺C++圖形界面開發庫，利用Qt可以快速開發跨平臺窗體應用程式，在Qt中我們可以通過拖拽的方式將不同組件放到指定的位置，實現圖形化開發極大的方便了開發效率，本章將重點介紹TableView組件與資料庫聯動的常用方法及靈活運用。

在Qt中，通常我們不會在TableView等組件中保存數據，一般會將這些數據存儲至資料庫或者是文件中保存，當使用時則動態的在資料庫中調出來，以下案例將實現，當用戶點擊並選中TableView組件內的某一行時，我們通過該行中的name欄位查詢，並將查詢結果關聯到ListView組件內，同時將TableView中選中行的欄位分別顯示在窗體底部的LineEdit編輯框內。

要實現聯動涉及幾個主要步驟：建立資料庫連接、創建模型、設置TableView、捕捉TableView的選中信號、查詢並關聯數據、更新LineEdit和ListView，首先我們在UI界面中繪製所需控制項，如下圖左側放一個TableView組件，右側是一個ListView組件，底部放三個LineEdit組件；

接著我們需要創建兩張數據表，其中Student表主要用來存儲學生信息，而StudentAddressList用於存儲學生所管理的IP地址，我們將表中的name進行關聯，每個學生名下存儲有不同的地址；

創建兩個表結構總結起來代碼如下所示，通過分別調用多次db.exec()函數實現創建數據表，並通過QSqlQuery類實現批量插入數據集；

void InitMultipleSQL()
{
    // ----------------------------------------------
    // 初始化表結構
    // ----------------------------------------------
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("./database.db");
     if (!db.open())
     {
            std::cout << db.lastError().text().toStdString()<< std::endl;
            return;
     }

    // 執行SQL創建表
    db.exec("DROP TABLE Student");
    db.exec("CREATE TABLE Student ("
                    "id INTEGER PRIMARY KEY AUTOINCREMENT, "
                    "name VARCHAR(40) NOT NULL, "
                    "age INTEGER NOT NULL)"
         );

    // 批量創建數據
    QStringList name_list; name_list << "lyshark" << "admin" << "guest";
    QStringList age_list; age_list << "25" << "34" << "45";

    // 綁定並插入數據
    QSqlQuery query;
    query.prepare("INSERT INTO Student(name,age) ""VALUES (:name, :age)");

    if(name_list.size() == age_list.size())
    {
        for(int x=0;x< name_list.size();x++)
        {
            query.bindValue(":name",name_list[x]);
            query.bindValue(":age",age_list[x]);
            query.exec();
        }
    }

    // ----------------------------------------------
    // 創建第二張表
    // ----------------------------------------------
    // 與第一張表通過姓名關聯起來
    db.exec("DROP TABLE StudentAddressList");
    db.exec("CREATE TABLE StudentAddressList("
            "id INTEGER PRIMARY KEY AUTOINCREMENT, "
            "name VARCHAR(40) NOT NULL, "
            "address VARCHAR(128) NOT NULL"
            ")");

    // 插入數據
    db.exec("INSERT INTO StudentAddressList(name,address) VALUES ('lyshark','192.168.1.1')");
    db.exec("INSERT INTO StudentAddressList(name,address) VALUES ('lyshark','192.168.1.2')");
    db.exec("INSERT INTO StudentAddressList(name,address) VALUES ('lyshark','192.168.1.3')");
    db.exec("INSERT INTO StudentAddressList(name,address) VALUES ('admin','192.168.10.10')");
    db.exec("INSERT INTO StudentAddressList(name,address) VALUES ('admin','192.168.10.11')");
    db.exec("INSERT INTO StudentAddressList(name,address) VALUES ('guest','192.168.100.100')");
}

1.1 初始化組件

接著我們需要在構造函數MainWindow::MainWindow(QWidget *parent)內初始化``TableView表格，查詢Student表內記錄，將查詢到的指針綁定到theSelection模型上，綁定後再將綁定指針加入到dataMapper組件映射中，即可實現初始化，這裡有必要介紹一下QSqlQueryModel、QItemSelectionModel、QDataWidgetMapper`這三個模型類。

QSqlQueryModel

用於與資料庫交互的模型類之一，它繼承自 QAbstractTableModel。QSqlQueryModel 通過執行 SQL 查詢語句，將查詢結果作為表格數據提供給 Qt 的視圖組件，如 QTableView等。

以下是 QSqlQueryModel 的一些常用方法，概述成表格形式：

上述方法提供了一般性的查詢執行、錯誤處理、結果處理等功能，使得通過 QSqlQueryModel 能夠方便地將資料庫中的查詢結果集與 Qt 的視圖組件進行關聯。使用這些方法，你可以在應用中執行 SQL 查詢，並將結果顯示在相應的視圖組件中。

QItemSelectionModel

用於管理項選擇的模型類，它是 QAbstractItemModel 類的衍生類。QItemSelectionModel 用於追蹤一個或多個視圖中的選擇項，同時允許對這些選擇項進行查詢和修改。

以下是 QItemSelectionModel 的一些常用方法，概述成表格形式：

這些方法允許你在一個或多個視圖中管理選擇項，進行選擇的查詢、修改，以及處理選擇變化的信號。通過使用這些方法，你可以實現對模型中的項進行靈活的選擇操作，並及時響應選擇的變化。

QDataWidgetMapper

用於實現數據和小部件之間雙向映射的類，使得數據模型的變化能夠反映在界面上，同時用戶界面的修改也能夠同步到數據模型中。

以下是 QDataWidgetMapper 的一些主要方法，概述成表格形式：

這些方法使得在 Qt 應用程式中更容易實現數據模型和用戶界面的交互，通過將數據模型欄位映射到用戶界面的小部件上，實現了數據的顯示和編輯的同步。通過調用 setCurrentIndex、toNext、toPrevious 等方法，你可以在數據模型中移動，並自動更新映射的小部件上顯示的數據。最後，通過調用 submit 將界面上的更改提交到模型，而 revert 則撤銷未提交的更改。

初始化UI界面很容易實現，首席按初始化表結構，通過調用封裝好的InitMultipleSQL可以直接初始化並將數據保存至database.db文件中，在主程式中我們一次執行如下操作來實現數據的初始化與展現。

打開資料庫

使用 SQLite 資料庫，並嘗試打開名為 "database.db" 的資料庫文件。如果打開失敗，將輸出錯誤信息並返回。需要註意確保資料庫文件存在且可訪問。

QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
db.setDatabaseName("./database.db");
if (!db.open())
{
    std::cout << db.lastError().text().toStdString()<< std::endl;
    return;
}

查詢數據表中記錄

通過 QSqlQueryModel 查詢 Student 表中的所有記錄，並按 id 排序。如果查詢過程中出現錯誤，需要處理錯誤。

qryModel=new QSqlQueryModel(this);
qryModel->setQuery("SELECT * FROM Student ORDER BY id");

設置 TableView 表頭數據

設置查詢模型的表頭數據，分別為 "ID"、"Name"、"Age"。

qryModel->setHeaderData(0,Qt::Horizontal,"ID");
qryModel->setHeaderData(1,Qt::Horizontal,"Name");
qryModel->setHeaderData(2,Qt::Horizontal,"Age");

綁定數據到模型和 TableView

創建一個 QItemSelectionModel 對象 theSelection，並將其綁定到查詢模型 qryModel 上。然後將模型和選擇模型分別綁定到 ui->tableView 上，設置選擇行為為按行選擇。

theSelection=new QItemSelectionModel(qryModel);
ui->tableView->setModel(qryModel);
ui->tableView->setSelectionModel(theSelection);
ui->tableView->setSelectionBehavior(QAbstractItemView::SelectRows);

創建數據映射器 QDataWidgetMapper

創建 QDataWidgetMapper 對象 dataMapper，設置提交策略為自動提交。然後將映射器和模型綁定，並將三個文本框小部件與模型的相應欄位進行映射。最後，將映射器移動到第一行。

dataMapper= new QDataWidgetMapper();
dataMapper->setSubmitPolicy(QDataWidgetMapper::AutoSubmit);
dataMapper->setModel(qryModel);
dataMapper->addMapping(ui->lineEdit_id,0);
dataMapper->addMapping(ui->lineEdit_name,1);
dataMapper->addMapping(ui->lineEdit_age,2);
dataMapper->toFirst();

綁定信號

連接 theSelection 的 currentRowChanged 信號到槽函數 on_currentRowChanged。這樣，當用戶在表格中選擇不同行時，將觸發槽函數執行相應的操作。

connect(theSelection,SIGNAL(currentRowChanged(QModelIndex,QModelIndex)),
        this,SLOT(on_currentRowChanged(QModelIndex,QModelIndex)));

上述代碼實現了組件初始化，使用資料庫表格中的數據填充了一個 QTableView，並通過 QDataWidgetMapper 將選中行的數據映射到三個文本框中，同時通過信號槽機制實現了在底部編輯框中顯示當前選中行的功能。

1.2 綁定事件

接著我們需要綁定TableView表格的on_currentRowChanged()事件，當用戶點擊TableView表格中的某個屬性時則自動觸發該函數，在此函數內我們完成對其他組件的填充，如下是對綁定事件的具體分析。

如下這部分代碼使用了 Q_UNUSED 巨集，用於標記 previous 未使用，以避免編譯器產生未使用變數的警告。接著判斷 current 是否有效，如果無效則直接返回，避免出現錯誤。

Q_UNUSED(previous);
if (!current.isValid())
{
    return;
}

dataMapper->setCurrentModelIndex(current);

這段代碼判斷當前行是否為表格的第一行或最後一行，並輸出相應的信息。

// 獲取到記錄開頭結尾
bool first=(current.row()==0);                    // 是否首記錄
bool last=(current.row()==qryModel->rowCount()-1);// 是否尾記錄
std::cout << "IsFirst: " << first << "IsLast: " << last << std::endl;

獲取當前選擇行的 name 欄位的數據，並輸出到標準輸出流。

// 獲取name欄位數據
int curRecNo=theSelection->currentIndex().row();  // 獲取當前行號
QSqlRecord curRec=qryModel->record(curRecNo);     // 獲取當前記錄
QString uname = curRec.value("name").toString();
std::cout << "Student Name = " << uname.toStdString() << std::endl;

代碼查詢名為 StudentAddressList 的表中與當前用戶名匹配的所有數據，並將 address 欄位的數據提取出來存儲在 the_data 容器中。

// 查StudentAddressList表中所有數據
// 根據姓名過濾出該用戶的所有數據
QSqlQuery query;
query.prepare("select * from StudentAddressList where name = :x");
query.bindValue(":x",uname);
query.exec();

// 迴圈獲取該用戶的數據,並將address欄位提取出來放入QStringList容器
QSqlRecord rec = query.record();
QStringList the_data;

while(query.next())
{
    int index = rec.indexOf("address");
    QString data = query.value(index).toString();

    std::cout << "User Address = " << data.toStdString() << std::endl;
    the_data.append(data);
}

最後，將 the_data 中的數據關聯到 QListView 控制項上，並設置為不可編輯。這樣，用戶就可以在 QListView 中看到與當前表格行對應的地址信息。

// 關聯到ListView數據表中
QStringListModel *model;
model = new QStringListModel(the_data);
ui->listView->setModel(model);
ui->listView->setEditTriggers(QAbstractItemView::NoEditTriggers);

至此核心功能的實現就結束了，通過對信號的綁定，當讀者運行程式並選中TableView組件中的任意一行是，其右側ListView與底部的LineEdit編輯框均會實現聯動效果，如下圖所示；