Qt学习笔记（九）数据库

QSql模块提供了与平台以及数据库种类无关的访问SQL数据库的接口。这个接口由利用Qt的模型/视图结构将数据库与用户界面集成的一套类来支持。由于授权许可的限制，Qt的开源版本无法提供所有的驱动程序。当配置Qt时，既可以选择Qt本身包含的驱动程序，也可以以插件的形式建立驱动程序。

对于习惯了SQL语法的用户，QSqlQuery类提供了一种直接执行任意的SQL语句并处理其结果的方式；对于喜欢更高级、友好的数据库界面以避免SQL语法的用户，QSqlTableModel和QSqlRelationTableModel则提供了合适的抽象。这些类以与Qt其他模型类相同的方式来表示一个SQL表。他们可以被单独用来遍历和编辑程序代码中的数据，也可以添加最终用户能够查看和修改数据的视图。

QT笔记:数据库总结(一)

 #include
QT += sql
QSqlDatabase类实现了数据库连接的操作
QSqlQuery类执行SQL语句
QSqlRecord类封装数据库所有记录

QSqlDatabase类

 QSqlDatabase db = QSqlDatabase::addDatabase("QOCI");
 db.setHostName("localhost");    //数据库主机名
 db.setDatabaseName("scott");    //数据库名
 db.setUserName("stott");        //数据库用户名
 db.setPassword("tiger");        //数据库密码
 db.open();          //打开数据库连接
 db.close();         //释放数据库连接

建立数据库文件

 QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
 db.setDatabaseName("database.db");
 if (!db.open())
 {
     qDebug("数据库不能打开");
 }
 return false;

 建立数据库文件后创建表并插入两条数据

 QSqlQuery query;
 query.exec("create table student(id INTEGER PRIMARY KEY autoincrement,
             name nvarchar(20), age int)"); //id自动增加
 query.exec("insert into student values(1,'小明', 14)");
 query.exec("insert into student values(2,'小王',15)");

QSqlQuery类

插入值到数据库操作

一、直接用SQL语句插入(参照上面)

二、利用预处理方式插入(ORACLE语法和ODBC语法)

适合插入多条记录，或者避免将值转换成字符串（即正确地转义），调用prepare()函数指定一个包含占位符的query,然后绑定要插入的值

ORACLE语法

 QSqlQuery query;
 query.prepare("INSERT INTO T_STUDENT (name, age) VALUES (:name, :age)"); //准备执行SQL查询
 query.bindValue(":name", "小王");   //在绑定要插入的值
 query.bindValue(":age", 11);
 query.exec();

ODBC语法

 QSqlQuery query;
 query.prepare("INSERT INTO T_STUDENT (name,age) VALUES (?,?)"); //准备执行SQL查询
 query.addBindValue("小王");   //在绑定要插入的值
 query.bindValue(11);
 query.exec();

三、批量插入到数据库中

 QSqlQuery query;
 query.prepare(“insert into student values (?, ?)”);
 QVariantList names;
 names << "小王" << "小明" << "小张" << "小新"; // 如果要提交空串，用QVariant(QVariant::String)代替名字
 query.addBindValue(names);
 QVariantList ages;
 ages << 11 << 13 << 12 << 11;
 query.addBindValue(ages);
 if (!q.execBatch()) //进行批处理，如果出错就输出错误
     qDebug() << q.lastError();

查询数据库操作

 QSqlQuery query;
 query.exec("SELECT * FROM t_STUDENT"); // 查询的结果可能不止一条记录，所以我们称之为结果集
 while (query.next())
 {
     QString name = query.value(0).toString(); //取第i条记录第1个字段(从0开始计数)的结果
     int age = query.value(0).toInt(); //取第i条记录第2个字段的结果
     // ... 处理name,age变量数据
 }

seek(int n) ：query指向结果集的第n条记录。指定当前的位置

first() ：query指向结果集的第一条记录。

last() ：query指向结果集的最后一条记录。

next() ：query指向下一条记录，每执行一次该函数，便指向相邻的下一条记录。

previous() ：query指向上一条记录，每执行一次该函数，便指向相邻的上一条记录。

record() ：获得现在指向的记录。

value(int n) ：获得属性的值。其中n表示你查询的第n个属性

int rowNum = query.at(); //获取query所指向的记录在结果集中的编号

int fieldNo = query.record().indexOf(“name”); //返回"name"的列号

int columnNum = query.record().count(); //获取每条记录中属性（即列）的个数

 

事务操作

操作函数：transaction()，commit()提交，rollback()回滚
操作事务前，先判断该数据库是否支持事务操作。hasFeature是QSQLDriver类函数

 if (QSqlDatabase::database().driver()->hasFeature(QSqlDriver::Transactions)){ ... } //

 插入一条记录，然后提交事务

 QSqlDatabase::database().transaction();
 QSqlQuery query;
 query.exec("SELECT id FROM T_STUDENT WHERE class=1");
 if (query.next())
 {
     query.exec("INSERT INTO T_STUDENT (id,name,age) VALUES (3,'小李',13)");
 }
 QSqlDatabase::database().commit();

///

QT笔记:数据库总结(二)之SQL模型类-QSqlQueryModel模型

   QSqlQueryModel类为SQL的结果集提供了一个只读的数据模型,下面我们先利用这个类进行一个最简单的操作.

常用函数

void QSqlQueryModel::setQuery ("SQL语句") // 执行SQL语句，此处还可以传入QSqlQuery对象,此时可以利用QSqlQuery类的某些特性，如预操作等.

setHeaderData()     //设置水平头标题

columnCount(); //获得列数

columnCount(); //获得列数

QSqlRecord QSqlQueryModel::record ( int row ) const //返回row行包含的信息,可访问单条的记录

QModelIndex QAbstractItemModel::index ( int row, int column, const QModelIndex & parent = QModelIndex() )  //返回指定的行和列的索引(index)

index.data()  //返回index索引的值

query() //返回与QSqlQuery相关的模型

 QSqlQueryModel *model = new QSqlQueryModel;
 model->setQuery(“select * from student”);
 model->setHeaderData(0, Qt::Horizontal, tr(“id”));
 model->setHeaderData(1, Qt::Horizontal, tr(“name”));
 QTableView *view = new QTableView;
 view->setModel(model);
 view->show();

 

利用query执行SQL语句

 QSqlQuery query = model->query();
 query.exec("select name from student where id = 1");
 query.next();
 qDebug() << query.value(0).toString(); // 如果上面的select改成insert语句，而且是显示在QTableView中的话，需再查询一次model->setQuery("select ...")才能显示刚插入的语句

       因为QSqlQueryMode模型默认是只读的，所以我们在窗口上并不能对表格中的内容进行修改。但是我们可以创建自己的模型，然后按照我们自己的需要来显示数据和修改数据。如果要想使其可读写，需要自己的类继承自QSqlQueryModel，并且重写setData() 和 flags() 两个函数，如果我们要改变数据的显示，就要重写data() 函数。

 Qt::ItemFlags MySqlQueryModel::flags(const QModelIndex &index) const //返回表格是否可更改的标志
 {
      Qt::ItemFlags flags = QSqlQueryModel::flags(index);
      if (index.column() == 1) //第二个字段可更改,即学生的名字字段
         flags |= Qt::ItemIsEditable;
      return flags;
  }

 bool MySqlQueryModel::setData(const QModelIndex &index, const QVariant &value, int /* role */) //表格添加数据
 {
     QModelIndex primaryKeyIndex = QSqlQueryModel::index(index.row(), 0);
     int id = data(primaryKeyIndex).toInt(); //获取id号 也可以这样用,primaryKeyIndex.data();

     clear();
     bool isOk;
     if (index.column() == 1) //第二个属性可更改
     {
         QSqlQuery query;
         query.prepare("UPDATE STUDENT SET NAME = :name WHERE id = :id");
         query.bindValue(":name","小五");
         query.bindValue(":id",id);
         isOk = query.exec();

         refresh();// 此处最好添加代码刷新结果，或在此调用刷新函数
         return isOK;
     }
     return false;
 }

 void MySqlQueryModel::refresh() //更新显示
 {
     setQuery("select * from student");
     setHeaderData(0, Qt::Horizontal, QObject::tr("学号ID"));
     setHeaderData(1, Qt::Horizontal, QObject::tr("名字"));
 } //

 //tata()改写某一个列的显示样式,对齐方式
 QVariant MySqlQueryModel::data(const QModelIndex &index, int role) const
 {
     QVariant value = QSqlQueryModel::data(index, role);
     if (role == Qt::TextColorRole && index.column() == 0)
         return qVariantFromValue(QColor(Qt::red)); //第一个属性的字体颜色为红色

     if (role == Qt::TextAlignmentRole && index.column() == 1)
     {
         value = (Qt::AlignVCenter + Qt::AlignRight); // 靠右垂直居中
     }

     return value;
 }

///

 

QT笔记:数据库总结(三)之SQL模型类-QSqlTableModel模型

   QSqlTableModel类继承至QSqlQueryModel类,该类提供了一个可读写单张SQL表的可编辑数据模型，功能：修改，插入，删除，查询，和排序

常用函数

QVariant headerData ( int section,Qt::Orientation orientation, int role = Qt::DisplayRole ) const  获取水平头或垂直头标题

bool setHeaderData ( int section,Qt::Orientation orientation, const QVariant & value, int role = Qt::EditRole ) 设置水平头或垂直头标题

int rowCount ( const QModelIndex & parent= QModelIndex() ) const // 返回行数

int columnCount ( const QModelIndex &index = QModelIndex() ) const // 返回列数

virtual bool removeColumns ( int column, int count, const QModelIndex & parent = QModelIndex() ) //model->removeColumns (0)删除第一列

bool QSqlTableModel::submitAll ()，//提交所有被修改的数据，然后修改的数据被保存在数据库中

void QSqlTableModel::revertAll ()  //撤销所有的修改，如果数据库已经被提交了修改，就不能通过撤销修改改回来了

virtual void revertRow ( int row ) //恢复指定行的改变

void QSqlTableModel::setFilter ( const QString & filter )  //筛选，按照字符串filter对数据库进行筛选，相当于SQL中的WHERE语句

bool QSqlTableModel::select ()   //在筛选和排序的条件下，将数据库中符合要求的在mode表格中显示出来

void QSqlTableModel::setSort ( int column, Qt::SortOrder order ) //排序操作。按照列和Qt::SortOrder排序。Qt::SortOrder有升序和降序

bool insertRow ( int row, const QModelIndex & parent = QModelIndex() )  //插入行

bool insertColumn ( int column, constQModelIndex & parent = QModelIndex() ) // 插入列

model->setEditStrategy(QSqlTableModel::OnManualSubmit);   //设置保存策略为手动提交

 

一、在QTableView中显示数据库中表的数据

 QSqlTableModel *model = new QSqlTableModel(parentObject, database); // 摘抄自帮助文档
 model->setTable("employee");
 model->setEditStrategy(QSqlTableModel::OnManualSubmit);
 model->select();
 model->removeColumn(0); // don't show the ID
 model->setHeaderData(0, Qt::Horizontal, tr("Name"));
 model->setHeaderData(1, Qt::Horizontal, tr("Salary"));

 QTableView *view = new QTableView;
 view->setModel(model);
 view->show();

二、修改QTableView中数据后的提交，加入事务处理

 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->revertAll(); //撤销修改

 

三、查询操作

相当于SQL语句:SELECT * FROM 表名 WHERE name = "name变量"

 model->setFilter(QObject::tr(“name = ‘%1′”).arg(name)); //根据姓名进行筛选
 model->select(); //显示结果
 for (int i = 0; i < model.rowCount(); ++i)
 {
     QString name = model.record(i).value("name").toString();
     // ... 在此处理每一条的记录
 }

 // 在操作大数据集时，建议通过索引指定字段
 int primaryKeyIndex  = model.record().indexOf("id");
 for (int i = 0; i < model.rowCount(); ++i)
 {
     QSqlRecord record = model.record(i);
     QString name = record.value("name").toString();
     // ... 在此处理每一条的记录
 }

四、排序操作

 model->setSort(0,Qt::AscendingOrder); //id属性，即第0列，升序排列,Qt::DescendingOrder为降序排序
 model->select();

五、插入操作

 int rowNum = model->rowCount(); //获得表的行数
 int id = 最后一个ID+1;
 model->insertRow(rowNum); //添加一行,或者用insertRows(0,1),在0行添加1条记录，根据表的排序规则，可能移到与指定行不同的行位置上
 model->setData(model->index(rowNum,0),id);  //因为这里设置了ID为主键，所以必须给新行添加id属性值,id字段在第0列上
 model->submitAll(); //可以直接提交

 

六、删除一条记录

首先要定位到待删除的行上

 model.setFilter("id = 10");
 model.select();
 if (model.rowCount() == 1)
 {
     model.removeRows(0,1) // 如果要删除所有满足条件的记录则把1改成model.rowCount()
     model.submitAll();
 }

 

在QTableView中删除选中的一行

 int curRow = tableView->currentIndex().row();
 model->removeRow(curRow);   //删除一行

在QTableView中删除选中的多行

QAbstractItemView::SelectionModeselectionMode()const // 原型

QModelIndexList QItemSelectionModel::selectedIndexes()const  //原型

 QItemSelectionModel *selections = tableView->selectionModel(); //返回当前的选择模式
 QModelIndexList selecteds = selections->selectedIndexes(); //返回所有选定的模型项目索引列表
 foreach (QModelIndex index, selecteds)
 {
     int curRow = index.row(); //删除所有被选中的行
     model->removeRow(curRow);
 }

 int ok = QMessageBox::warning(this,tr("删除选中的行!"),tr("你确定删除当前选取中的行吗?"),QMessageBox::Yes,QMessageBox::No);
 if(ok == QMessageBox::Yes)
 {
     model->submitAll(); //提交，在数据库中删除该行
 } else {
     model->revertAll(); //如果不删除，则撤销
 }

七、更新记录

必须先定位记录

 model.setFilter("id = 10");
 model.select();
 if (model.rowCount() == 1)
 {
     model.setData(model.index(0,1),QObject::tr("小王"));
     model.submitAll();
 }

    可以看到这个模型很强大，而且完全脱离了SQL语句，就算你不怎么懂数据库，也可以利用它进行大部分常用的操作。这个模型提供了缓冲区，可以将所有修改先保存到model中，只有当我们执行提交修改后，才会真正写入数据库。当然这也是因为我们在最开始设置了它的保存策略：

model->setEditStrategy(QSqlTableModel::OnManualSubmit);

OnManualSubmit表明我们要提交修改才能使其生效。可以先将修改保存起来，当我们执行提交函数时，再去真正地修改数据库。当然，这个模型比前面的模型更高级，前面讲的所有操作，在这里都能执行。

QT笔记:数据库总结(四)之SQL模型类-QSqlRelationalTableModel模型

该类为单张的数据库表提供了一个可编辑的数据模型，它支持外键，除此之外和QSqlTableModel没有什么不同

 model = new QSqlRelationalTableModel(this);
 model->setEditStrategy(QSqlTableModel::OnFieldChange); //属性变化时写入数据库
 model->setTable("student");
 model->setRelation(2,QSqlRelation("course","id","name"));//将student表的第三个属性设为course表的id属性的外键，并将其显示为course表的name属性的值
 model->setHeaderData(0, Qt::Horizontal, QObject::tr("ID"));
 model->setHeaderData(1, Qt::Horizontal, QObject::tr("Name"));
 model->setHeaderData(2, Qt::Horizontal, QObject::tr("Course"));
 model->select();
 tableView->setModel(model);

 

如果我们希望用户更改课程属性时，只能在课程表中已有的课程中进行选择，而不能随意填写课程，那么Qt中的QSqlRelationalDelegate委托类就能实现这个功能

 tableView->setItemDelegate(new QSqlRelationalDelegate(tableView));

QT笔记:数据库总结(五)之SQL模型类-QDataWidgetMapper类

 QDataWidgetMapper将一个数据库记录字段反映到其映射的窗口部件中，同时将窗口部件中所做出的更改反映回数据库，关键是关联一个model和一组widget
一、步骤

1、创建 QDataWidgetMapper 对象
2、关联 model
3、关联 widgets，并创建其与model中section的映射
4、定位到某个record

 QDataWidgetMapper *mapper = new QDataWidgetMapper;
 mapper->setModel(model);
 mapper->addMapping(mySpinBox, 0);
 mapper->addMapping(myLineEdit, 1);
 mapper->toFirst();

提交方式可以设为手动：

 mapper->setSubmitPolicy(QDataWidgetMapper::ManualSubmit);

 QComboBox组件的mapper比较特殊

第一种、在关系模型中实现mapper到QComboBox组件

 QSqlRelationalTableModel *model = QSqlRelationalTableModel(this);

 model->setTable("员工表");
 model->setRelation(dep_id,QSqlRelation("部门表","id","name"));
  // ... 其它代码

 //QComboBox与QListWidget很相拟,因为它有一个内部模型去保存它的数据条目,所以我们用自己建的模型代替那个自带的模型。给出QSqlRelationalTableModel使用的关系模型，这个模型有两列,必须指出组合框应该显示哪一列
 QSqlTableModel *relationModel = model->relationModel(dep_id); // 部门ID
 comboBox->setMode(relationModel);
 comboBox->setModelColumn(relationModel->fieldIndex("name")); // 使用字段名得到正确的标题索引,以使组合框显示部门名

 

第二种、使用代理的方式

1、实现自定义代理类，实现setEditorData()和setModelData()

2、给模型添加我们自己的代理类对象

 MapDelegate *delegate = new MapDelegate(this); // 生成自定义的代理类对象
 mapper->setItemDelegate(delegate); // 给模型添加我们自己的代理类

 void MapDelegate::setEditorData(QWidget *editor, const QModelIndex& index) const{
     if(index.column() == 0) // 假如模型的第0列为公司名
     {
         QComboBox *comboEditor = qobject_cast(editor);
         if (comboEditor)
         {
             int i = comboEditor->findText(index.model()->data(index, Qt::EditRole).toString()); // 在comboBox组件中查找model中的当前公司名
        comboEditor->setCurrentIndex(i); // 设成model中的当前公司名
         }
     }
     else
     {
         return QItemDelegate::setEditorData(editor, index);
     }
 }

 void MapDelegate::setModelData(QWidget *editor, QAbstractItemModel *model, const QModelIndex& index) const
 {
     if(index.column() == 0)
     {
         QComboBox *comboBox = qobject_cast(editor);
         if(comboBox)
         {
             model->setData(index, comboBox->currentText());
         }
     }
     else
     {
         return QItemDelegate::setModelData(editor, model, index);
     }
 }