首页 > 代码库 > QT开发（四十八）——数据库SQL接口层
QT开发（四十八）——数据库SQL接口层
QT开发（四十八）——数据库SQL接口层
SQL接口层提供了对数据库的访问，主要类包括Qt SQL模块中的QSqlDatabase、QSqlQuery、QSqlError、QSqlField、QSqlIndex和QSqlRecord。QSqlDatabase类用于创建数据库连接，QSqlQuery用于使用SQL语句实现与数据库交互。
一、QSqlDatabase
1、QSqlDatabase简介
QSqlDatabase类提供了通过连接访问数据库的接口，QSqlDatabase对象本身代表一个连接，连接通过QT支持的数据库驱动提供对数据库的访问。
2、QSqlDatabase成员函数
QSqlDatabase::QSqlDatabase(const QSqlDatabase &other)
[protected] QSqlDatabase::QSqlDatabase(const QString &type)
[protected] QSqlDatabase::QSqlDatabase(QSqlDriver *driver)
使用给定的驱动创建一个数据库连接
[static] QSqlDatabase QSqlDatabase::addDatabase(const QString &type, const QString &connectionName = QLatin1String( defaultConnection ))
根据给定的数据库驱动类型type、数据库连接名connectionName 创建一个数据库连接，如果有已经存在的同名连接，则新建立连接替换旧连接；如果没有指定数据库连接名，则新建立的数据库连接将成为应用程序的默认连接。
[static] QSqlDatabase QSqlDatabase::addDatabase(QSqlDriver *driver, const QString &connectionName = QLatin1String( defaultConnection ))
根据给定的数据库驱动driver、连接名connectionName 创建数据库连接
[static] QSqlDatabase QSqlDatabase::cloneDatabase(const QSqlDatabase &other, const QString &connectionName)
根据数据库连接other克隆创建一个名字为connectionName的数据库连接
void QSqlDatabase::close()
关闭数据库连接，释放申请的任何资源，数据库使用的任何QSqlQuery对象将无效
bool QSqlDatabase::commit()
如果数据库驱动支持事务机制并且已经启动，提交事务给数据库。对于某些数据库，如果有一个使用数据库的活跃查询SELECT，提交将会失败，返回false。在提交前需要确保查询不在活跃。
QString QSqlDatabase::connectOptions() const
返回连接选项使用的字符串
QString QSqlDatabase::connectionName() const
返回连接名
[static] QStringList QSqlDatabase::connectionNames()
返回包含所有连接的名字的链表
[static] bool QSqlDatabase::contains(const QString &connectionName = QLatin1String( defaultConnection ))
如果数据库连接的链表中包含connectionName 连接，返回true
[static] QSqlDatabase QSqlDatabase::database(const QString &connectionName = QLatin1String( defaultConnection ), bool open = true)
返回名字为connectionName 的数据库连接。数据库连接需事先添加，如果open为true，并且数据库连接没有打开，则调用本函数时打开连接。如果connectionName没有指定，返回默认的链接；如果connectionName不存在数据库链表中，返回非法的链接
QString QSqlDatabase::databaseName() const
返回连接的数据库名字
QSqlDriver *QSqlDatabase::driver() const
返回用于数据库连接访问的数据库驱动
QString QSqlDatabase::driverName() const
返回连接的驱动名字
[static] QStringList QSqlDatabase::drivers()
返回所有可用的数据库驱动的链表
QSqlQuery QSqlDatabase::exec(const QString &query = QString()) const
在数据库执行一条SQL语句query，返回QSqlQuery对象
QString QSqlDatabase::hostName() const
返回连接的主机名
[static] bool QSqlDatabase::isDriverAvailable(const QString &name)
如果驱动name可用，返回true
bool QSqlDatabase::isOpen() const
如果数据库连接目前打开，返回true
bool QSqlDatabase::isOpenError() const
如果在打开数据库连接时发生错误，返回true
bool QSqlDatabase::isValid() const
如果QSqlDatabase连接有一个合法的驱动，返回true
QSqlError QSqlDatabase::lastError() const
返回数据库发生的最后一个错误的信息
QSql::NumericalPrecisionPolicy QSqlDatabase::numericalPrecisionPolicy() const
返回数据库连接当前的默认精度策略
bool QSqlDatabase::open()
使用当前的连接值打开数据库连接
bool QSqlDatabase::open(const QString &user, const QString &password)
使用给定的用户名和密码打开数据库连接
QString QSqlDatabase::password() const
返回数据库连接的密码
int QSqlDatabase::port() const
返回数据库连接的端口号
QSqlRecord QSqlDatabase::record(const QString &tablename) const
返回表tablename中所有字段的名字的记录
[static] void QSqlDatabase::registerSqlDriver(const QString &name, QSqlDriverCreatorBase *creator)
在SQL框架内注册新的名字为name的SQL驱动
[static] void QSqlDatabase::removeDatabase(const QString &connectionName)
从数据库连接链表中删除名字为connectionName的数据库连接
bool QSqlDatabase::rollback()
中止数据库上的一件事务
void QSqlDatabase::setConnectOptions(const QString &options = QString())
设置数据库指定选项，必须在连接打开之前或是连接失效时完成
void QSqlDatabase::setDatabaseName(const QString &name)
设置连接的数据库名字为name，为了生效，必须在连接被打开前设置。
void QSqlDatabase::setHostName(const QString &host)
设置连接的主机名为host，为了生效，必须在连接被打开前设置。
void QSqlDatabase::setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)
在创建的数据库连接上设置默认的数字精度策略，用于查询。在当前活跃的查询上设置将无效
void QSqlDatabase::setPassword(const QString &password)
设置连接的密码，需要在连接打开前设置
void QSqlDatabase::setPort(int port)
设置连接的端口号，需要在连接打开前设置
void QSqlDatabase::setUserName(const QString &name)
设置连接的用户名，需要在连接打开前设置
QStringList QSqlDatabase::tables(QSql::TableType type = QSql::Tables) const
返回由type指定的数据库的表、系统表和视图的链表
bool QSqlDatabase::transaction()
如果数据库驱动支持事务机制，在数据库上开始一个事务
QString QSqlDatabase::userName() const
返回连接的用户名
二、QSqlQuery
1、QSqlQuery简介
QSqlQuery类提供了执行、操作SQL语句的一种手段。QSqlQuery封装了涉及创建、导航和通过连接执行SQL查询语句获取数据的功能。QSqlQuery能用于执行DML语句（如SELECT、INSERT、UPDATE、DELETE）和DDL语句（如CREATE TABLE），也能够用于执行非标准SQL的特定数据库的命令（如PostgreSQL语句：SET DATESTYLE=ISO）。
执行SQL语句成功会设置QSqlQuery对象的状态为活跃，否则设置为非活跃。无论哪种情况，当执行一条新的SQL语句时，查询都被定位在一条无效的记录上。在数据被获取前，一个活跃的查询必须被导航到一条有效的记录上。
2、QSqlQuery成员函数
QSqlQuery::QSqlQuery(QSqlResult *result)
使用result构建一个QSqlQuery对象
QSqlQuery::QSqlQuery(const QString &query = QString(), QSqlDatabase db = QSqlDatabase())
使用SQL语句query、数据库db构建一个QSqlQuery对象，如果数据库db为指定、非法，使用应用程序默认的数据库
QSqlQuery::QSqlQuery(QSqlDatabase db)
QSqlQuery::QSqlQuery(const QSqlQuery &other)
void QSqlQuery::addBindValue(const QVariant &val, QSql::ParamType paramType = QSql::In)
当使用位置值绑定时，增加val到值链表中
int QSqlQuery::at() const
返回查询的当前内部位置
void QSqlQuery::bindValue(const QString &placeholder, const QVariant &val, QSql::ParamType paramType = QSql::In)
将值val绑定到占位符placeholder
void QSqlQuery::bindValue(int pos, const QVariant &val, QSql::ParamType paramType = QSql::In)
QVariant QSqlQuery::boundValue(const QString &placeholder) const
QVariant QSqlQuery::boundValue(int pos) const
QMap<QString, QVariant> QSqlQuery::boundValues() const
void QSqlQuery::clear()
清除结果集，释放查询占用的任何资源。设置查询状态到非活跃
const QSqlDriver *QSqlQuery::driver() const
返回查询关联的数据库的驱动
bool QSqlQuery::exec(const QString &query)
执行SQL语句query，查询执行成功时，返回true，设置查询为活跃状态
在查询执行后，查询定位在一个无效的记录上，在获取数据值前必须把查询移动到有效的记录上。对于SQLite数据库，query字符串每次只能包含一条语句。
bool QSqlQuery::exec()
执行一条事先准备的SQL语句
bool QSqlQuery::execBatch(BatchExecutionMode mode = ValuesAsRows)
批处理执行事先准备的SQL查询语句
QString QSqlQuery::executedQuery() const
返回最后成功执行的查询语句
bool QSqlQuery::first()
如果结果集可用，查询的位置在获取记录的查询上，则获取结果集中的第一条记录
bool QSqlQuery::isActive() const
如果查询处于活跃状态，返回true
bool QSqlQuery::isSelect() const
如果当前查询是一条SELECT语句，返回true
bool QSqlQuery::isValid() const
如果查询的当前定位在有效的记录上，返回true
QSqlError QSqlQuery::lastError() const
返回查询发生的最后一次错误的错误信息
bool QSqlQuery::next()
如果查询可用，并且定位在获取的记录上，获取结果中的下一条记录
bool QSqlQuery::prepare(const QString &query)
事先准备要执行的SQL语句
bool QSqlQuery::previous()
如果查询可用，并且定位在获取的记录上，则获取结果中的前一条记录
QSqlRecord QSqlQuery::record() const
返回当前查询的包含字段信息的一条记录
QVariant QSqlQuery::value(int index) const
返回当前记录中index字段的值
QVariant QSqlQuery::value(const QString &name) const
返回当前记录中字段名为name的字段的值
3、操作结果集
使用QSqlQuery对象执行SQL语句查询操作得到的所有记录是一个结果集，QSqlQuery类提供了多个函数来处理得到的结果集。通常结果集中的记录从0开始。
bool seek(int index, bool relative = false)query指向结果集的第n条记录
bool first()query指向结果集的第一条记录
bool last()query指向结果集的最后一条记录
bool next()query指向下一条记录，每执行一次函数，便指向相邻的下一条记录
bool previous()query指向上一条记录，每执行一次函数，便指向相邻的上一条记录
QSqlRecord record() const获得现在指向的记录
QVariant value(int index) const获得记录中第n个属性的值
int at() const获得现在query指向的记录在结果集中的编号
执行完query.exec("select *from student");代码时，query是指向结果集外的，可以利用query.next()使得query指向结果集的第一条记录。也可以利用seek(0)函数或者first()函数使query指向结果集的第一条记录。为了节省内存开销，推荐的方法是，在query.exec("select * from student");代码前加上query.setForwardOnly(true);代码，此后只能使用next()和seek()函数。
query.exec("select * from student");
query.next();
QString name = query.value(1).toString();
qDebug() << name;
query.first();
name = query.value(1).toString();
qDebug() << name;
通过对结果集的记录的逐条遍历，可以操作数据库中的数据项。
4、批处理操作
当要进行多条记录的操作时，可以利用绑定进行批处理。
QSqlQuery query;
query.prepare("insert into student values (?, ?)");
QVariantList ints;
ints << 10 << 11 << 12 << 13;
query.addBindValue(ints);
QVariantList names;
names << "xiaoming" << "xiaoliang"
<< "xiaogang" << QVariant(QVariant::String);
query.addBindValue(names);
if (!query.execBatch())
qDebug() << query.lastError();
5、事务操作
事务可以保证一个复杂操作的原子性。在QT中，如果底层的数据库引擎支持事务，那么QSqlDriver::hasFeature(QSqlDriver::Transactions)会返回true。可以使用QSqlDatabase::transaction()来启动一个事务，然后编写一些希望在事务中执行的SQL语句，最后调用QSqlDatabase::commit()或者QSqlDatabase::rollback()。当使用事务时必须在创建查询以前就开始事务。
QSqlDatabase::database().transaction();
QSqlQuery query1;
query1.exec("select * from student");
query1.next();
QString name = query1.value(1).toString();
qDebug() << name;
query1.first();
name = query1.value(1).toString();
qDebug() << name;
QSqlDatabase::database().commit();
三、QSqlRecord
1、QSqlRecord简介
QSqlRecord封装了数据库记录的功能和特性，支持增加和删除字段以及设置和获取字段值。
记录的字段的值可以由名字和位置使用setValue函数设置。如果将字段社会中为空，使用setNull函数。通过字段名字使用indexOf函数可以找到字段的位置。通过特定的位置使用fieldName函数可以找到字段名字。使用field（）函数获取给定字段的QSqlField对象。
2、QSqlRecord成员函数
QSqlRecord::QSqlRecord()
QSqlRecord::QSqlRecord(const QSqlRecord &other)
构造函数
void QSqlRecord::append(const QSqlField &field)
在记录尾部增加一个字段field
void QSqlRecord::clear()
删除记录的所有字段
void QSqlRecord::clearValues()
清除记录中所有字段的值并设置为空
bool QSqlRecord::contains(const QString &name) const
如果记录中包含name字段，返回true
int QSqlRecord::count() const
返回记录中的字段的数量
QSqlField QSqlRecord::field(int index) const
返回记录中位置为index的字段，如果index超出范围，返回默认构造值
QSqlField QSqlRecord::field(const QString &name) const
返回记录中字段名为name的字段
QString QSqlRecord::fieldName(int index) const
返回记录中位置为index的字段的名字
int QSqlRecord::indexOf(const QString &name) const
返回记录中字段名字为name的字段的位置，没有此字段则返回-1，字段名大小写不敏感，有多个匹配则返回第一个匹配的
void QSqlRecord::insert(int pos, const QSqlField &field)
在记录中的位置pos插入字段field
bool QSqlRecord::isEmpty() const
记录中的无字段，返回true
void QSqlRecord::remove(int pos)
返回记录中位置为pos的字段
void QSqlRecord::replace(int pos, const QSqlField &field)
使用给定字段field替换记录中的位置为pos的字段
void QSqlRecord::setValue(int index, const QVariant &val)
设置记录中位置为index的字段的值为val
void QSqlRecord::setValue(const QString &name, const QVariant &val)
设置记录中名字为name的字段的值为val
QVariant QSqlRecord::value(int index) const
返回记录中位置为index的字段的值
QVariant QSqlRecord::value(const QString &name) const
返回记录中字段名为name的字段的值
void QSqlRecord::setNull(const QString &name)
设置记录中字段名为name的字段的值为null
void QSqlRecord::setNull(int index)
设置记录中位置为index的字段的值为null
四、QSqlField
1、QSqlField简介
QSqlField用于操作SQL数据库中表和视图的字段。
QSqlField代表数据库中表和视图中一列的特性，如数据类型和列名。字段也包含数据库中列中的值。字段的数据值存储在QVariant变量中，使用不兼容的数据类型是不允许的。
QSqlField对象很少在应用程序代码中显示创建，通常通过包含字段链表的QSqlRecord对象直接访问。
QSqlField对象能提供字段的很多元数据，如字段的名字、数据类型、长度、精度、默认值等。
2、QSqlField成员函数
QSqlField::QSqlField(const QString &fieldName = QString(), QVariant::Type type = QVariant::Invalid)
构造一个名字为fieldName、数据类型为type的空字段
QSqlField::QSqlField(const QSqlField &other)
void QSqlField::clear()
清除字段的值并设置为空
QVariant QSqlField::defaultValue() const
返回字段的默认值
bool QSqlField::isAutoValue() const
如果字段的值字段生成，返回true。如主键的值自动增加
bool QSqlField::isNull() const
如果字段的值为null，返回true
bool QSqlField::isReadOnly() const
如果字段的值为只读类型，返回true
bool QSqlField::isValid() const
如果字段的变量类型合法，返回true
int QSqlField::length() const
返回字段的长度
QString QSqlField::name() const
返回字段的名字
int QSqlField::precision() const
返回字段的精度，只在数字类型时有意义
void QSqlField::setAutoValue(bool autoVal)
autoVal为真时设置字段的值自动生成
void QSqlField::setDefaultValue(const QVariant &value)
设置字段中默认的值为value
void QSqlField::setLength(int fieldLength)
设置字段的长度为fieldLength
void QSqlField::setName(const QString &name)
设置字段名为name
void QSqlField::setPrecision(int precision)
设置字段精度为precision，只对数字字段有效
void QSqlField::setReadOnly(bool readOnly)
设置字段值的只读标识为readOnly。
void QSqlField::setType(QVariant::Type type)
设置字段的数据变量类型为type
void QSqlField::setValue(const QVariant &value)
设置字段的值为value
QVariant::Type QSqlField::type() const
返回存储在数据中的字段的数据类型
QVariant QSqlField::value() const
返回字段的值
五、QSqlIndex
1、QSqlIndex简介
QSqlIndex类提供了操作和描述数据库索引的函数。
2、QSqlIndex成员函数
QSqlIndex::QSqlIndex(const QString &cursorname = QString(), const QString &name = QString())
QSqlIndex::QSqlIndex(const QSqlIndex &other)
构造函数
void QSqlIndex::append(const QSqlField &field)
追加一个字段field到字段链表中，默认按升序排序
void QSqlIndex::append(const QSqlField &field, bool desc)
void QSqlIndex::setName(const QString &name)
设置索引的名字为name
void QSqlIndex::setDescending(int i, bool desc)
desc为true时，索引i的字段按降序存储
六、QSqlError
1、QSqlError简介
QSqlError类提供类SQL数据的错误信息。QSqlError对象能够提供数据库具体的错误数据。
2、QSqlError成员函数
QSqlError::QSqlError(const QString &driverText = QString(), const QString &databaseText = QString(), ErrorType type = NoError, const QString &code = QString())
构造一个包含驱动错误文本driverText、数据库具体错误文本databaseText、类型type和错误码code的QSqlError对象
QSqlError::QSqlError(const QSqlError &other)
QString QSqlError::databaseText() const
返回数据库报告的错误文本
QString QSqlError::driverText() const
返回数据库驱动报告的错误文本
bool QSqlError::isValid() const
如果设置了错误，返回true
QString QSqlError::nativeErrorCode() const
返回数据库具体错误码
ErrorType QSqlError::type() const
返回错误类型
本文出自 “生命不息，奋斗不止” 博客，谢绝转载！
QT开发（四十八）——数据库SQL接口层