【QT】-- QT操作数据库

前言：

Qt是C++一个开发框架，具有跨平台特性。
这篇是作者大二学习的时候做的笔记，有可能有错误，请各位批评指正。
这篇记录QT操作数据库。
欢迎大家收藏 + 关注，作者将会持续更新。

文章目录

[Qt 操作数据库](#Qt 操作数据库)

Qt 操作数据库

Qt 框架中对数据库操作提供了很好的支持，我们可以通过 Qt 提供的类非常方便地和本地或者远程数据库进行连接。

QSqlDatabase

连接数据库

数据库连接

通过调用一个静态addDatabase()函数创建一个连接，在该函数中指定要使用的驱动程序或驱动程序类型。连接可以通过它自己的名称而不是它所连接的数据库的名称得知。

可以有一个或多个数据库的连接。 QSqlDatabase还支持默认连接的概念，即未命名连接。 要创建默认连接，在调用addDatabase()时不要传递连接名称参数。

默认连接

下面的代码片段展示了如何创建和打开到Sqlite数据库的默认连接:

cpp 复制代码

//Qt会自动保存起来，在需要的地方直接获取即可
auto db = QSqlDatabase::addDatabase("QSQLITE");  //1、添加数据库
bool ok = db.open();			//打卡数据库，open(".......dp")
if(!ok)
{
      qWarning() << "数据库连接失败~" << db.lastError().databaseText();
      return;
}

创建QSqlDatabase对象之后，使用etDatabaseName()、setUserName()、setPassword()、setHostName()、setPort()和setConnectOptions()设置连接参数。然后调用open()来激活到数据库的物理连接(当然Sqlite只需要设置一个数据库名即可，其他的也能设置，但是无效)。

命名连接

如果创建多个数据库连接，在调用addDatabase()时为每个连接指定唯一的连接名。使用带有连接名的database()来获取该连接。使用removeDatabase()``和连接名一起删除连接。如果您试图删除由其他QSqlDatabase对象引用的连接，QSqlDatabase将输出一个警告。使用contains()查看给定的连接名是否在连接列表中。

cpp 复制代码

//2、命名连接
auto db = QSqlDatabase::addDatabase("QSQLITE","sql_mycon_1");

//3、根据连接名获取连接,不是 add
auto db = QSqlDatabase::database("sql_mycon_1");		//可以在不同地方调用不同数据库

实用函数

一旦连接成功，就可以操作数据库了，可以使用QSqlDatabase的一些函数操作。

获取所有表

如果你想要查看当前数据库的所有表，可以使用 QStringList tables() const函数获取。

cpp 复制代码

qInfo() << db.tables()

获取表字段

知道了当前数据库有哪些表之后，就可以使用QSqlRecord record(const QString &tablename) const查看指定表的字段信息。

cpp 复制代码

qInfo() << db.record("emp");

QSqlQuery

Sql查询

执行SQL语句

QSqlQuery封装了从在QSqlDatabase上执行的SQL查询中创建、导航和检索数据所涉及的功能。它可以用于执行DML(数据操作语言)语句，如SELECT、INSERT、UPDATE和DELETE，也可以用于执行DDL(数据定义语言)语句，如CREATE TABLE。

一些常用函数。

cpp 复制代码

bool next()					//检索结果中的下一条记录(如果可用)，并在检索的记录上定位查询。
bool previous()				//检索结果中的前一条记录(如果可用)，并将查询定位于检索的记录上。  
bool first()				//检索结果中的第一条记录(如果可用)，并在检索的记录上定位查询。  
bool last()					//检索结果中的最后一条记录(如果可用)，并在检索的记录上定位查询  
bool seek()  				//在位置索引处检索记录(如果可用)，并在检索的记录上定位查询。 第一条记录位于位置0。
int at() const				//返回查询的当前内部位置。 如果位置无效，函数返回特殊的负值QSql::BeforeFirstRow或QSql::AfterLastRow。

例如：

cpp 复制代码

QSqlQuery query("SELECT ename FROM emp",QSqlDatabase::database("如果有你指定了命名连接，则需要在这指定"));
while (query.next()) 
{
      QString ename = query.value(0).toString();
      QString ename = query.value("ename").toString();
      qDebug()<< ename;
}

要访问查询返回的数据 ，请使用value(int i)。通过从0开始传递字段在语句中的位置来访问SELECT语句返回的数据中的每个字段。

下面代码片段可以获取指定表的所有记录：

cpp 复制代码

QSqlQuery query("SELECT * FROM emp");
auto recordCnt = query.record().count();
while (query.next())
{
     for (int i = 0;i < recordCnt;i++)
     {
         QString ename = query.value(i).toString();
         std::cout<< ename.toStdString()<<std::endl;
     }
     std::cout<<std::endl;
 }

获取SQL语句查询到的记录条数

cpp 复制代码

int QSqlQuery::size() const

size()用来获取SELECT语句查询到的记录条数。如果大小无法确定或数据库不支持报告有关查询大小的信息，则返回-1。

获取SQL语句影响的行数

cpp 复制代码

int QSqlQuery::numRowsAffected() const

numRowsAffected()返回受结果的SQL语句影响的行数，如果不能确定，则返回-1。

SQL准备语句

经过测试SQLite不支持，Mysql支持

QSqlQuery支持预先准备的查询执行和将参数值绑定到占位符。

Oracle数据库使用冒号语法识别占位符，例如:name。
ODBC仅仅使用? 字符。

Qt支持这两种语法，只是不能将它们混合在同一个查询中。

命名占位符

使用命名占位符的命名绑定：

cpp 复制代码

//语法 冒号+名字(:name)
QSqlQuery query;
query.prepare("INSERT INTO user (id, username, nickname)"
               "VALUES (:id, :username, :nickname)");
query.bindValue(":id",520);
query.bindValue(":username","maye");
query.bindValue(":nickname","顽石");
query.exec();

使用命名占位符的位置绑定：

cpp 复制代码

QSqlQuery query;
query.prepare("INSERT INTO user (id, username, nickname)"
               "VALUES (:id, :username, :nickname)");
//默认从0开始，也可不用写数字,addBindValue
query.bindValue(0,520);
query.bindValue(1,"maye");
query.bindValue(2,"顽石");
query.exec();

位置占位符

使用位置占位符绑定值(版本1)：

cpp 复制代码

QSqlQuery query;                                         
query.prepare("INSERT INTO user (id, username, nickname)"  
           "VALUES (?,?,?)");                              
query.bindValue(0,520);                                    
query.bindValue(1,"maye");                                 
query.bindValue(2,"顽石");                                   
query.exec();

使用位置占位符绑定值(版本2)：

cpp 复制代码

QSqlQuery query;                                       
query.prepare("INSERT INTO user (id, username, nickname)"
           "VALUES (?,?,?)");                            
query.addBindValue(520);                                 
query.addBindValue("maye");                              
query.addBindValue("顽石");                                
query.exec();

批量执行

在批处理中执行先前准备的SQL查询。所有绑定参数都必须是变量列表。

cpp 复制代码

QSqlQuery q;
q.prepare("insert into stu values (?,?,?)");

QVariantList names = QVariantList() << "Maye" << "young" << "百毒不侵" << "落笔不打";
q.addBindValue(names);

QVariantList ages = QVariantList << 26 << 36 << 46 << 56;
q.addBindValue(ages);

QVariantList scores = QVariantList << 89 << 69.9 << 79.9 << QVariant(QVariant::Float);//最后插入一个NULL
q.addBindValue(scores);

if (!q.execBatch())
   qDebug() << q.lastError();

QSqlRecord

**QSqlRecord类封装了数据库记录(通常是数据库中的表或视图中的一行)的功能和特征。 QSqlRecord支持添加和删除字段，以及设置和检索字段值。 **

使用setValue()可以通过名称或位置设置记录字段的值; 要按名称查找字段的位置，使用indexOf()，要在特定位置查找字段的名称，使用fieldName()。使用field()检索给定字段的QSqlField对象。使用contains()查看记录是否包含特定的字段名。

cpp 复制代码

QSqlRecord rec = db.record("emp");
for (int i=0;i<rec.count();i++)
{
     qDebug()<<rec.fieldName(i)<<rec.value(i);
}

QSqlField

表的字段

QSqlField表示数据库表或视图中单个列的特征，例如数据类型和列名。字段还包含数据库列的值，可以查看或更改该值。

字段数据值存储为qvariant。不允许使用不兼容的类型。例如:

cpp 复制代码

QSqlField field("age", QVariant::Int);
field.setValue(QPixmap());  // WRONG

很少在应用程序代码中显式创建QSqlField对象。它们通常通过已经包含字段列表的QSqlRecords间接访问。例如:

cpp 复制代码

QSqlQuery query;
...
QSqlRecord record = query.record();
QSqlField field = record.field("country");  // 简介

数据库模型

QSqlQueryModel

QSqlQueryModel类为SQL结果集提供了只读数据模型。

QSqlQueryModel是执行SQL语句和遍历结果集的高级接口 。它构建在较低级别的QSqlQuery之上，可用于向视图类(如QTableView)提供数据。

cpp 复制代码

QSqlQueryModel *sqlQueryModel = new QSqlQueryModel(this);
sqlQueryModel->setQuery("select * from user",database);

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

QSqlQueryModel也可以用于通过编程方式访问数据库，而无需将其绑定到视图:

cpp 复制代码

QSqlQueryModel model;
model.setQuery("SELECT username,nickname FROM user");
QString nickname = model.record(4).value("nickname").toInt();

QSqlTableModel

QSqlTableModel类为单个数据库表提供了一个可编辑的数据模型

QSqlTableModel是一个高级接口，用于从单个表中读写数据库记录。可用于向视图类(如QTableView)提供数据。

例如:

cpp 复制代码

//构造时指定数据库，如果使用默认连接则不需要指定
QSqlTableModel* sqltableModel = new QSqlTableModel(this,database);
//设置需要查询的表名
sqltableModel->setTable("freecustomers");	
//设置在视图中编辑值时选择的策略。  OnManualSubmit手动提交
sqltableModel->setEditStrategy(QSqlTableModel::EditStrategy::OnManualSubmit);
//使用指定的过滤器和排序条件，用setTable()设置的表中的数据填充模型，如果成功则返回true; 否则返回false。  
sqltableModel->select();
//设置表头数据
sqltableModel->setHeaderData(0,Qt::Horizontal,"ID");
sqltableModel->setHeaderData(1,Qt::Horizontal,"QQ");
sqltableModel->setHeaderData(2,Qt::Horizontal,"电话");

QTableView * tableView = new QTableView;
tableView->setModel(sqltableModel);
tableView->hideColumn(0);	//隐藏ID
tableView->show();

其他函数

cpp 复制代码

//还原指定行的更改
virtual void revertRow(int row)
////设置在视图中编辑值时选择的策略。    
virtual void setEditStrategy(QSqlTableModel::EditStrategy strategy)
//将当前筛选器设置为筛选器。这个过滤器是一个没有关键字WHERE的SQL WHERE子句(例如，name='Josephine')。      
virtual void setFilter(const QString &filter)
//设置一条记录到指定行，记录顺序可以随意，会自动映射    
bool setRecord(int row, const QSqlRecord &values)
bool insertRecord(int row, const QSqlRecord &record)    

//将列的排序顺序设置为order。 这不会影响当前数据，要使用新的排序顺序刷新数据，调用select()。（在查询之前设置即可）     
virtual void setSort(int column, Qt::SortOrder order)
//将模型操作的数据库表设置为tableName。 如果设置之后不调用select，那么将获取表的字段信息，要获取数据，必须调用select      
virtual void setTable(const QString &tableName)
//获取表名    
QString tableName() const
//获取一条空记录，只有字段名。 此函数可用于检索记录的字段名。    
QSqlRecord record() const
//获取指定行的记录，如果row是有效行的索引。  如果模型没有初始化，将返回一个空记录。 
QSqlRecord record(int row) const    
//返回当前表的主键，如果表没有设置或没有主键，则返回空QSqlIndex。  
QSqlIndex primaryKey() const    
//如果模型包含未提交到数据库的修改值，则返回true，否则返回false。  
bool isDirty(const QModelIndex &index) const
bool isDirty() const

slots

cpp 复制代码

//当用户取消编辑当前行时，项目委托将调用这个重新实现的槽。  如果模型的策略设置为OnRowChange或OnFieldChange，则恢复更改。 对OnManualSubmit策略不做任何操作。  使用revertAll()来恢复OnManualSubmit策略的所有挂起的更改，或使用revertRow()来恢复特定的行。  
virtual void revert() override
//恢复所有待提交的更改
void revertAll();
//使用指定的过滤器和排序条件，用setTable()设置的表中的数据填充模型，如果成功则返回true; 否则返回false。      
virtual bool select();
//刷新某一行，按主键匹配，如果没有主键，那么每一个字段都必须对应(重新从数据库中查询一行)    
virtual bool selectRow(int row);
//使用submitAll()提交OnManualSubmit策略中所有挂起的更改。  成功返回true; 否则返回false。 使用lastError()查询详细的错误信息。  不会自动重新填充模型。 成功时将从数据库刷新提交的行。      
virtual bool submit() override
//提交所有挂起的更改并在成功时返回true。 错误返回false，详细的错误信息可以通过lastError()获得。
    
bool submitAll();

signals

cpp 复制代码

//在删除某一行之前会发出这个信号
void beforeDelete(int row);
//在插入某一条记录之前会发出这个信号，可以在插入之前修改记录 
void beforeInsert(QSqlRecord &record);
//在更新某一行记录之前发出此信号。    
void beforeUpdate(int row, QSqlRecord &record);
//准备插入一条记录是时，insertRows()将发出此信号。 可以将记录参数写入，例如用默认值填充某些字段，并设置字段的生成标志
void primeInsert(int row, QSqlRecord &record);

QSqlRelationalTableModel

QSqlRelationalTableModel的作用类似于QSqlTableModel，但允许将列设置为其他数据库表的外键。

cpp 复制代码

QSqlRelationalTableModel* relationalModel = new QSqlRelationalTableModel(this,database);
relationalModel->setTable("student");
relationalModel->setRelation(1,QSqlRelation("course","cno","cname"));
relationalModel->select();

调用setRelation()函数建立两个表之间的关系。

其他函数

cpp 复制代码

//设置SQL joinMode以显示或隐藏具有NULL外键的行。 在InnerJoin模式(默认)中，这些行不会显示:如果您想显示它们，请使用LeftJoin模式。  
void setJoinMode(QSqlRelationalTableModel::JoinMode joinMode)
//让指定的列是relation指定的外部索引。     
virtual void setRelation(int column, const QSqlRelation &relation)