Qt数据库（5） - 使用SQL Model类

Qt Version 5.14.0

除了QSqlQuery，Qt还提供了三个高级类用来访问数据库，分别为QSqlQueryModel、QSqlTableModel、QSqlRelationalTableModel。

• QSqlQueryModel 基于任意SQL语句的只读模型
• QSqlTableModel 只对一张表进行操作的读写模型
• QSqlRelationalTableModel QSqlTableModel的子类，支持外键

这三个类继承自QAbstractTableModel，这使得在ItemView类（比如QTableVIew、QListView、QTreeView）中显示数据库中的数据变得很简单。具体细节详见Qt助手关键字：Presenting Data in a Table View。

The SQL Query Model

QSqlQueryModel提供一个只读模型，该模型数据基于SQL query。示例代码如下：

QSqlQueryModel model;
model.setQuery("SELECT * FROM employee");

设置完SQL语句之后，可以使用record(int)函数来访问单独的记录，代码如下：

for (int i = 0; i < model.rowCount(); ++i) 
{
 	int id = model.record(i).value("id").toInt();
	QString name = model.record(i).value("name").toString();
	qDebug() << id << name;
 }

也可以使用从QAbstractItemModel继承的接口来访问model中的数据。 setQuery()接口还有一个重载函数，可以接收QSqlQuery对象作为参数，这样就可以利用QSqlQuery所有特性，比如占位符。

The SQL Table Model

QSqlTableModel提供一次只作用于一张表的可读写模型。示例代码如下：

 QSqlTableModel model;
 model.setTable("employee");
 model.setFilter("salary > 50000");
 model.setSort(2, Qt::DescendingOrder);
 model.select();

 for (int i = 0; i < model.rowCount(); ++i) 
 {
 	QString name = model.record(i).value("name").toString();
 	int salary = model.record(i).value("salary").toInt();
  	qDebug() << name << salary;
 }

用代码修改表中数据的流程如下：

• 获取某一行record：model.record(i)
• 修改record中某个字段对应的数据：record.setValue("字段名", 值)
• 替换model中对应位置record：model.setRecord()

也可以使用从QAbstractItemModel继承的接口data()和setData()，以下代码调用setData接口完成model中的数据刷新：

model.setData(model.index(row, column), 75000);
model.submitAll();

数据插入

model.insertRows(row, 1);
model.setData(model.index(row, 0), 1013);
model.setData(model.index(row, 1), "Peter Gordon");
model.setData(model.index(row, 2), 68500);
model.submitAll();

删除5行连续数据

model.removeRows(row, 5);
model.submitAll();

修改何时生效

当你修改记录时，需要调用QSqlTableModel::submitAll()来保证修改已经被写入数据库。而何时调用这个函数取决于QSqlTableModel的编辑策略

• QSqlTableModel::OnFieldChange：无缓存，一有修改立刻写入数据库
• SqlTableModel::OnRowChange：缓存某一行修改，当你选择其它行时，之前的修改立刻写入数据库
• QSqlTableModel::OnManualSubmit：缓存所有修改，直到手动调用submitAll()或revertAll()

注意：对于新插入行，OnFieldChange行为与OnRowChange一致。

The SQL Relational Table Model

QSqlRelationalTableModel对QSqlTableModel进行了扩展，提供了外键支持。

如上图，左表使用QSqlTableModel，第三、四列存储的是另一个地址表的主键，不利于阅读。右表使用QSqlRelationalTableModel，可以将地址表的主键自动替换成某个其它字段，便于阅读。 示例代码如下：

 model->setTable("employee");
 model->setRelation(2, [QSqlRelation](qsqlrelation.html)("city", "id", "name"));
 model->setRelation(3, [QSqlRelation](qsqlrelation.html)("country", "id", "name"));