​​[Qt教程]​​​​第25篇 数据库(五)SQL表格模型QSqlTableModel​​








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)