源部落格位置：http://www.qter.org/portal.php?mod=view&aid=56

----------------------------------------------------------------------------------------------------------------------------------------------------------------------

導語

---

 

在上一篇的最後我們講到，Qt中使用了自己的機制來避免使用SQL語句，為開發者提供了更簡單的資料庫操作及資料顯示模型，分別是隻讀的QSqlQueryModel，操作單表的QSqlTableModel以及可以支援外來鍵的QSqlRelationalTableModel。這次我們先講解QSqlQueryModel。

 

環境：Windows 7 + Qt 5.8.0（包含QtCreator 4.2.1）

 

 

目錄

---

 

一、簡單的查詢操作

二、QSqlQueryModel常用操作

三、建立自定義QSqlQueryModel

 

正文

---

 

 

一、簡單的查詢操作

 

 

1.新建Qt Widgets應用，專案名稱為querymodel，基類為QMainWindow類名為MainWindow保持預設即可。

 

 

2.完成後開啟querymodel.pro，將第一行程式碼更改為：

 

QT       += coregui sql

 

       然後儲存該檔案。

 

 

3.往專案中新增新的C++標頭檔案，名稱為connection.h，完成後將其內容更改如下：

 

1. #ifndef CONNECTION_H
2. #define CONNECTION_H
3. #include <QSqlDatabase>
4. #include <QSqlQuery>
5. static bool createConnection()
6. {
7.     QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
8.     db.setDatabaseName("database.db");
9.     if(!db.open()) return false;
10.     QSqlQuery query;
11.     query.exec("create table student (id int primary key, namevchar)");
12.     query.exec("insert into student values (0,'yafei0')");
13.     query.exec("insert into student values (1,'yafei1')");
14.     query.exec("insert into student values (2,'yafei2')");
15.     return true;
16. }
17. #endif // CONNECTION_H

複製程式碼

       這裡使用了db.setDatabaseName("database.db")，我們沒有再使用以前的記憶體資料庫，而是使用了真實的檔案，這樣後面對資料庫進行的操作就能儲存下來了。

 

 

4.然後進入main.cpp檔案，更改如下：

 

1. #include "mainwindow.h"
2. #include <QApplication>
3. #include "connection.h"
4.  
5. int main(int argc, char *argv[])
6. {
7.     QApplication a(argc, argv);
8.  
9.     if(!createConnection())
10.            return 1;
11.  
12.     MainWindow w;
13.     w.show();
14.  
15.     return a.exec();
16. }

複製程式碼

 

5.下面進入設計模式，向介面上拖入一個Push Button按鈕，更改顯示文字為“查詢”，然後進入其單擊訊號槽，更改如下：

 

1. void MainWindow::on_pushButton_clicked()
2. {
3.     QSqlQueryModel *model = new QSqlQueryModel(this);
4.     model->setQuery("select * from student");
5.     model->setHeaderData(0, Qt::Horizontal, tr("id"));
6.     model->setHeaderData(1, Qt::Horizontal, tr("name"));
7.     QTableView *view = new QTableView;
8.     view->setModel(model);
9.     view->show();
10. }

複製程式碼

 

這裡新建了QSqlQueryModel類物件model，並用setQuery()函式執行了SQL語句“("select * fromstudent");”用來查詢整個student表的內容，可以看到，該類並沒有完全避免SQL語句。然後我們設定了表中欄位顯示時的名字。最後我們建立了一個檢視view，並將這個model模型關聯到檢視中，這樣資料庫中的資料就能在視窗上的表中顯示出來了。

 

6.在mainwindow.cpp中新增標頭檔案包含：

 

1. #include <QSqlQueryModel>
2. #include <QTableView>

複製程式碼

 

 

7.執行程式，按下查詢按鈕，效果如下圖所示。

 

 

8.我們檢視一下編譯生成的目錄，這裡面有生成的資料庫檔案（比如我這裡的路徑是：E:\app\src\build-querymodel-Desktop_Qt_5_8_0_MinGW_32bit-Debug），如下圖所示。

 

 

二、QSqlQueryModel常用操作

 

 

1.在查詢按鈕單擊訊號槽中繼續新增如下程式碼：

 

1. int column = model->columnCount(); //獲得列數
2. int row = model->rowCount();    // 獲得行數
3. QSqlRecord record = model->record(1); //獲得一條記錄
4. QModelIndex index = model->index(1, 1);   //獲得一條記錄的一個欄位的索引
5. qDebug() << "column num is:" << column << endl
6.          << "row num is:" << row << endl
7.          <<"the second record is:" << record << endl
8.         << "the data of index(1,1) is:"<< index.data();

複製程式碼

 

2.然後在mainwindow.cpp檔案中新增下面的標頭檔案包含：

 

1. #include <QSqlRecord>
2. #include <QModelIndex>
3. #include <QDebug>

複製程式碼

 

3.執行程式，點選查詢按鈕，輸出內容如下圖所示。

 

 

4.另外我們可以直接使用上一節講到的QSqlQuery來執行SQL語句，例如：

 

1. QSqlQuery query = model->query();
2. query.exec("select name fromstudent where id = 2 ");
3. query.next();
4. qDebug() << query.value(0).toString();

複製程式碼

 

5.我們將查詢按鈕單擊訊號的槽更改如下：

 

1. void MainWindow::on_pushButton_clicked()
2. {
3.     QSqlQueryModel *model = new QSqlQueryModel;
4.     model->setQuery("select * from student");
5.     model->setHeaderData(0, Qt::Horizontal, tr("id"));
6.     model->setHeaderData(1, Qt::Horizontal, tr("name"));
7.     QTableView *view = new QTableView;
8.     view->setModel(model);
9.     view->show();
10.    
11.     QSqlQuery query = model->query();
12.     query.exec("insertinto student values (10,'yafei10')");
13. }

複製程式碼

 

       這裡使用query向表中添加了一條記錄。

 

 

6.在mainwindow.cpp中新增標頭檔案

1. #include <QSqlQuery>

複製程式碼

 

然後執行程式，發現最後新增的記錄並沒有顯示出來，當關閉表格視窗，再次單擊查詢按鈕的時候才顯示出來。

 

 

7.為什麼會出現這樣的情況呢？那是因為前面我們執行了新增記錄的SQL語句，但是在新增記錄之前，查詢結果就已經顯示了，所以我們的更新沒能動態的顯示出來。為了能讓其動態地顯示我們的更新，可以將槽最後新增的程式碼更改如下：

 

1. QSqlQuery query = model->query();
2. query.exec("insert into student values (20,'yafei20')");
3. model->setQuery("select * from student"); //再次查詢整張表
4. view->show(); //再次進行顯示

複製程式碼

 

       這裡我們修改表以後，再次進行了查詢並顯示。大家可以執行程式，發現新的記錄可以直接顯示出來了。

 

 

三、建立自定義QSqlQueryModel

 

前面我們講到這個模型預設是隻讀的，所以在視窗上並不能對錶格中的內容進行修改。但是我們可以建立自己的模型，然後按照自己的意願來顯示資料和修改資料。要想使其可讀寫，需要自己的類繼承自QSqlQueryModel，並且重寫setData() 和 flags() 兩個函式。如果我們要改變資料的顯示，就要重寫data() 函式。

 

下面的例子中我們讓student表查詢結果的id欄位顯示紅色，name欄位可編輯。

 

1.向專案中新增新的C++類，類名為MySqlQueryModel，基類Base class保持Custom，然後在下面手動填寫QSqlQueryModel。

 

 

2.完成後開啟mysqlquerymodel.h檔案，將其內容更改如下：

 

1. #ifndef MYSQLQUERYMODEL_H
2. #define MYSQLQUERYMODEL_H
3.  
4. #include <QSqlQueryModel>
5.  
6. class MySqlQueryModel : public QSqlQueryModel
7. {
8.     Q_OBJECT
9. public:
10.     explicit MySqlQueryModel(QObject *parent = 0);
11.     Qt::ItemFlags flags(const QModelIndex &index) const;
12.     bool setData(const QModelIndex &index, const QVariant &value, int role);
13.     QVariant data(const QModelIndex &item, int role=Qt::DisplayRole) const;
14.  
15. private:
16.     bool setName(int studentId, const QString &name);
17.     void refresh();
18. };
19.  
20. #endif // MYSQLQUERYMODEL_H

複製程式碼

 

3.到mysqlquerymodel.cpp檔案中，更改如下：

 

1. #include "mysqlquerymodel.h"
2. #include <QSqlQuery>
3. #include <QColor>
4.  
5. MySqlQueryModel::MySqlQueryModel(QObject *parent) :
6.     QSqlQueryModel(parent)
7. {
8. }
9.  
10. Qt::ItemFlags MySqlQueryModel::flags(
11.         const QModelIndex &index) const //返回表格是否可更改的標誌
12. {
13.     Qt::ItemFlags flags = QSqlQueryModel::flags(index);
14.     if (index.column() == 1) //第二個欄位可更改
15.         flags |= Qt::ItemIsEditable;
16.     return flags;
17. }
18.  
19. bool MySqlQueryModel::setData(const QModelIndex &index, const QVariant &value, int /* role */)
20. //新增資料
21. {
22.     if (index.column() < 1 || index.column() > 2)
23.         return false;
24.     QModelIndex primaryKeyIndex = QSqlQueryModel::index(index.row(), 0);
25.     int id = data(primaryKeyIndex).toInt(); //獲取id號
26.     clear();
27.     bool ok;
28.     if (index.column() == 1) //第二個欄位可更改
29.         ok = setName(id, value.toString());
30.     refresh();
31.     return ok;
32. }
33.  
34. void MySqlQueryModel::refresh() //更新顯示
35. {
36.     setQuery("select * from student");
37.     setHeaderData(0, Qt::Horizontal, QObject::tr("id"));
38.     setHeaderData(1, Qt::Horizontal, QObject::tr("name"));
39. }
40.  
41. //新增name欄位的值
42. bool MySqlQueryModel::setName(int studentId, const QString &name)
43. {
44.     QSqlQuery query;
45.     query.prepare("update student set name = ? where id = ?");
46.     query.addBindValue(name);
47.     query.addBindValue(studentId);
48.     return query.exec();
49. }
50.  
51. //更改資料顯示樣式
52. QVariant MySqlQueryModel::data(const QModelIndex &index, int role) const
53. {
54.     QVariant value = QSqlQueryModel::data(index, role);
55.  
56.     //第一個欄位的字型顏色為紅色
57.     if (role == Qt::TextColorRole && index.column() == 0)
58.         return qVariantFromValue(QColor(Qt::red));
59.     return value;
60. }

複製程式碼

 

4.到mainwindow.cpp檔案中先新增標頭檔案包含：

 

1. #include "mysqlquerymodel.h"

複製程式碼

 

 

5.更改查詢按鈕槽內容如下：

 

1. void MainWindow::on_pushButton_clicked()
2. {
3.     QSqlQueryModel *model = new QSqlQueryModel(this);
4.     model->setQuery("select* from student");
5.    model->setHeaderData(0, Qt::Horizontal, tr("id"));
6.    model->setHeaderData(1, Qt::Horizontal, tr("name"));
7.    QTableView *view = new QTableView;
8.    view->setModel(model);
9.    view->show();
10.    
11. //建立自己模型的物件
12.    MySqlQueryModel *myModel = new MySqlQueryModel(this);
13.    myModel->setQuery("select * from student");
14.    myModel->setHeaderData(0, Qt::Horizontal, tr("id"));
15.    myModel->setHeaderData(1, Qt::Horizontal, tr("name"));
16.    QTableView *view1 = new QTableView;
17.    view1->setWindowTitle("mySqlQueryModel"); //修改視窗標題
18.    view1->setModel(myModel);
19.    view1->show();
20. }

複製程式碼

 

執行程式，效果如下圖所示。

 

 

結語

---

 

本節講解了QSqlQueryModel的相關內容，該類預設是一個只讀的SQL語句查詢模型，不過可以對其進行重寫來實現編輯功能。