QSqlQuery提供了执行SQL代码的方法。
QSqlQuery封装了在QSqlDatabase中查询、检索数据的相关函数。它可以用来执行如SELECT、INSERT、UPDATE、DELETE等方法,也可以执行如CREATE TABLE等语句。
顺利执行SQL语句后,调用isActive()就会返回true。一个激活的Query一定会产生一个合法的记录(isValid()返回true),从这个记录中可以提取到需要的数据。
对某些数据库而言,如果有一个诸如SELECT的Query是激活状态,那么当我们调用commit()、rollback()时,相关事务操作会失败。
历史查询记录可以通过如下函数进行查询:
next()、previous()、first()、last()、seek()
这些函数允许编辑器随意浏览上一个、下一个、任意一个查询记录。如果我们只需要往后查看结果(调用next()),那么可以调用setForwardOnly(),这样相比随机存储就可以存储大量信息,并且提高查询效率。
一旦一个激活的Query返回了一个合法记录,可以通过value()来提取其中的数据。所有SQL查询到的数据都是QVariant类型。
例如:
QSqlQuery query("SELECT country FROM artist"); while(query.next()){ QString country = query.value(0).toString(); doSomething(country); }
为了访问Query得到的数据,可以使用value( int )方法。Query的结果数据中,索引是从0开始的,因此调用SELECT *进行查询是不可用的,因为返回顺序是不确定的。
为了提高效率,不存在通过name访问数据的方法(除非预先在SELECT语句中通过names进行查询)。为了将数据name转换为索引,需要使用record().indexOf(),例如:
QSqlQuery query(SELECT * FROM artist); int fieldNo = query.record().indexOf("country"); while(query.next()){ QString country = query.value(fieldNo).toString; doSomething(country); }
调用numRowsAffected()可以知道有多少行是被非SELECT查询影响,调用size()可以知道有多少行是被SELECT查询影响的。
需要注意的是,在创建QSqlQuery之前,必须先加载SQL Driver并且构建连接。此外,当Query存在时,连接必须维持open状态,否则QSqlQuery的行为将不会执行。
预定义查询:实现定义好查询语句,但暂时并不执行,通常是因为其中的项没有设置,通常与占位符结合使用;
什么是带占位符的查询呢?就是在查询语句中,并不把语句写完整,而是某些地方填入占位符后,之后把占位符补充完整,就构成了一个完整的查询。就像下边这样:
query.prepare("INSERT INTO person (id, forename, surname) " "VALUES (:id, :forename, :surname)"); query.bindValue(":id", 1001); query.bindValue(":forename", "Bart"); query.bindValue(":surname", "Simpson"); query.exec();
QSqlQuery query; query.prepare("INSERT INTO person (id, forename, surname) " "VALUES (:id, :forename, :surname)"); query.bindValue(":id", 1001); query.bindValue(":forename", "Bart"); query.bindValue(":surname", "Simpson"); query.exec();
QSqlQuery query; query.prepare("INSERT INTO person (id, forename, surname) " "VALUES (:id, :forename, :surname)"); query.bindValue(0, 1001); query.bindValue(1, "Bart"); query.bindValue(2, "Simpson"); query.exec();
QSqlQuery query; query.prepare("INSERT INTO person (id, forename, surname) " "VALUES (?, ?, ?)"); query.bindValue(0, 1001); query.bindValue(1, "Bart"); query.bindValue(2, "Simpson"); query.exec();
QSqlQuery query; query.prepare("INSERT INTO person (id, forename, surname) " "VALUES (?, ?, ?)"); query.addBindValue(1001); query.addBindValue("Bart"); query.addBindValue("Simpson"); query.exec();
Header: | #include <QSqlQuery> |
qmake: | QT += sql |
QSqlQuery(QSqlQuery other) | 构造一个Query的副本 |
QSqlQuery(QSqlDatabase db) | 在db上构造一个Query,如果db不存在则用默认db |
QSqlQuery(QString query = QString(), QSqlDatabase db = QSqlDatabase()) |
用query和db构造一个Query,其中query是SQL语句对应的字符串 如果db为空或者非法,会使用默认db,如果query非空,那么在构造之后它会被执行 |
QSqlQuery(QSqlResult *result) | 用某个查询结果QSqlResult构造一个QSqlQuery |
类型 |
字段 |
取值 |
说明 |
enum | BatchExecutionMode | { ValuesAsRows, ValuesAsColumns } |
Constant | Value | Description |
---|---|---|
QSqlQuery::ValuesAsRows |
0 |
- Updates multiple rows. Treats every entry in a QVariantList as a value for updating the next row. |
QSqlQuery::ValuesAsColumns |
1 |
- Updates a single row. Treats every entry in a QVariantList as a single value of an array type. |
返回值类型 |
方法 |
说明 |
QSqlQuery & | operator=(QSqlQuery other) | 赋值 |
void | addBindValue(QVariant val, QSql::ParamType paramType = QSql::In) | 用于第四种情况的?占位符 |
int | at() |
返回当前查询到的记录的索引,第一个记录的索引为0 失败时返回一个负数 |
void |
bindValue(QString placeholder, QVariant val, QSql::ParamType paramType = QSql::In) bindValue(int pos,QVariant val, QSql::ParamType paramType = QSql::In) |
①、②、③中占位符,第一个参数是占位符,第二个参数是它的值 |
QVariant QVariant QMap<QString, QVariant> |
boundValue(QString placeholder) boundValue(int pos) boundValues() |
返回占位符对应的值 返回占位符及其值构成的QMap<QString , QVariant> |
void | clear() | 清除result集合,释放该Query占有的资源。设置Query状态为非激活,我们几乎不需要调用该方法。 |
QSqlDriver * | driver() | 该Query相关的driver |
bool |
exec(QString query) |
参数是一个SQL Query语句执行该语句。 Query成功时返回true,并设置query为激活状态。 当Query执行后,需要不断调用next()来让该Query定位到一个合法的记录处,之后才能提取数据。 当调用exec()时,该Query的last error将被重置。 例子: QSqlQuery query; query.exec("INSERT INTO employee (id, name, salary) " "VALUES (1001, 'Thad Beaumont', 65000)"); |
bool |
exec() |
执行用prepare()预定义的查询语句,成功时返回true。 执行时会重置该query的last error。 |
bool | execBatch(QSqlQuery::BatchExecutionMode mode = ValuesAsRows) |
|
QString | executedQuery() |
返回上一次成功执行的Query String。 如果是带占位符的预定义查询,会在占位符处填充真实值。 |
void | finish() |
告诉Driver不需要再从Query中查询数据了。 通常不需要调用该方法,但是在重用该Query前调用该方法会释放资源以保证资源安全。 设置Query为非激活状态,占位符绑定的值将会维持不变。 |
bool | first() |
提取Query结果的第一条记录,并将Query定位到该条记录上。 Query结果必须是激活状态,并且isSelect()必须返回true,之后才能调用该方法,否则将会返回false并不做任何事情。 |
bool | isActive() |
如果Query是激活状态则返回true。激活的Query是指成功调用了exec()并且没有调用finish()之前的Query。 完成查询之后,可以通过finish()或clear()修改Query为非激活状态,或者也能直接删除该QSqlQuery实例。 在提交、回滚事务之前,必须用以上方法来使Query变为非激活状态。 |
bool | isForwardOnly() | 如果只能在结果集中向前单向查询,返回true。 |
bool |
isNull(int field) isNull(QString name) |
以下几种情况返回true:1、Query未激活;2、Query未定位到一个合法记录上;3、结果上没有指定field;4、field是null。 |
bool | isSelect() | 如果当前Query是SELECT语句返回true |
bool | isValid() | 如果当前Query定位到一个合法记录上,返回true |
bool | last() | 定位当前Query到最后一条记录上。 |
QSqlError | lastError() | 返回该Query最近的错误信息 |
QVariant | lastInsertId() |
返回最近插入行对应的object ID。 失败时返回一个非法的QVariant。 如果一次插入了多行,结果将是Undefined。 |
QString | lastQuery() | 返回上一次查询语句,如果没有则返回空String。 |
bool | next() |
定位到查询结果的下一条记录上。 以下规则将会应用: ①如果当前定位到第一条记录之前——常用于执行后立即查询,那么结果会使Query定位到第一条记录; ②如果定位到最后一条记录,那么什么都不做并返回false; ③如果定位到中间,则定位到下一条记录。 |
bool | nextResult() | 删除当前记录并定位到下一条记录上。 |
int | numRowsAffected() |
返回SQL语句将会影响的行数,不确定时返回-1。 如果是SELECT语句,不能用该方法,应该用size()。 Query未激活时返回-1。 |
QSql::NumericalPrecisionPolicy | numericalPrecisionPolicy() | 返回当前的数字精度策略。 |
bool | prepare(QString query) | 预定义查询。 |
bool | previous() | 定位当前Query为上一条记录。 |
QSqlRecord | record() |
返回当前Query的结果QSqlRecord,其中包含了Query结果的字段信息。 如果Query指向一个合法的行,那么QSqlRecord将用指定行值填充,当Query未激活时,会返回一个空的记录。 为了从Query中提取值,调用基于索引的value()进行检索将会速度更快。 下边的例子中,使用了SELECT * FROM查询语句。由于结果列的顺序并不确定,所以通过QSqlRecord::indexOf()来获取这些列的索引: QSqlQuery q("select * from employees"); QSqlRecord rec = q.record(); qDebug() << "Number of columns: " << rec.count(); int nameCol = rec.indexOf("name"); // index of the field "name" while (q.next()) qDebug() << q.value(nameCol).toString(); // output all names |
QSqlResult * | result() | 返回该Query的Result |
bool | seek(int index, bool relative = false) | 定位到指定记录处,第二个参数指定相对、绝对偏移,即以当前位置为基准还是以开头为基准。 |
void | setForwardOnly(bool forward) |
只允许前向查询。当forward为true时,next()、seek()方法只能用正数。 这个方法应当在Query exec前主动调用,默认情况下前向查询是未激活的。 |
void | setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy) | 设置数值精度 |
int | size() |
返回查询结果的size,即行数。失败时返回-1。 非SELECT语句会返回-1,应该调用numRowsAffected()。 |
QVariant |
value(int index) value(QString name) |
返回当前记录中,索引字段index的值,一个字段就是一列,索引从0开始。不推荐使用SELECT *因为字段顺序会被打乱。失败时返回一个非法QVariant。 用列名的方式访问当前记录中某个字段的值。 |