Qt数据库应用13-通用数据库分页

一、前言

数据库分页展示，在所有的涉及到数据库记录的项目中都是需要的，除了简单的设备信息表、用户信息表这种很少几条几十条数据量的表除外，其余的日志记录表等都需要分页展示数据，少量的数据可以滚动条下拉查看完，超过百条以上的一般建议要加上分页的功能处理，不然用户查看起来明显不舒服，体验不友好，最明显的例子就是网页的搜索结果，一次性展示上万条，不仅是多余的增加了查询的压力，而且用户往往只关注最前面的几页记录，再比如查询报警记录，一般是按照时间降序排序，最近最新的报警记录显示在最前面，用户最关心的也就是最前面的结果。

数据库分页一般是通过sql语句的limit去处理，根据用户选择的条件构建sql语句传入数据库执行，每当单击上一页、下一页、第一页、末一页等按钮的时候，也是重新执行了sql语句返回结果。最开始这个数据库分页类是将分页按钮都集中在一起，后面单独拆分了出来，逻辑代码一个类，界面单独成分页导航控件专门展示UI外观，这个外观可以设置各种颜色和样式等。

数据库通用翻页类特点：

1. 可设置每页多少行记录，自动按照设定的值进行分页。
2. 可设置要查询的表名、字段集合、条件语句、排序语句。
3. 可设置第一页、上一页、下一页、末一页、翻页按钮。
4. 可设置当前页、总页数、总记录数、每页记录数、查询用时标签页。
5. 多线程查询总记录数，数据量巨大时候不会卡主界面。
6. 建议条件字段用整型类型的主键，速度极快。
7. 提供查询结果返回信号，包括当前页、总页数、总记录数、查询用时等信息。
8. 可设置所有列或者某一列对齐样式例如居中或者右对齐。
9. 可增加列用于标识该条记录，设定列的位置、标题、宽度。
10. 提供函数直接执行第一页、上一页、下一页、末一页。
11. 提供函数直接跳转到指定页。
12. 根据是否第一页、末一页自动禁用对应的按钮。
13. 本控件是翻页功能类，和翻页控件navpage完美搭配，形成超级牛逼的翻页控件。

分页导航控件特点：

1. 可设置页码按钮的个数。
2. 可设置字体大小。
3. 可设置边框圆角角度、大小、颜色。
4. 可设置正常状态背景颜色、文字颜色。
5. 可识别悬停状态背景颜色、文字颜色。
6. 可设置按下状态背景颜色、文字颜色。
7. 可设置选中状态背景颜色、文字颜色。
8. 可设置导航位置居中对齐、左对齐、右对齐。
9. 可设置是否显示提示标签控件。
10. 自动计算总页码数显示隐藏多余按钮。
11. 自动计算切换页码导航。
12. 和分页导航功能类无缝对接完美融合。

关于Qt数据库相关开发的一些经验总结：

https://qtchina.blog.csdn.net/article/details/119022424

二、功能特点

1. 同时支持多种数据库比如odbc、sqlite、mysql、postgresql、sqlserver、oracle、人大金仓等。
2. 一个数据库类即可管理本地数据库通信，也支持远程数据库通信等。
3. 数据库线程支持执行各种sql语句，包括单条和批量。
4. 组件中的所有类打印信息、错误信息、执行结果都信号发出去。
5. 集成数据库通用翻页类（负责具体处理逻辑），搭配分页导航控件（负责外观），形成超级牛逼的翻页控件。
6. 集成数据库自动清理类，设定最大记录数后台自动清理早期数据。
7. 集成自定义委托类，支持复选框、文本框、下拉框、日期框、微调框、进度条等。
8. 同时支持Qt4-Qt6，亲测Qt4.6到Qt6.3任意版本，任意系统和编译器。
9. 本组件无故障 360天7乘24小时 运行在至少上万个现场，商业级别品质保证。
10. 每个类都对应完整详细的使用示例，注释详细，非常适合阅读学习。
11. 可以作为独立的程序运行，比如自动清理早期数据，同步数据到云端。
12. 全部线程处理，不卡界面，自动重连数据库。
13. 普通测试情况，sqlite数据库，数据库发生器每秒钟插入1000条记录约0.003秒钟，同时自动清理数据类每秒钟删除1000条记录约0.13秒，不同线程互不干扰。

三、体验地址

1. 体验地址：https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A 提取码：o05q 文件名：bin_dbtool.zip
2. 国内站点：https://gitee.com/feiyangqingyun
3. 国际站点：https://github.com/feiyangqingyun
4. 个人主页：https://blog.csdn.net/feiyangqingyun
5. 知乎主页：https://www.zhihu.com/people/feiyangqingyun/

四、效果图

五、相关代码

#include "frmdbpage.h"
#include "ui_frmdbpage.h"
#include "quihelper.h"
#include "dbconnthread.h"
#include "dbpage.h"
#include "dbdelegate.h"

frmDbPage::frmDbPage(QWidget *parent) : QWidget(parent), ui(new Ui::frmDbPage)
{
    ui->setupUi(this);
    this->initForm();
    this->initConfig();
}

frmDbPage::~frmDbPage()
{
    delete ui;
}

void frmDbPage::initForm()
{
    ui->frame->setFixedWidth(AppConfig::RightWidth);
    QUIHelper::initTableView(ui->tableView);

    //实例化数据库通信类
    dbConn = new DbConnThread(this);
    dbConn->setDbFlag("分页");

    //实例化翻页类
    dbPage = new DbPage(this);
    //关联查询记录总数
    connect(dbConn, SIGNAL(receiveCount(QString, int, int)), dbPage, SLOT(receiveCount(QString, int, int)));

    dbPage->setAllCenter(true);
    dbPage->setRecordsPerpage(30);
    dbPage->setWhereSql("where 1=1");

    //分页导航控件
    connect(ui->navPage, SIGNAL(selectPage(int)), dbPage, SLOT(selectPage(int)));
    connect(dbPage, SIGNAL(receivePage(quint32, quint32, quint32, quint32)),
            ui->navPage, SLOT(receivePage(quint32, quint32, quint32, quint32)));
    QLabel *labInfo = ui->navPage->getLabInfo();
    QList<QPushButton *> btns = ui->navPage->getBtnAll();
    dbPage->setControl(ui->tableView, ui->labPageTotal, 0, ui->labRecordsTotal, 0, ui->labSelectTime,
                       labInfo, btns.at(0), btns.at(1), btns.at(2), btns.at(3));

    //采用系统默认的样式并设置按钮固定尺寸
    ui->navPage->setShowStyle(false);
    ui->navPage->setShowGoPage(true);
    foreach (QPushButton *btn, btns) {
        btn->setFixedWidth(50);
    }
}

void frmDbPage::initConfig()
{
    ui->cboxDbType->addItems(DbHelper::getDbType());
    ui->cboxDbType->setCurrentIndex(ui->cboxDbType->findText(AppConfig::DbType4));
    connect(ui->cboxDbType, SIGNAL(currentIndexChanged(int)), this, SLOT(saveConfig()));

    ui->txtDbName->setText(AppConfig::DbName4);
    connect(ui->txtDbName, SIGNAL(textChanged(QString)), this, SLOT(saveConfig()));

    ui->txtHostName->setText(AppConfig::HostName4);
    connect(ui->txtHostName, SIGNAL(textChanged(QString)), this, SLOT(saveConfig()));

    ui->txtHostPort->setText(QString::number(AppConfig::HostPort4));
    connect(ui->txtHostPort, SIGNAL(textChanged(QString)), this, SLOT(saveConfig()));

    ui->txtUserName->setText(AppConfig::UserName4);
    connect(ui->txtUserName, SIGNAL(textChanged(QString)), this, SLOT(saveConfig()));

    ui->txtUserPwd->setText(AppConfig::UserPwd4);
    connect(ui->txtUserPwd, SIGNAL(textChanged(QString)), this, SLOT(saveConfig()));

    ui->txtColumnName->setText(AppConfig::ColumnName4);
    connect(ui->txtColumnName, SIGNAL(textChanged()), this, SLOT(saveConfig()));

    ui->txtColumnWidth->setText(AppConfig::ColumnWidth4);
    connect(ui->txtColumnWidth, SIGNAL(textChanged()), this, SLOT(saveConfig()));

    ui->txtCountName->setText("LogID");
    ui->txtOrderSql->setText("LogID asc");
}

void frmDbPage::saveConfig()
{
    AppConfig::DbType4 = ui->cboxDbType->currentText();
    AppConfig::DbName4 = ui->txtDbName->text();
    AppConfig::HostName4 = ui->txtHostName->text();
    AppConfig::HostPort4 = ui->txtHostPort->text().toInt();
    AppConfig::UserName4 = ui->txtUserName->text();
    AppConfig::UserPwd4 = ui->txtUserPwd->text();

    AppConfig::ColumnName4 = ui->txtColumnName->toPlainText();
    AppConfig::ColumnWidth4 = ui->txtColumnWidth->toPlainText();
    AppConfig::writeConfig();
}

void frmDbPage::on_btnOpen_clicked()
{
    if (ui->btnOpen->text() == "打开数据库") {
        DbInfo dbInfo;
        dbInfo.connName = this->objectName();
        dbInfo.dbName = AppConfig::DbName4;
        dbInfo.hostName = AppConfig::HostName4;
        dbInfo.hostPort = AppConfig::HostPort4;
        dbInfo.userName = AppConfig::UserName4;
        dbInfo.userPwd = AppConfig::UserPwd4;

        QString dbType = AppConfig::DbType4.toUpper();
        if (dbType == "SQLITE") {
            dbInfo.dbName = DbHelper::getDbDefaultFile();
        }

        dbConn->setConnInfo(DbHelper::getDbType(dbType), dbInfo);
        if (dbConn->openDb()) {
            dbConn->start();
            ui->btnOpen->setText("关闭数据库");
        } else {
            QString error = dbConn->getDatabase().lastError().text();
            QUIHelper::showMessageBoxError("打开数据库失败!\n" + error, 3);
        }
    } else {
        dbConn->stop();
        dbConn->closeDb();
        ui->btnOpen->setText("打开数据库");
        dbPage->clear();
    }

    QTimer::singleShot(100, this, SLOT(getTables()));
    QTimer::singleShot(1000, this, SLOT(on_btnDo_clicked()));
}

void frmDbPage::on_btnCopy_clicked()
{
    //将数据库设置参数一键粘贴过来
    ui->cboxDbType->setCurrentIndex(ui->cboxDbType->findText(AppConfig::LocalDbType));
    ui->txtDbName->setText(AppConfig::LocalDbName);
    ui->txtHostName->setText(AppConfig::LocalHostName);
    ui->txtHostPort->setText(QString::number(AppConfig::LocalHostPort));
    ui->txtUserName->setText(AppConfig::LocalUserName);
    ui->txtUserPwd->setText(AppConfig::LocalUserPwd);
}

void frmDbPage::getTables()
{
    if (!dbConn->getOk()) {
        return;
    }

    //取出数据库对应的表集合
    QStringList tables = dbConn->getDatabase().tables();
    ui->cboxTables->clear();
    ui->cboxTables->addItems(tables);
    if (tables.contains("LogInfo")) {
        ui->cboxTables->setCurrentIndex(ui->cboxTables->findText("LogInfo"));
    }
}

void frmDbPage::on_btnDo_clicked()
{
    if (!dbConn->getOk()) {
        return;
    }

    //表格字段 名称+宽度
    QList<QString> columnNames = AppConfig::ColumnName4.split(",");
    QList<int> columnWidths;
    QStringList listWidth = AppConfig::ColumnWidth4.split(",");
    foreach (QString width, listWidth) {
        columnWidths << width.toInt();
    }

    //具体函数解释参见对应类头文件
    //不设置字段中文名和宽度也行,默认取数据库字段名
    dbPage->setColumnNames(columnNames);
    dbPage->setColumnWidths(columnWidths);

    dbPage->setDbType(AppConfig::DbType4);
    dbPage->setConnName(dbConn->getDatabase().connectionName());

    QString tableName = ui->cboxTables->currentText();
    QString countName = ui->txtCountName->text();
    QString orderSql = ui->txtOrderSql->text();
    dbPage->setTableName(tableName);
    dbPage->setOrderSql(orderSql);

    dbPage->select();
    dbConn->selectCount(tableName, countName, "where 1=1");
}

void frmDbPage::on_cboxTables_currentIndexChanged(int)
{
    QString table = ui->cboxTables->currentText();
    QSqlRecord records = dbConn->getDatabase().record(table);
    ui->cboxRecords->clear();
    for (int i = 0; i < records.count(); ++i) {
        ui->cboxRecords->addItem(records.fieldName(i));
    }
}

void frmDbPage::on_cboxRecords_currentIndexChanged(int)
{
    QString record = ui->cboxRecords->currentText();
    ui->txtCountName->setText(record);
    ui->txtOrderSql->setText(record + " asc");
}