一、前言
数据库分页展示,在所有的涉及到数据库记录的项目中都是需要的,除了简单的设备信息表、用户信息表这种很少几条几十条数据量的表除外,其余的日志记录表等都需要分页展示数据,少量的数据可以滚动条下拉查看完,超过百条以上的一般建议要加上分页的功能处理,不然用户查看起来明显不舒服,体验不友好,最明显的例子就是网页的搜索结果,一次性展示上万条,不仅是多余的增加了查询的压力,而且用户往往只关注最前面的几页记录,再比如查询报警记录,一般是按照时间降序排序,最近最新的报警记录显示在最前面,用户最关心的也就是最前面的结果。
数据库分页一般是通过sql语句的limit去处理,根据用户选择的条件构建sql语句传入数据库执行,每当单击上一页、下一页、第一页、末一页等按钮的时候,也是重新执行了sql语句返回结果。最开始这个数据库分页类是将分页按钮都集中在一起,后面单独拆分了出来,逻辑代码一个类,界面单独成分页导航控件专门展示UI外观,这个外观可以设置各种颜色和样式等。
数据库通用翻页类特点:
- 可设置每页多少行记录,自动按照设定的值进行分页。
- 可设置要查询的表名、字段集合、条件语句、排序语句。
- 可设置第一页、上一页、下一页、末一页、翻页按钮。
- 可设置当前页、总页数、总记录数、每页记录数、查询用时标签页。
- 多线程查询总记录数,数据量巨大时候不会卡主界面。
- 建议条件字段用整型类型的主键,速度极快。
- 提供查询结果返回信号,包括当前页、总页数、总记录数、查询用时等信息。
- 可设置所有列或者某一列对齐样式例如居中或者右对齐。
- 可增加列用于标识该条记录,设定列的位置、标题、宽度。
- 提供函数直接执行第一页、上一页、下一页、末一页。
- 提供函数直接跳转到指定页。
- 根据是否第一页、末一页自动禁用对应的按钮。
- 本控件是翻页功能类,和翻页控件navpage完美搭配,形成超级牛逼的翻页控件。
分页导航控件特点:
- 可设置页码按钮的个数。
- 可设置字体大小。
- 可设置边框圆角角度、大小、颜色。
- 可设置正常状态背景颜色、文字颜色。
- 可识别悬停状态背景颜色、文字颜色。
- 可设置按下状态背景颜色、文字颜色。
- 可设置选中状态背景颜色、文字颜色。
- 可设置导航位置居中对齐、左对齐、右对齐。
- 可设置是否显示提示标签控件。
- 自动计算总页码数显示隐藏多余按钮。
- 自动计算切换页码导航。
- 和分页导航功能类无缝对接完美融合。
关于Qt数据库相关开发的一些经验总结:
https://qtchina.blog.csdn.net/article/details/119022424
二、功能特点
- 同时支持多种数据库比如odbc、sqlite、mysql、postgresql、sqlserver、oracle、人大金仓等。
- 一个数据库类即可管理本地数据库通信,也支持远程数据库通信等。
- 数据库线程支持执行各种sql语句,包括单条和批量。
- 组件中的所有类打印信息、错误信息、执行结果都信号发出去。
- 集成数据库通用翻页类(负责具体处理逻辑),搭配分页导航控件(负责外观),形成超级牛逼的翻页控件。
- 集成数据库自动清理类,设定最大记录数后台自动清理早期数据。
- 集成自定义委托类,支持复选框、文本框、下拉框、日期框、微调框、进度条等。
- 同时支持Qt4-Qt6,亲测Qt4.6到Qt6.3任意版本,任意系统和编译器。
- 本组件无故障 360天7乘24小时 运行在至少上万个现场,商业级别品质保证。
- 每个类都对应完整详细的使用示例,注释详细,非常适合阅读学习。
- 可以作为独立的程序运行,比如自动清理早期数据,同步数据到云端。
- 全部线程处理,不卡界面,自动重连数据库。
- 普通测试情况,sqlite数据库,数据库发生器每秒钟插入1000条记录约0.003秒钟,同时自动清理数据类每秒钟删除1000条记录约0.13秒,不同线程互不干扰。
三、体验地址
- 体验地址:https://pan.baidu.com/s/1ZxG-oyUKe286LPMPxOrO2A 提取码:o05q 文件名:bin_dbtool.zip
- 国内站点:https://gitee.com/feiyangqingyun
- 国际站点:https://github.com/feiyangqingyun
- 个人主页:https://blog.csdn.net/feiyangqingyun
- 知乎主页: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");
}