Qt操作SQLite数据库的三种方式

Qt访问Sqlite数据库的三种方式(即使用三种类库去访问)，分别为QSqlQuery、QSqlQueryModel、QSqlTableModel，对于这三种类库，可看为一个比一个上层，也就是封装的更厉害，甚至第三种QSqlTableModel，根本就不需要开发者懂SQL语言，也能操作Sqlite数据库。

方式1. 使用QSqlQuery来访问

通过exec()成员函数来执行DML(数据操作语言)语句，如增删改查SELECT、INSERT、UPDATE和DELETE，以及DDL(数据定义语言)语句等。

在.pro文件中记得增加sql模块。（project）

说明：Qt自带SQLite数据库，不需要再单独安装，默认情况下，使用SQLite版本3，驱动程序为***QSQLITE***。

QT       += core gui printsupport sql

#include <QVariant>
#include <QSqlDatabase>
#include <QSqlError>
#include <QSqlQuery>

typedef struct _temp_data_t
{
    QString dateTime;
    double wenqu1;
    double wenqu2;
    double wenqu3;
    double wenqu4;
    qint32 status;
}TempData;

bool DBAUtils::openDb()
{
    if(QSqlDatabase::contains("qt_sql_default_connection"))
    {
        db = QSqlDatabase::database("qt_sql_default_connection");
    }
    else {
        db = QSqlDatabase::addDatabase("QSQLITE");
        db.setDatabaseName(QApplication::applicationDirPath() + "/database/" + "data.db");
    }

    if(!db.open())
    {
        qDebug()<<"error: failed to connect sqlite3 database."<< db.lastError();
        return false;
    }
    else {
        qDebug()<<"success to connect sqlite3 database.";
        return true;
    }
}

void DBAUtils::createTable(void)
{
    //用于执行sql语句的对象
        QSqlQuery query;
        //构建创建数据库的sql语句字符串
        QString str = QString("CREATE TABLE IF NOT EXISTS temp_data( \
                              id INTEGER PRIMARY KEY AUTOINCREMENT, \
                              TIME           VARCHAR(20) NOT NULL, \
                              WENQU1         REAL    NOT NULL, \
                              WENQU2         REAL     NOT NULL, \
                              WENQU3         REAL    NOT NULL, \
                              WENQU4         REAL     NOT NULL, \
                              STATUS         INTEGER     NOT NULL \
                              );");
        query.exec(str);
}

id INTEGER PRIMARY KEY AUTOINCREMENT, 表示该列（键值列id）为整数递增,如果为空时则自动填入1,然后在下面的每一行都会自动+1, PRIMARY KEY则表示该列作为列表的主键,通过它可以轻易地获取某一行数据。
" INTEGER ":表示该列为带符号的整数。
" VARCHAR(20) ":表示该列为可变长字符串,默认只能存储英文和数字或者utf-8,最多存储20个字节。
"NOT NULL "：表示该列的内容不为空。

bool DBAUtils::insertRecord(const TempData &data)
{
    static int id = 0;
    QSqlQuery query;
    query.prepare("INSERT INTO temp_data(id, TIME, WENQU1, WENQU2, WENQU3, WENQU4, STATUS)" \
                  "VALUES(NULL, :TIME, :WENQU1, :WENQU2, :WENQU3, :WENQU4, :STATUS)");
//    query.bindValue(":id", NULL);
    query.bindValue(":TIME", data.dateTime);
    query.bindValue(":WENQU1", data.wenqu1);
    query.bindValue(":WENQU2", data.wenqu2);
    query.bindValue(":WENQU3", data.wenqu3);
    query.bindValue(":WENQU4", data.wenqu4);
    query.bindValue(":STATUS", data.status);
    if(!query.exec())
    {
         qDebug() << "insertRecord error: " << query.lastError();
         return false;
    }
    return true;
}

QSqlQuery直接使用sql语句与采用bindValue的比较

推荐使用bindValue模式，理由如下：

1.有效防止Sql注入,保证Sql语句的原始意义不发生变化。

2.在字符串中含有特殊字符(如:单引号,中括号等)时,能对其处理。

3.在执行多条相同数据类型操作(Sql原语相同,数据不同)时,减少Sql的预编译次数,优化Sql执行效率。

4.可读性强。

方式2. 使用QSqlQueryModel来访问

Qt中使用了自己的机制来避免使用SQL语句，它为我们提供了更简单的数据库操作和数据显示模型。它们分别是只读的QSqlQueryModel，操作单表的QSqlTableModel和以及可以支持外键的QSqlRelationalTableModel。QSqlQueryModel类对象model，并用setQuery()函数执行了SQL语句“(“select * from student”);”用来查询整个student表的内容，可以看到，该类并没有完全避免SQL语句。然后我们设置了表中属性显示时的名字。最后我们建立了一个视图view，并将这个model模型关联到视图中，这样数据库中的数据就能在窗口上的表中显示出来了。

QSqlQueryModel类为SQL的结果集提供了一个只读的数据模型。这个模型默认是只读的，所以我们在窗口上并不能对表格中的内容进行修改。但是我们可以创建自己的模型，然后按照我们自己的意愿来显示数据和修改数据。要想使其可读写，需要自己的类继承自QSqlQueryModel，并且重写setData() 和 flags() 两个函数。如果我们要改变数据的显示，就要重写data() 函数。

方式3. 使用QSqlTableModel来访问

最后我们来说说使用QSqlTableModel这个类去操作Sqlite数据库，这个类比上两个封装的更彻底，即使我们不懂SQL语言，也能实现对Sqlite数据库的操作，并且这个类也可以通过视图来显示修改数据库内容，这里我就拿这个类做了个用户管理模块，其实也可以通用与其他任何一个模块，只要在生成对象时传入sqlite的数据库名及要操作的表名即可。

void MainWindow::on_pBtn_DoSelect_clicked()
{
    if(DBAUtils::getInstance()->dbHandle().isOpen())
    {
        QSqlQueryModel *model = new QSqlQueryModel;
        model->setQuery("SELECT * FROM temp_data", DBAUtils::getInstance()->dbHandle()); //从给定的数据库db执行sql操作, db需预先制定并打开
        model->setHeaderData(0, Qt::Horizontal, QStringLiteral("序号"));	//设置表头，如不设置则使用数据库中的默认表头
        model->setHeaderData(1, Qt::Horizontal, QStringLiteral("时间"));
        model->setHeaderData(2, Qt::Horizontal, QStringLiteral("温区1"));
        model->setHeaderData(3, Qt::Horizontal, QStringLiteral("温区2"));
        model->setHeaderData(4, Qt::Horizontal, QStringLiteral("温区3"));
        model->setHeaderData(5, Qt::Horizontal, QStringLiteral("温区4"));
        model->setHeaderData(6, Qt::Horizontal, QStringLiteral("状态"));

        while(model->canFetchMore())
            model->fetchMore();

        int column = model->columnCount(); //获取列数
        int row = model->rowCount(); //获取行数
        ui->lineEdit_columnCount->setText(QString("%1").arg(column));
        ui->lineEdit_rowCount->setText(QString("%1").arg(row));

        ui->tableViewHistory->setModel(model);
//        ui->tableViewHistory->horizontalHeader()->setHidden(true); //QTableView隐藏表头
        ui->tableViewHistory->verticalHeader()->setHidden(true); //把QTableView中第一列的默认数字列去掉
        ui->tableViewHistory->resizeColumnsToContents();

    }
}

问题总结

QSqlQueryModel/QSqlTableModel 仅能获取256行的问题

QSqlTableModel select数据完成后，当数据记录数目多于256时，rowCount 返回值最大为256.

为了强制获取整个数据集，可以使用以下代码：

while(model->canFetchMore())
    model->fetchMore();

参考：Qt操作SQLite数据库_宁静致远2021的博客-CSDN博客_qt与sqlite连接