Qt5使用QSqlQuery读写sqlite3数据库

概述

• 本文将介绍使用 Qt5使用QSqlQuery读写sqlite3。
• 设计初衷： 项目需要使用配置文件，配置文件使用的是sqlite3 ， 这是V1.0.0， 后期增加其他功能。
• 需要C++11支持（可删除代码中的c++11代码），不过后期可能会增加更多基于C++11代码
• Qt creator 的.pro文件需要加入： QT += sql
• 本文的项目是基于Qt creator的qmake编译的，非CMake.
• 本文涉及的Qt version: Qt5.14 （好像Qt5.9要是已经支持C++11， 具体的，大家可以google一下 ）
• 本文使用的sqlite3可视化软件是：sqlite studio

功能

• 执行sql语句： 增加、删除、修改、查询

使用顺序

• 1.先调用函数 init_, 传入数据库文件
• 2.【1】返回0，再调用函数【get_record_】 或者 【exec_sql_】函数操作
• 3.可显示调用函数【uninit_】

sqlite_assistant.h

#ifndef SQLITE_ASSISTANT_H
#define SQLITE_ASSISTANT_H

#include <QObject>
#include <QSqlDatabase>
#include <QSqlQuery>

namespace oct_db
{
    /// 读写sqlite3
    class sqlite_assistant : public QObject
    {
        Q_OBJECT
    public:
        explicit sqlite_assistant(QObject *parent = nullptr);
        ~sqlite_assistant();

		/// 这些都需要屏蔽
        sqlite_assistant(const sqlite_assistant& instance) = delete;
        sqlite_assistant(const sqlite_assistant&& instance) = delete;
        sqlite_assistant& operator = (const sqlite_assistant& instance) = delete;
        sqlite_assistant& operator = (const sqlite_assistant&& instance) = delete;

        ///  --------------------------------------------------------------------------------
        ///  @brief: 初始化，str_db_file是数据库文件，例如： C:/demo/hello_sqlite.db3
        ///  @str_db_file - sqlite3数据库文件： 例如： C:/demo/demo.db3
        ///  @return - int
		///				0 - 成功
		///				-2 - 失败， 参数【str_db_file】为空
		///				-3 - 失败， 参数【str_db_file】文件不存在
		///				-5 - 失败， 打开参数【str_db_file】的数据库失败
        ///  --------------------------------------------------------------------------------
        int init_(const QString& str_db_file) noexcept;

        ///  --------------------------------------------------------------------------------
        ///  @brief: 查询表的数据， 如果没有调用函数 init_, 也将返回 nullptr
        ///  @str_table_name - 【str_table_name】表的名字
        ///  @return - QSqlQuery*
		///					nullptr - 失败， 【str_table_name】为空、【数据库没有打开】、执行【SELECT* FROM table_name】语句失败 中的一种
		///					否则，成功
        ///  --------------------------------------------------------------------------------
        QSqlQuery* get_record_(const QString& str_table_name);

        ///  --------------------------------------------------------------------------------
        ///  @brief: 执行sql语句，这里主要用作： 修改、删除、增加，查询用函数【get_record_】
        ///  @str_sql - sql语句
        ///  @return - int
		///				0 - 成功
		///				-2 - 失败，参数【str_sql】为空
		///				-3 - 失败，数据库没有打开，应该先调用函数 【init_】
		///				-5 - 失败，执行sql语句失败，检查sql语句
        ///  --------------------------------------------------------------------------------
        int exec_sql_(const QString& str_sql);

		///  --------------------------------------------------------------------------------
		///  @brief: 返回当前连接的数据库文件
		///  @return - QString
		///  --------------------------------------------------------------------------------
		QString get_db_file();

        ///  --------------------------------------------------------------------------------
        ///  @brief: release the space at first, 可显示调用
        ///  @return - void
        ///  --------------------------------------------------------------------------------
        void uninit_();

    private:
        /// 当前使用的数据库文件
        QString str_db_file_;

        /// 连接字符串
        QString str_connection_;

        ///
        QSqlDatabase sql_database_;

        ///
        QSqlQuery   *psqlquery_ = nullptr;
    };
}

#endif // SQLITE_ASSISTANT_H

sqlite_assistant.cc

#include "sqlite_assistant.h"
#include <QFile>

namespace oct_db
{

    sqlite_assistant::sqlite_assistant(QObject *parent) : QObject(parent)
    {
        str_connection_ = QString("sqlite_assistant");
    }

    sqlite_assistant::~sqlite_assistant()
    {
        uninit_();
    }

    int sqlite_assistant::init_(const QString &str_db_file) noexcept
    {
        /// 1. 字符串为空
        if ((str_db_file.isNull()) || (str_db_file.isEmpty()) )
            return -2;

        /// 2..文件不存在
        QFile db_file(str_db_file);
        if (!db_file.exists())
            return -3;

        /// 保存文件名
        str_db_file_ = str_db_file;

        /// 2.5 断开先前的连接
        uninit_();

        /// 3. 连接数据库
        if (QSqlDatabase::contains(str_connection_))
            sql_database_ = QSqlDatabase::database(str_connection_);
        else
            sql_database_ = QSqlDatabase::addDatabase("QSQLITE", str_connection_);

        /// 4.设置数据库名
        sql_database_.setDatabaseName(str_db_file_);

        /// 打开数据库
        if (!sql_database_.open())
            return -5;

        if (nullptr != psqlquery_)
        {
            delete psqlquery_;
            psqlquery_ = nullptr;
        }

        if (nullptr == psqlquery_)
            psqlquery_ = new QSqlQuery(sql_database_);

        /// 打开成功
        return 0;

    }

    QSqlQuery *sqlite_assistant::get_record_(const QString& str_table_name)
    {
        /// 1. 字符串为空
        if ((str_table_name.isNull()) || (str_table_name.isEmpty()) )
        {
//            str_err = QString("the parameter [str_table_name] is null");
            return nullptr;
        }

        /// 2. 数据库没有打开
        if (!sql_database_.isOpen())
        {
//            str_err = QString("failure, the database didn't open");
            return nullptr;
        }

        if (nullptr == psqlquery_)
        {
//            str_err = QString("failure, db file is openned, but the /*QSqlQuery*/ object created failure");
            return nullptr;
        }

        /// 3.构建sql语句、执行，并返回结果
        QString str_sql = QString("SELECT * FROM ") + str_table_name;
        bool flag = psqlquery_->prepare(str_sql);
        if (!psqlquery_->exec())
        {
//            str_err = QString("failure, the error is from executing sql");
            return nullptr;
        }

        return psqlquery_;
    }

    int sqlite_assistant::exec_sql_(const QString &str_sql)
    {
        /// 1. 字符串为空
        if ((str_sql.isNull()) || (str_sql.isEmpty()) )
            return -2;

        if (!sql_database_.isOpen())
            return -3;
        if (nullptr == psqlquery_)
            return -5;

        psqlquery_->prepare(str_sql);
        bool is_success = psqlquery_->exec();

        return ( (true == is_success) ? 0 : -6);
    }

    void sqlite_assistant::uninit_()
    {
        try
        {
            if (nullptr != psqlquery_)
            {
                psqlquery_->clear();
                delete psqlquery_;
                psqlquery_ = nullptr;
            }

            if (sql_database_.isOpen())
                sql_database_.close();
        }
        catch(...)
        {
            /// take the exception and do not expand
        }
    }

	QString sqlite_assistant::get_db_file()
	{
		return str_db_file_;
	}

}

调用示例

准备了一张表，内容如下；

包含头文件

#include <QApplication>
#include "sqlite_assistant.h"

using namespace  oct_db;
#include <QDebug>
#include <QSqlQuery>
#include <QStringLiteral>

调用代码

 /// 1.创建数据据访问对象
    sqlite_assistant* psq = new sqlite_assistant;
    if (nullptr == psq)
        return a.exec();

    /// 2.准备数据库文件
    QString str_db_file = QApplication::applicationDirPath() + QString("/cmd_makeup.db3");
    qDebug() << "\n\n 33333 rstr_db_fileet=" << str_db_file << "\n\n\n";

    /// 3.调用初始化数据库操作
    int ret = psq->init_(str_db_file);
    qDebug() << "\n\n AAA ret=" << ret << "\n\n\n";

    /// 4.查询【手机】表中的内容
    QSqlQuery* pquery = psq->get_record_(QStringLiteral("手机"));
    if (nullptr == pquery)
    {
        qDebug() << "\n\n error pquery is null \n\n";
    }
    else
    {

        /// 读取测试
        while(pquery->next())
        {
            /// 读取并显示一行数据， 与数据库中的对应
            qDebug() << "no=" << pquery->value(QStringLiteral("序号")).toString() << ", ";
            qDebug() << "name=" << pquery->value(QStringLiteral("名称")).toString() << ", ";
            qDebug() << "value=" << pquery->value(QStringLiteral("值")).toString() << "\n";
        }

    }

    /// 5. 执行sql语句测试
    QString str_sql = QStringLiteral("UPDATE 手机 SET 名称='ABC' WHERE 序号='1'");
    qDebug() << "\n\n sql = " << str_sql << "\n\n";
    qDebug () << "\n\n ret = " << psq->exec_sql_(str_sql) << "\n\n";

    /// 6.下面这句可显示调用，也可以不用调用，因为析构函数中已经做了调用
    psq->uninit_();

执行结果：

完整演示代码

#include "dialog.h"

#include <QApplication>
#include "sqlite_assistant.h"

using namespace  oct_db;
#include <QDebug>
#include <QSqlQuery>
#include <QStringLiteral>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    Dialog w;
    w.show();

    /// 1.创建数据据访问对象
    sqlite_assistant* psq = new sqlite_assistant;
    if (nullptr == psq)
        return a.exec();

    /// 2.准备数据库文件
    QString str_db_file = QApplication::applicationDirPath() + QString("/cmd_makeup.db3");
    qDebug() << "\n\n 33333 rstr_db_fileet=" << str_db_file << "\n\n\n";

    /// 3.调用初始化数据库操作
    int ret = psq->init_(str_db_file);
    qDebug() << "\n\n AAA ret=" << ret << "\n\n\n";

    /// 4.查询【手机】表中的内容
    QSqlQuery* pquery = psq->get_record_(QStringLiteral("手机"));
    if (nullptr == pquery)
    {
        qDebug() << "\n\n error pquery is null \n\n";
    }
    else
    {

        /// 读取测试
        while(pquery->next())
        {
            /// 读取并显示一行数据， 与数据库中的对应
            qDebug() << "no=" << pquery->value(QStringLiteral("序号")).toString() << ", ";
            qDebug() << "name=" << pquery->value(QStringLiteral("名称")).toString() << ", ";
            qDebug() << "value=" << pquery->value(QStringLiteral("值")).toString() << "\n";
        }

    }

    /// 5. 执行sql语句测试
    QString str_sql = QStringLiteral("UPDATE 手机 SET 名称='ABC' WHERE 序号='1'");
    qDebug() << "\n\n sql = " << str_sql << "\n\n";
    qDebug () << "\n\n ret = " << psq->exec_sql_(str_sql) << "\n\n";

    /// 6.下面这句可显示调用，也可以不用调用，因为析构函数中已经做了调用
    psq->uninit_();

    return a.exec();
}