QtSQL学习笔记（4）- 使用SQL Model类

除了QSqlQuery，Qt提供了3个高级类用于访问数据库。这些类是QSqlQueryModel、QSqlTableModel和QSqlRelationalTableModel。

      这些类是由QAbstractTableModel(继承自QAbstractItemModel)驱动并且它通过一个条目视图类（比如QListView和QTableView）使得表示数据库的数据更加简单。这个详细介绍在“用一个表视图表示数据”一节。

      使用这些类的另外一个好处是它使得你的代码能够更容易适用于其他数据源。例如，如果你使用的是QSqlTableModel，之后你打算使用XML文件来替换数据库存储数据，那么这个仅仅是简单地用一个数据模型替换另一个数据模型的问题。

 

SQL查询模型

QSqlQueryModel提供一个基于SQL查询的只读模型。例如：

1 QSqlQueryModel model;
2 model.setQuery("SELECT * FROM employee");
3 
4 for (int i = 0; i < model.rowCount(); ++i) {
5     int id = model.record(i).value("id").toInt();
6     QString name = model.record(i).value("name").toString();
7     qDebug() << id << name;
8 }

      在使用QSqlQueryModel::setQuery()设置好查询之后，你可以使用QSqlQueryModel::record(int)来访问单个记录。你也可以使用QSqlQueryModel::data()和其他任何继承自QAbstractItemModel的函数。

      还有一个重载的setQuery()方法，它带有一个QSqlQuery对象并且在它的结果集中进行操作。它使得你可以使用QSqlQuery的任意特性来设置查询（例如，prepared queries）。

 

SQL表模型

QSqlTableModel提供一个一次只能对一个SQL表进行操作的可读可写模型。例如：

 1 QSqlTableModel model;
 2 model.setTable("employee");
 3 model.setFilter("salary > 50000");
 4 model.setSort(2, Qt::DescendingOrder);
 5 model.select();
 6 
 7 for (int i = 0; i < model.rowCount(); ++i) {
 8     QString name = model.record(i).value("name").toString();
 9     int salary = model.record(i).value("salary").toInt();
10     qDebug() << name << salary;
11 }

      QSqlTableModel是一个高级的可替代QSqlQuery的模型，可以用于浏览和修改单个SQL表。它典型的优点是只需要少量的代码并且不需要了解SQL语法。

      使用QSqlTableModel::record()来检索表中的一行，然后使用QSqlTableModel::setRecord()来修改这一行。例如，下面的代码将对所有雇员的薪水增加10%。

1 for (int i = 0; i < model.rowCount(); ++i) {
2     QSqlRecord record = model.record(i);
3     double salary = record.value("salary").toInt();
4     salary *= 1.1;
5     record.setValue("salary", salary);
6     model.setRecord(i, record);
7 }
8 model.submitAll();

      你也可以使用继承自QAbstractItemModel的方法QSqlTableModel::data()和QSqlTableModel::setData()来修改这些数据。例如，下面的代码展示了怎样用setData()更新一条记录：

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

下面的代码时怎样插入一行：

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

下面的代码时如何删除5条连续行：

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

      QSqlTableModel::removeRows()的第一个参数是带删除的第一行的索引号。  

      当你完成了对记录的修改，你总是需要调用QSqlTableModel::submitAll()来确保这些改动被写入到数据库中。

      什么时候以及是否真的需要调用submitAll()实际上取决于表的编辑策略(edit strategy)，默认的策略是QSqlTableModel::OnRowChange，也就是说当用户选择了另一个不同的行时上一行的改动将被应用到数据库。其他的策略还包括QSqlTableModel::OnManualSubmit（所有改动将缓存在模型中，直到你调用submitAll()方法）和QSqlTableModel::OnFieldChange (不缓存改动)。这些策略在QSqlTableModel结合一个视图一起使用时相当有用。

 

SQL关系表模型

      QSqlRelationalTableModel扩展了QSqlTableModel来提供了对外键(foreign key)的支持。一个外键是一个表中的一个字段与另一个表中的主键(primary key)字段之间的一一映射。例如，如果一个book表中有一个authorid字段关联到author表中的id字段，那么我们说authorid是一个外键。

The screenshot on the left shows a plain QSqlTableModel in a QTableView. Foreign keys (city and country) aren't resolved to human-readable values. The screenshot on the right shows a QSqlRelationalTableModel, with foreign keys resolved into human-readable text strings.

下面的代码片段展示了如何设置QSqlRelationalTableModel：

1 model->setTable("employee");
2 
3 model->setRelation(2, QSqlRelation("city", "id", "name"));
4 model->setRelation(3, QSqlRelation("country", "id", "name"));

可以查阅QSqlRelationalTableModel文档了解更多内容。