前言支持内置数据库:
驱动关系:
拿Mysql举例,我们的Qt程序有自己的驱动,libqsqlmysql.dll,如果Qt安装好了之后没有这个动态库,则需要自己使用qmake编译。如果有了这个驱动,说明我们的Qt环境已经ok了,但是如果需要访问Mysql数据库,还需要Mysql提供的访问它的驱动libmysql.dll【linux对应libmysqlclient.so.18,不同mysql版本名字不一样】。总结就是:Qt程序->libqsqlmysql.dll->libmysql.dll->Mysql数据库
libqsqlmysql.dll:安装Qt附带或者源代码编译
libmysql.dll:安装mysql或者直接网上找这个动态库
一、sqlite
1、在头文件中声明数据库对象
QSqlDatabase db;
2、在构造函数中定义对象(最好这样定义,因为对于db来说只需要addDatabase一次,否则多次addDatabase会报错)
if(QSqlDatabase::contains("qt_sql_default_connection"))
db = QSqlDatabase::database("qt_sql_default_connection");
else
db = QSqlDatabase::addDatabase("QSQLITE");
3、设置数据库文件路径
db.setDatabaseName(".//qtDb.db");//设置数据库文件名字,选择的是当前路径
4、打开数据库
if(!db.open())
{
qDebug() << "打开数据库失败";
return;
}
5、判断数据库中是否存在某表,不存在则新建(数据库指令相关)
QSqlQuery query(db);
bool isTableExist = query.exec("select * from CSSBDB");//关键的判断
if(!isTableExist)//表不存在,新建表
{
bool success = query.exec("create table CSSBDB(id INTEGER PRIMARY KEY,设备名称 varchar,设备型号 varchar,固定资产编号 varchar,测试部自编号 varchar,卡片编号 varchar,数量 varchar,单价 varchar,启用时间 varchar,用途 varchar,使用人或保管人 varchar,备注 varchar)");//创建数据表
if(success)
{
qDebug() <<"数据库表1创建成功!";
}
else
{
qDebug() <<"数据库表1创建失败!";
QSqlError tempErr = query.lastError();
qDebug()<
return;
}
}
6、获取数据库中有多少数据(行数和列数)
query.exec("select * from CSSBDB");
QSqlQueryModel *model = new QSqlQueryModel();
model->setQuery(query);
int nRecordCount = model->rowCount();//行数
int nColumnCount = model->columnCount();//列数
7、获取表的表头内容
if(query.exec("PRAGMA table_info(CSSBDB)"))
{
QStringList tempList;
while(query.next())
{
tempList.append(query.value(1).toString());
}
}
下图是获取表信息结果
8、更新某条记录
update CSSBDB set companyNumber='050689' where id=2
9、插入一条记录
insert into CSSBDB values(null,"台式主机","DELL9020MT","050688","CSB-PC001-A","123","1","3000","2016.4.15","服务器","","")//如果id是null则表示id按顺序增加1
10、关闭数据库
db.close();
二、Access
{
QSqlDatabase db = QSqlDatabase::addDatabase("QODBC", "EXPORT_EXCEL");
QString dsn = QString("DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};FIL={MS Access};DBQ=%1").arg(filePath);// DB_PATH
db.setDatabaseName(dsn);//设置数据库路径
QString sqlStr;
if (!db.open())
{
qDebug() << "打开数据库失败";
}
else
{
QSqlQuery query(db);
sqlStr = "";
sqlStr = QString("SELECT * FROM tableName");
query.exec(sqlStr);
}
}
QSqlDatabase::removeDatabase("EXPORT_EXCEL");
ps:
1、query.next(数据库命令)是每次返回一行数据,要取出当前行的某列数据,使用query.value(n),n从0开始
2、判断当前qt可用的数据库驱动
QStringList drivers = QSqlDatabase::drivers();
foreach(QString driver, drivers)
qDebug() << "\t" << driver;
QSqlDatabase db = QSqlDatabase::addDatabase("QODBC", "test");
qDebug() << "ODBC driver valid?" << db.isValid();
3、query.exec,如果sql语句没错,拿它是不会报错的,即时返回值为空,它也没错
4、数据库回收
{
//这里用{}画出一个作用域,当这个域完成之后,数据库的所有操作动作都被回收了
QSqlDatabase db = QSqlDatabase::addDatabase("QODBC");//数据库,设置为Access2000
QString dsn = QString("DRIVER={Microsoft Access Driver (*.mdb, *.accdb)};FIL={MS Access};DBQ=%1").arg(DB_PATH);//这是access的数据库,需要与当前电脑数据库驱动一致:控制面板,数据源,ODBC
db.setDatabaseName(dsn);//设置数据库路径
db.open();
//数据库操作
}QSqlDatabase::removeDatabase("qt_sql_default_connection");//这句话之前保证当前连接的数据库没有任何数据操作,由上面的作用域实现
5、数据库原理:
QSqlDatabase db = QSqlDatabase::addDatabase("QODBC");
上面这句话是新建一个连接,每个连接是对数据库的唯一标识,如果像上面这样写,连接名称就是默认的qt_sql_default_connection,最后回收的时候也是QSqlDatabase::removeDatabase("qt_sql_default_connection")
如果在程序中多个地方【线程】操作数据库:QSqlDatabase db = QSqlDatabase::addDatabase("QODBC","MyConnction");
回收:QSqlDatabase::removeDatabase("MyConnction");
6、有时候出现问题:"[Microsoft][ODBC 驱动程序管理器] 未发现数据源名称并且未指定默认驱动程序 QODBC3: Unable to connect"
1、dsn语句有误
2、数据库驱动不正确,当时我编译的是64位的,正常运行,后来改成了32位的,报上面错,下载32位的驱动安装了就ok了
7、解决通过model->rowCount();只能返回最多256个数据
while(model->canFetchMore())
{
model->fetchMore();
}
8、使用了数据库时,有时打包软件出现“driver not load”
1)将C:\Qt\Qt5.3.1\5.3\msvc2012路径下的文件夹plugins复制到exe文件目录下,打开plugins,只保留sqldrivers文件夹,需要确认里面是否有你需要的驱动, 如:程序中使用了QSqlite数据库,则需要有qsqlite.dll(发布版)qsqlited.dll(调试版),
2)在main.cpp文件中添加下面第二行和第三行:
QApplication a(argc, argv);
QString strLibPath(QDir::toNativeSeparators(QApplication::applicationDirPath())+QDir::separator()+"plugins");
a.addLibraryPath(strLibPath);
9、将数据库快速转Excel的办法
sqlStr = "SELECT * INTO [excel 8.0;database=.\\Data\\export\\1.xls].Sheet1 FROM tableName";
三、mysql
3.1、自己封装的单次访问数据库类,自动实现释放连接
头文件:
#ifndef MYSQLTOOL_H
#define MYSQLTOOL_H
#include
#include "includes.h"
#include #include class Mysqltool { public: Mysqltool(QString dataBaseName); virtual ~Mysqltool(); public: bool exec(QString sql);//插入、删除、更新 bool select(QString sql,QSqlQuery& rsltQuery);//查询 private: QSqlDatabase* pDb; QString dataBaseName; void setRandString(QString & randString);//获取随机字符串 }; extern std::mutex m_mutext_opensql; #endif // MYSQLTOOL_H
源文件:
#include "mysqltool.h"
#include "mymethod.h"
#include
#include
std::mutex m_mutext_opensql;
/*****************************************************************/
//作者:朱小勇
//函数名称:构造函数
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/ Mysqltool::Mysqltool(QString dataBaseName) { QString randStr;setRandString(randStr); dataBaseName += randStr; #if CLOSE_IF Mymethod::record(dataBaseName); #endif pDb = new QSqlDatabase(QSqlDatabase::addDatabase("QMYSQL", dataBaseName)); pDb->setHostName(DB_IP); //ip pDb->setUserName(DB_USER_NAME); //登陆MYSQL的用户名 pDb->setPassword(DB_PASSWORD); //登陆的密码 pDb->setDatabaseName(DB_DATABASE_NAME); //数据库的名称 m_mutext_opensql.lock(); if(!pDb->open()) { Mymethod::record("数据库打开失败:"); // QSqlError tempErr = db.lastError(); // qDebug()<dataBaseName = dataBaseName; } /*****************************************************************/ //作者:朱小勇 //函数名称:析构函数 //函数参数:NULL //函数返回值:NULL //函数作用:NULL //备注:NULL /*****************************************************************/ Mysqltool::~Mysqltool() { pDb->close(); delete pDb; pDb = nullptr; QSqlDatabase::removeDatabase(dataBaseName); } /*****************************************************************/ //作者:朱小勇 //函数名称:增删改 //函数参数:NULL //函数返回值:NULL //函数作用:NULL //备注:NULL /*****************************************************************/ bool Mysqltool::exec(QString sql) { bool ret = true; RET_VALUE_IF_EAQU(pDb->isOpen(),false,false); QSqlQuery query(*pDb); #if OPEN_IF if(!query.exec(sql)) { QSqlError tempErr = query.lastError(); qDebug()<
注意:在removeDatabase之前要保证数据库相关的对象都回收了,所以将db设计成指针,如果db是类成员变量,那么removeDatabase的时候db永远存在,就会失败。
这是自己封装的访问数据库类,工作原理是每次访问数据库都在对应的线程里建立一个连接,并建立db对象,再访问。缺点是需要每次都建立数据库,浪费时间和数据库资源。
下面使用数据库连接池的方式来封装【参考网上的】
3.2、网上借鉴的数据库连接池,问题其实都很多。释放的时候锁应该放最上面【原文是先方式互斥体再使用锁,让我弄了好久】
ConnectPool.h
#ifndef CONNECTPOOL_H
#define CONNECTPOOL_H
#include
#include
#include
#include
#include
class ConnectPool : public QObject
{
Q_OBJECT
public:
static void release(); //关闭所有数据库连接
static QSqlDatabase openConnection(); //获取数据库连接
static void closeConnection(QSqlDatabase connection); //释放数据库连接回连接池
~ConnectPool();
public:
static ConnectPool& getInstance();
private:
ConnectPool();
ConnectPool(const ConnectPool &other)=default;
ConnectPool& operator=(const ConnectPool &other)=default;
QSqlDatabase createConnection(const QString &connectionName); //创建数据库连接
QQueue usedConnectionNames; //已使用的数据库连接名
QQueue unusedConnectionNames; //未使用的数据库连接名
//数据库信息
QString hostName;
QString databaseName;
QString username;
QString password;
QString databaseType;
bool testOnBorrow; //取得连接的时间验证连接是否有效
QString testOnBorrowSql; //测试访问数据库的SQL
int maxWaitTime; //最大等待时间
int waitInterval; //尝试获取连接时等待间隔时间
int maxConnectionCount; //最大连接数
static QMutex mutex;
static QWaitCondition waitConnection;
static ConnectPool *instance;
signals:
public slots:
};
#endif // CONNECTPOOL_H
ConnectPool.cpp
#include "connectpool.h"
QMutex ConnectPool::mutex;
QWaitCondition ConnectPool::waitConnection;
ConnectPool* ConnectPool::instance = nullptr;
ConnectPool::ConnectPool()
{
hostName = "192.168.1.126";
databaseName = "source_data";
username = "root";
password = "zhuxiaoyong1212";
databaseType = "QMYSQL";
testOnBorrow = true;
testOnBorrowSql = "SELTCT 1";
maxWaitTime = 1000;
waitInterval = 200; //尝试获取连接时等待间隔时间
maxConnectionCount = 5;
}
ConnectPool::~ConnectPool()
{
foreach (QString connectionName, usedConnectionNames) {
QSqlDatabase::removeDatabase(connectionName);
}
foreach (QString connectionName, unusedConnectionNames) {
QSqlDatabase::removeDatabase(connectionName);
}
}
ConnectPool &ConnectPool::getInstance()
{
if(instance==nullptr)
{
QMutexLocker locker(&mutex);
if(nullptr==instance)
{
instance = new ConnectPool();
}
}
return *instance;
}
void ConnectPool::release()
{
QMutexLocker locker(&mutex);
delete instance; //调用析构函数
instance = nullptr;
}
QSqlDatabase ConnectPool::openConnection()
{
ConnectPool &pool = ConnectPool::getInstance();
QString connectionName;
QMutexLocker locker(&mutex);
//已创建的连接数
int connectionCount = pool.unusedConnectionNames.size() + pool.usedConnectionNames.size();
//如果连接已经用完,等待waitInterval毫秒,看是否有可用连接,最大等待maxWaitTime毫秒
for(int i=0;i0)
{
//有已经回收的连接,复用它们
connectionName = pool.unusedConnectionNames.dequeue();
}
else if(connectionCount < pool.maxConnectionCount)
{
//没有已经回收的连接,但是没有达到最大连接数,则创建新连接
connectionName = QString("Connection-%1").arg(connectionCount+1);
}
else
{
//已经达到最大连接数
qDebug()<<"Cannot create more connections";
return QSqlDatabase();
}
//创建连接
QSqlDatabase db = pool.createConnection(connectionName);
//有效连接才放入usedConnectionNames
if(db.isOpen())
{
pool.usedConnectionNames.enqueue(connectionName);
}
return db;
}
void ConnectPool::closeConnection(QSqlDatabase connection)
{
ConnectPool &pool = ConnectPool::getInstance();
QString connectName = connection.connectionName();
QMutexLocker locker(&mutex);//位置别放错了
//如果是我们创建的连接,从used里删除,放入unused
if(pool.usedConnectionNames.contains(connectName))
{
pool.usedConnectionNames.removeOne(connectName);
pool.unusedConnectionNames.enqueue(connectName);
waitConnection.wakeOne();
}
}
QSqlDatabase ConnectPool::createConnection(const QString &connectionName)
{
//连接已经创建过的,复用它,而不是重新创建
if(QSqlDatabase::contains(connectionName))
{
QSqlDatabase db1 = QSqlDatabase::database(connectionName);
if(testOnBorrow)
{
qDebug()<<"Test connection on borrow, execute"<
注意:
1、这里的原理是仿照线程池的原理,用两个队列来存使用的和没使用的数据库连接名,然后在各自的地方或线程处使用这个连接名。这里有个问题:可能会跨线程调用数据库连接,注意,经过测试,5.12版本到5.13版本一直不支持这个操作,无奈又退到5.10。看过外帖子,貌似是Qt自己的bug,但是至今2019.09.06没修复。
2、在使用了Qt5.13版本时,发现Qt根本没有QMysql驱动,即打印当前可用数据库驱动没有MySql【按理说是文章开头那张表】。
3.3、自己封装的数据库连接池,借鉴了上面的
MyConnection.h
#ifndef MYCONNECTION_H
#define MYCONNECTION_H
#define MYDBP_VALUE_0 0
#include
#include
#include
#include
#include
#include
#include "mymethod.h"
#include "includes.h"
class MyConnection
{
public:
static MyConnection* getInstace();
static QSqlDatabase getDb();//获取一个db
static void removeDb(QSqlDatabase db);//回收一个db
static void clearAllDb();//清楚所有连接
void setCfg(DbConfig cfg);
private:
MyConnection();
static MyConnection* singleton;
~MyConnection();
private://运算相关
QQueue freeQueue,busyQueue;//可用连接队列,繁忙队列
static std::mutex m_mutex;
static std::condition_variable cv;
private://数据库配置相关
QString dbIp;
QString dbName;
QString userName;
QString password;
QString dbType;
int maxConnectionCount; // 最大连接数
DbConfig cfg;
};
#endif // MYCONNECTION_H
MyConnection.cpp
#include "myconnection.h"
/*****************************************************************/
//作者:朱小勇
//函数名称:构造函数
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
MyConnection::MyConnection()
{
Mymethod::record("construct dp connection pool.",PRINT_INFO);
dbIp = "192.168.1.1";
dbName = "ea_phm";
userName = "root";
password = "zhuxiaoyong1212";
dbType = "QMYSQL";
maxConnectionCount = DB_CONNET_COUNT;// 最大连接数
}
/*****************************************************************/
//作者:朱小勇
//函数名称:数据库设置
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
void MyConnection::setCfg(DbConfig cfg)
{
dbIp = cfg.hostIp;
dbName = cfg.databaseName;
userName = cfg.username;
password = cfg.password;
dbType = "QMYSQL";
Mymethod::record("db connection initialized,database name:"+dbName,PRINT_INFO);
}
/*****************************************************************/
//作者:朱小勇
//函数名称:析构函数
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
MyConnection::~MyConnection()
{
clearAllDb();
if(singleton != nullptr)
{
delete singleton;
singleton = nullptr;
}
}
MyConnection* MyConnection::singleton = new MyConnection();//静态变量初始化
std::mutex MyConnection::m_mutex;
std::condition_variable MyConnection::cv;
/*****************************************************************/
//作者:朱小勇
//函数名称:返回单例对象
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
MyConnection* MyConnection::getInstace()
{
return singleton;
}
/*****************************************************************/
//作者:朱小勇
//函数名称:获取一个连接
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
QSqlDatabase MyConnection::getDb()
{
std::unique_lock lck(m_mutex);
MyConnection* instace = MyConnection::getInstace();
int currentConnets = instace->freeQueue.size()+instace->busyQueue.size();
if(currentConnets < instace->maxConnectionCount)//新建连接
{
QSqlDatabase db = QSqlDatabase::addDatabase(instace->dbType,QString("connet_num_%1").arg(currentConnets));
db.setHostName(instace->dbIp);
db.setDatabaseName(instace->dbName);
db.setUserName(instace->userName);
db.setPassword(instace->password);
if(!db.open())
{
QSqlError tempErr = db.lastError();
Mymethod::record(tempErr.text(),PRINT_ERR);
return QSqlDatabase();
}
if(db.isValid()&&db.isOpen())
{
instace->busyQueue.push_back(db.connectionName());
return db;
}
}
if(instace->freeQueue.size() > MYDBP_VALUE_0)//有空闲的连接直接使用
{
QSqlDatabase db = QSqlDatabase::database(instace->freeQueue.front());
db.setHostName(instace->dbIp);
db.setDatabaseName(instace->dbName);
db.setUserName(instace->userName);
db.setPassword(instace->password);
if(!db.open())
{
QSqlError tempErr = db.lastError();
Mymethod::record(tempErr.text(),PRINT_ERR);
return QSqlDatabase();
}
if(db.isValid()&&db.isOpen())
{
instace->busyQueue.push_back(db.connectionName());//存入繁忙队列
instace->freeQueue.pop_front();//从空闲队列删除
return db;
}
}
if((instace->freeQueue.size()==MYDBP_VALUE_0)&&(instace->busyQueue.size()==instace->maxConnectionCount))//无空闲的连接,等待外部释放
{
Mymethod::record(QString("cannot create more connections,used db connection:%1,unused db connection:%2").arg(instace->busyQueue.size()).arg(instace->freeQueue.size()),PRINT_ERR);
while(instace->freeQueue.size()==MYDBP_VALUE_0)
{
cv.wait(lck);
}
QSqlDatabase db = QSqlDatabase::addDatabase(instace->dbType,instace->freeQueue.front());
db.setHostName(instace->dbIp);
db.setDatabaseName(instace->dbName);
db.setUserName(instace->userName);
db.setPassword(instace->password);
if(!db.open())
{
QSqlError tempErr = db.lastError();
Mymethod::record(tempErr.text(),PRINT_ERR);
return QSqlDatabase();
}
if(db.isValid()&&db.isOpen())
{
instace->busyQueue.push_back(db.connectionName());//存入繁忙队列
instace->freeQueue.pop_front();//从空闲队列删除
return db;
}
}
return QSqlDatabase();
}
/*****************************************************************/
//作者:朱小勇
//函数名称:删除连接
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
void MyConnection::removeDb(QSqlDatabase db)
{
std::unique_lock lck(m_mutex);
MyConnection* instace = MyConnection::getInstace();
if(instace->busyQueue.contains(db.connectionName()))
{
instace->busyQueue.removeOne(db.connectionName());
instace->freeQueue.push_back(db.connectionName());
}
cv.notify_one();
}
/*****************************************************************/
//作者:朱小勇
//函数名称:清除所有连接
//函数参数:NULL
//函数返回值:NULL
//函数作用:NULL
//备注:NULL
/*****************************************************************/
void MyConnection::clearAllDb()
{
std::unique_lock lck(m_mutex);
MyConnection* instace = MyConnection::getInstace();
for(auto connct : instace->freeQueue)
{
QSqlDatabase::removeDatabase(connct);
}
for(auto connct : instace->busyQueue)
{
QSqlDatabase::removeDatabase(connct);
}
}
我自己封装这个相比于网上广为流传的,少了等待操作。所以当外部向这个单例类请求获取db后,如果返回的是空db,应该再外面自行等待
QSqlDatabase db = MyConnection::getDb();
while(!db.isValid() || !db.isOpen())
{
Mymethod::record("db is invalid,retry to get a valid db.",PRINT_ERR);
QThread::msleep(VALUE_300);
db = MyConnection::getDb();
}
QSqlQuery q(db);
if(!q.exec(sql))
{
QSqlError tempErr = q.lastError();
Mymethod::record(tempErr.text()+" sql:"+sql,PRINT_ERR);
}
else
{
Mymethod::record("insert "+db.databaseName()+" ok.",PRINT_OK);
}
MyConnection::removeDb(db);
2019.10.24:
今天出现了个问题,刚好是程序员节,md调试了了一天。
问题描述:
线程A不断产生sql语句,需要让两个数据库分别执行这个sql语句。所以在线程A中建立两个子线程B和C,分别对应两个数据库。然后发现两个线程同时启动【即两个线程同时调Qt访问mysql的dll】会报错:
解决:
在其中一个子线程中初次调用的时候延时1s:
static bool test=true;
if(test)
{
QThread::sleep(1);
test=false;
}