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 的一些常用方法，概述成表格形式：

方法	描述
`setQuery(const QString &query, const QSqlDatabase &db = QSqlDatabase())`	設置要執行的 SQL 查詢和數據庫連接。查詢執行後，結果將被提供給模型。
`clear()`	清除模型中的數據。
`lastError() const`	返回最後一次執行的查詢的錯誤。
`record() const`	返回包含查詢結果字段信息的 `QSqlRecord` 對象。
`data(const QModelIndex &item, int role = Qt::DisplayRole) const`	返回與給定索引處的項相關聯的數據，用於提供給視圖請求的數據。
`rowCount(const QModelIndex &parent = QModelIndex()) const`	返回模型中的行數。
`columnCount(const QModelIndex &parent = QModelIndex()) const`	返回模型中的列數。

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

QItemSelectionModel

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

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

方法	描述
`QItemSelectionModel(QAbstractItemModel *model)`	構造函數，創建一個選擇模型並關聯指定的數據模型。
`setModel(QAbstractItemModel *model)`	設置關聯的數據模型。
`model() const`	返回與此選擇模型相關聯的數據模型。
`currentIndex() const`	返回當前焦點的項的索引。
`selectedIndexes() const`	返回當前選擇的項的索引列表。
`clear()`	清除模型中的所有選擇項。
`select(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)`	根據給定的 `QModelIndex` 對象和選擇標誌執行選擇操作。
`select(const QItemSelection &selection, QItemSelectionModel::SelectionFlags command)`	根據給定的 `QItemSelection` 對象和選擇標誌執行選擇操作。
`reset()`	重置選擇模型，清除所有選擇和當前索引。
`setCurrentIndex(const QModelIndex &index, QItemSelectionModel::SelectionFlags command)`	設置當前焦點項。
`currentIndexChanged(const QModelIndex &current, const QModelIndex &previous)`	當前焦點項變化時發出的信號。
`selectionChanged(const QItemSelection &selected, const QItemSelection &deselected)`	選擇發生變化時發出的信號。

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

QDataWidgetMapper

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

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

方法	描述
`QDataWidgetMapper(QObject *parent = nullptr)`	構造函數，創建一個數據映射器對象。
`setModel(QAbstractItemModel *model)`	設置映射的數據模型。
`model() const`	返回與此數據映射器相關聯的數據模型。
`addMapping(QWidget *widget, int section)`	將指定的小部件和數據模型的字段進行映射。
`removeMapping(QWidget *widget)`	移除與指定小部件的映射關係。
`mappedWidgetAt(int section) const`	返回與數據模型的指定字段映射的小部件。
`mappedSection(QWidget *widget) const`	返回與指定小部件映射的數據模型字段的索引。
`setCurrentIndex(int index)`	將映射的數據移動到指定的索引。
`currentIndex() const`	返回當前映射的數據的索引。
`toFirst(), toLast(), toNext(), toPrevious()`	分別將映射的數據移動到第一行、最後一行、下一行、上一行。
`submit()`	將界面上的更改提交到模型。
`revert()`	撤銷所有未提交的更改。
`setSubmitPolicy(QDataWidgetMapper::SubmitPolicy policy)`	設置更改提交策略。
`submitPolicy() const`	返回當前的更改提交策略。
`addMapping(QWidget *widget, int section, const QByteArray &propertyName)`	將小部件和數據模型字段以及小部件屬性進行映射。
`toFirst(), toLast(), toNext(), toPrevious()`	分別將映射的數據移動到第一行、最後一行、下一行、上一行。

這些方法使得在 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編輯框均會實現聯動效果，如下圖所示；

C++ Qt開發：數據庫與TableView多組件聯動

1.1 初始化組件

1.2 綁定事件

C++ Qt開發：QProcess進程管理模塊

C++ Qt開發：QUdpSocket實現組播通信

C++ Qt開發：QUdpSocket網絡通信組件

C++ Qt開發：QTcpSocket網絡通信組件

C++ Qt開發：QNetworkAccessManager網絡接口組件

https://yachay.unat.edu.pe/blog/index.php?comment_area=format_blog&comment_component=blog&comment_co

linux以太網驅動總結