【Qt】Qt数据库驱动层-卡核

00. 目录

文章目录

01. Qt驱动层

驱动层为具体的数据库和SQL接口层之间提供了底层的桥梁，主要类包括QSqlDriver、QSqlDriverCreator、QSqlDriverCreatorBase、QSqlDriverPlugin和QSqlResult。

02. QSqlDriver

QSqlDriver是访问具体SQL数据库的抽象基类，不能直接使用。如果要创建自定义的数据库驱动，可以根据需要重写QSqlDriver类的纯虚函数和虚函数。

该类不能直接使用，如果要使用使用QSqlDatabase代替。

QSqlDatabase负责加载和管理数据库驱动插件。当某个数据库添加时，相应的数据库驱动插件会被加载。QSqlDatabase依靠驱动插件为QSqlDriver和QSqlResult提供接口。

QSqlDriver是定义了SQL数据库功能的抽象基类。

公有成员方法

QSqlDriver(QObject *parent = nullptr)
virtual	~QSqlDriver()
virtual bool	beginTransaction()
virtual void	close() = 0
virtual bool	commitTransaction()
virtual QSqlResult *	createResult() const = 0
virtual QString	escapeIdentifier(const QString &identifier, QSqlDriver::IdentifierType type) const
virtual QString	formatValue(const QSqlField &field, bool trimStrings = false) const
virtual QVariant	handle() const
virtual bool	hasFeature(QSqlDriver::DriverFeature feature) const = 0
virtual bool	isIdentifierEscaped(const QString &identifier, QSqlDriver::IdentifierType type) const
virtual bool	isOpen() const
bool	isOpenError() const
QSqlError	lastError() const
QSql::NumericalPrecisionPolicy	numericalPrecisionPolicy() const
virtual bool	open(const QString &db, const QString &user = QString(), const QString &password = QString(), 
const QString &host = QString(), int port = -1, const QString &options = QString()) = 0
virtual QSqlIndex	primaryIndex(const QString &tableName) const
virtual QSqlRecord	record(const QString &tableName) const
virtual bool	rollbackTransaction()
void	setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)
virtual QString	sqlStatement(QSqlDriver::StatementType type, const QString &tableName, const QSqlRecord &rec, 
bool preparedStatement) const
virtual QString	stripDelimiters(const QString &identifier, QSqlDriver::IdentifierType type) const
virtual bool	subscribeToNotification(const QString &name)
virtual QStringList	subscribedToNotifications() const
virtual QStringList	tables(QSql::TableType tableType) const
virtual bool	unsubscribeFromNotification(const QString &name)

03. QSqlDriverCreator

QSqlDriverCreator是为指定驱动类型提供SQL驱动工厂的模板类。QSqlDriverCreator实例化对象的类型T就是QSqlDriver的子类。

成员方法：

[override virtual] QSqlDriver *QSqlDriverCreator::createObject() const
Reimplemented from QSqlDriverCreatorBase::createObject().

04. QSqlDriverCreatorBase

QSqlDriverCreatorBase是SQL驱动工厂的基类。

重新实现createObject()以返回要提供的特定QSqlDriver子类的实例。

成员方法:

virtual ~QSqlDriverCreatorBase()
virtual QSqlDriver *createObject() const = 0

05. QSqlDriverPlugin

QSqlDriverPlugin类提供自定义QSqlDriver插件的抽象基类。

SQL数据库驱动插件是一个能被QT动态加载的自定义SQL数据库驱动插件创建变得容易的简单插件接口。

写SQL插件可以通过派生QSqlDriverPlugin类实现，重写纯虚函数create(),使用宏Q_PLUGIN_METADATA()导出类。

成员方法：

QSqlDriverPlugin(QObject *parent = nullptr)
virtual ~QSqlDriverPlugin()
virtual QSqlDriver *create(const QString &key) = 0

06. QSqlResult

QSqlResult类提供了访问具体SQL数据库数据的抽象接口。

通常会使用QSqlQuery代替QSqlResult，因为QSqlQuery提供了具体数据库的QSqlResult实现的通用包装。

如果通过派生QSqlDriver实现自定义SQL驱动，需要提供实现了全部纯虚函数和需要的虚函数的自定义的QSqlResult子类。

成员方法：

QSqlResult(const QSqlDriver *db)
void	addBindValue(const QVariant &val, QSql::ParamType paramType)
int	at() const
virtual void	bindValue(int index, const QVariant &val, QSql::ParamType paramType)
virtual void	bindValue(const QString &placeholder, const QVariant &val, QSql::ParamType paramType)
QSql::ParamType	bindValueType(int index) const
QSql::ParamType	bindValueType(const QString &placeholder) const
QSqlResult::BindingSyntax	bindingSyntax() const
QVariant	boundValue(int index) const
QVariant	boundValue(const QString &placeholder) const
int	boundValueCount() const
QString	boundValueName(int index) const
QVector<QVariant> &	boundValues() const
void	clear()
virtual QVariant	data(int index) = 0
const QSqlDriver *	driver() const
virtual bool	exec()
QString	executedQuery() const
virtual bool	fetch(int index) = 0
virtual bool	fetchFirst() = 0
virtual bool	fetchLast() = 0
virtual bool	fetchNext()
virtual bool	fetchPrevious()
bool	hasOutValues() const
bool	isActive() const
bool	isForwardOnly() const
virtual bool	isNull(int index) = 0
bool	isSelect() const
bool	isValid() const
QSqlError	lastError() const
virtual QVariant	lastInsertId() const
QString	lastQuery() const
virtual int	numRowsAffected() = 0
virtual bool	prepare(const QString &query)
virtual QSqlRecord	record() const
virtual bool	reset(const QString &query) = 0
void	resetBindCount()
virtual bool	savePrepare(const QString &query)
virtual void	setActive(bool active)
virtual void	setAt(int index)
virtual void	setForwardOnly(bool forward)
virtual void	setLastError(const QSqlError &error)
virtual void	setQuery(const QString &query)
virtual void	setSelect(bool select)
virtual int	size() = 0