[Qt教程] 第25篇 数据库（五）SQL表格模型QSqlTableModel

[Qt教程] 第25篇 数据库（五）SQL表格模型QSqlTableModel

楼主

  发表于 2013-5-21 20:36:22  | 查看: 923 | 回复: 7

SQL表格模型QSqlTableModel 版权声明 该文章原创于作者yafeilinux，转载请注明出处！ 导语 在上一篇我们讲到只读的QsqlQueryModel模型其实也可以实现编辑功能的，但是实现起来很麻烦。而QSqlTableModel提供了一个一次只能操作单个SQL表的读写模型，它是QSqlQuery的更高层次的替代品，可以浏览和修改独立的SQL表，并且只需编写很少的代码，而且不需要了解SQL语法。 环境： Windows Xp + Qt 4.8.4+QtCreator 2.6.2 目录 一、创建数据库 二、修改操作 三、查询操作 四、排序操作 五、删除操作 六、插入操作 正文 一、创建数据库 1. 新建Qt Gui 应用，项目名称为tableModel ，基类QMainWindow ，类名MainWindow 。 2. 完成后打开tableModel.pro 文件，将第一行代码更改为： QT        += coregui sql         然后保存文件。 3. 向项目中添加新的C++ 头文件，名称为connection.h 。完成后将其内容更改如下： #ifndef   CONNECTION_H #define   CONNECTION_H #include   <QSqlDatabase> #include   <QSqlQuery> static   bool   createConnection() {      QSqlDatabase   db   =   QSqlDatabase ::addDatabase( "QSQLITE" );      db.setDatabaseName( "database.db" );      if (!db.open())   return   false ;      QSqlQuery   query;      query.exec( QString (        "create tablestudent (id int primary key, name vchar)" ));      query.exec( QString ( "insert into student values (0,' 刘明')" ));      query.exec( QString ( "insert into student values (1,' 陈刚')" ));      query.exec( QString ( "insert into student values (2,' 王红')" ));      return   true ; } #endif   // CONNECTION_H         这里因为语句中使用了中文，所以使用了QString() 进行编码转换，这个还需要在main() 函数中设置编码。 4. 下面将main.cpp 文件更改如下： #include   "mainwindow.h" #include   <QApplication> #include   "connection.h" #include   <QTextCodec> int   main ( int   argc,   char   *argv[]) {      QApplication   a(argc,   argv);     QTextCodec::setCodecForTr(QTextCodec::codecForName("utf8"));      QTextCodec ::setCodecForCStrings( QTextCodec ::codecForLocale());      if (!createConnection())         return   1 ;      MainWindow   w;      w.show();          return   a.exec(); }      这里的setCodecForCStrings()就是用来设置字符串编码的。 5. 下面进入设计模式，向窗口上拖入Label 、Push Button 、Line Edit 和Table View 等部件，进行界面设计，效果如下图所示。 6. 完成后到mainwindow.h 文件中，先包含头文件： #include   <QSqlTableModel> 然后添加私有对象声明： QSqlTableModel   * model ; 7. 到mainwindow.cpp ，在构造函数添加如下代码： model   =   new   QSqlTableModel ( this ); model ->setTable( "student" ); model ->setEditStrategy( QSqlTableModel :: OnManualSubmit ); model ->select();   // 选取整个表的所有行 // 不显示name属性列,如果这时添加记录，则该属性的值添加不上 // model->removeColumn(1); ui -> tableView ->setModel( model ); // 使其不可编辑 //ui->tableView->setEditTriggers(QAbstractItemView::NoEditTriggers); 这里创建一个QSqlTableModel后，只需使用setTable()来为其指定数据库表，然后使用select()函数进行查询，调用这两个函数就等价于执行了“select * from student”这个SQL语句。这里还可以使用setFilter()来指定查询时的条件，在后面会看到这个函数的使用。在使用该模型以前，一般还要设置其编辑策略，它由QSqlTableModel::EditStrategy枚举变量定义，一共有三个值，如下图所示。用来说明当数据库中的值被编辑后，什么情况下提交修改。 运行程序，效果如下图所示。        可以看到，这个模型已经完全脱离了SQL 语句，我们只需要执行select() 函数就能查询整张表。上面有两行代码被注释掉了，你可以取消注释，测试一下它们的作用。 二、修改操作 1. 我们进入“提交修改”按钮的单击信号槽，更改如下： void   MainWindow ::on_pushButton_3_clicked() {      model ->database().transaction();   // 开始事务操作      if   ( model ->submitAll())   {         model ->database().commit();   // 提交      }   else   {         model ->database().rollback();   // 回滚         QMessageBox ::warning( this ,   tr( "tableModel" ),                               tr( " 数据库错误: %1" )                               .arg( model ->lastError(). text()));      } }         这里用到了事务操作，真正起提交操作的是model->submitAll() 一句，它提交所有更改。 2. 进入“撤销修改”按钮的单击信号槽，更改如下： void   MainWindow ::on_pushButton_4_clicked() {      model ->revertAll(); } 3. 在mainwindow.cpp文件中包含 头文件： #include   <QMessageBox> #include   <QSqlError> 4. 现在运行程序，我们将“ 陈刚” 改为“ 李强” ，如果我们点击“ 撤销修改” ，那么它就会重新改为“ 陈刚” ，而当我们点击“ 提交修改” 后它就会保存到数据库，此时再点击“ 撤销修改” 就修改不回来了。         可以看到，这个模型可以将所有修改先保存到model 中，只有当我们执行提交修改后，才会真正写入数据库。当然这也是因为我们在最开始设置了它的保存策略： model->setEditStrategy(QSqlTableModel::OnManualSubmit); 这里的OnManualSubmit表明我们要提交修改才能使其生效。 三、查询操作 1. 进入“查询”按钮的单击信号槽，更改如下： void   MainWindow ::on_pushButton_clicked() {      QString   name   =   ui -> lineEdit ->text();      // 根据姓名进行筛选      model ->setFilter( QString ( "name = '%1'" ).arg(name));      // 显示结果      model ->select(); }         使用setFilter() 函数进行关键字筛选，这个函数是对整个结果集进行查询。 2. 进入“显示全表”按钮的单击信号槽，更改如下： void   MainWindow ::on_pushButton_2_clicked() {      model ->setTable( "student" );     // 重新关联表      model ->select();     // 这样才能再次显示整个表的内容 } 为了再次显示整个表的内容，我们需要再次关联这个表。 3. 下面运行程序，输入一个姓名，点击“ 查询” 按钮后，就可以显示该记录了。再点击“ 显示全表” 按钮则返回。如下图所示。 四、排序操作 分别进入“ 按id 升序排序” 和“ 按id 降序排序” 按钮的单击信号槽，更改如下： //  升序 void   MainWindow ::on_pushButton_7_clicked() {      model ->setSort( 0 ,   Qt :: AscendingOrder );   //id 属性即第0列，升序排列      model ->select(); } //  降序 void   MainWindow ::on_pushButton_8_clicked() {      model ->setSort( 0 ,   Qt :: DescendingOrder );      model ->select();    } 这里使用了setSort()函数进行排序，它有两个参数，第一个参数表示按第几个属性排序，表头从左向右，最左边是第0个属性，这里就是id属性。第二个参数是排序方法，有升序和降序两种。运行程序，效果如下图所示。 五、删除操作 我们进入“删除选中行”按钮的单击信号槽，更改如下： void   MainWindow ::on_pushButton_6_clicked() {      // 获取选中的行      int   curRow   =   ui -> tableView ->currentIndex().row();          // 删除该行      model ->removeRow(curRow);          int   ok   =   QMessageBox ::warning( this ,tr( " 删除当前行!" ),tr( " 你确定"                                                   " 删除当前行吗？" ),                                    QMessageBox :: Yes , QMessageBox :: No );      if (ok   ==   QMessageBox :: No )      {         model ->revertAll();   // 如果不删除，则撤销      }      else   model ->submitAll();   // 否则提交，在数据库中删除该行   } 删除行的操作会先保存在model中，当我们执行了submitAll()函数后才会真正的在数据库中删除该行。这里我们使用了一个警告框来让用户选择是否真得要删除该行。运行程序，效果如下图所示。 我们点击第二行，然后单击“删除选中行”按钮，出现了警告框。这时你会发现，表中的第二行前面出现了一个小感叹号，表明该行已经被修改了，但是还没有真正的在数据库中修改，这时的数据有个学名叫脏数据(Dirty Data)。当我们按钮“Yes”按钮后数据库中的数据就会被删除，如果按下“No”，那么更改就会取消。 六、插入操作         我们进入“添加记录”按钮的单击信号槽，更改如下： void   MainWindow ::on_pushButton_5_clicked() {      int   rowNum   =   model ->rowCount();   // 获得表的行数      int   id   =   10 ;      model ->insertRow(rowNum);   // 添加一行      model ->setData( model ->index(rowNum, 0 ),id);      //model->submitAll(); // 可以直接提交 } 在表的最后添加一行，因为在student表中我们设置了id号是主键，所以这里必须使用setData()函数给新加的行添加id属性的值，不然添加行就不会成功。这里可以直接调用submitAll()函数进行提交，也可以利用“提交修改”按钮进行提交。运行程序，效果如下图所示。 按下“添加记录”按钮后，就添加了一行，不过在该行的前面有个星号，如果我们按下“提交修改”按钮，这个星号就会消失。当然，如果我们将上面代码里的提交函数的注释去掉，也就不会有这个星号了。 结语 可以看到这个模型很强大，而且完全脱离了SQL语句，就算你不怎么懂数据库知识，也可以利用它进行大部分常用的操作。我们也看到了，这个模型提供了缓冲区，可以先将修改保存起来，当我们执行提交函数时，再去真正地修改数据库。当然，这个模型比前面的模型更高级，前面讲的所有操作，在这里都能执行。 涉及到的源码：  tableModel.zip (3.98 KB, 下载次数: 11)