Windows编译MongoDB的C++库,并使用Qt调用
最近想用Qt写一款应用,使用MongoDB数据库。
所以尝试使用CMake编译了Mongo-cxx-driver,对于没编译过的同学们来说,还是有点复杂的,所以写下来,为后来者点灯。
环境
Windows11
Visual Studio 2022
CMAKE 3.26.4
MongoDB 1.27
Boost 1.86.0
编译过程概述
mongo-cxx-driver的编译过程,需要使用mongo-c-driver的依赖,所以需要先编译mongo-c-driver,再编译mongo-cxx-driver。
而mongo-cxx-driver又依赖boost, 所以在编译mongo-cxx-driver之前,需要先编译boost。
下载源码包
下载mongo-c-driver
https://github.com/mongodb/mongo-c-driver/releaseshttps://github.com/mongodb/mongo-c-driver/releases下载mongo-cxx-driver
https://github.com/mongodb/mongo-cxx-driver/releaseshttps://github.com/mongodb/mongo-cxx-driver/releases下载boost
https://github.com/boostorg/boost/releaseshttps://github.com/boostorg/boost/releases
编译mongo-c-driver
将mongo-c-driver源码包解压后,进入到目录下的build目录(可以使用源码包目录下的build目录,也可以自定义)。
cmake设置可以用两种方式——手动命令行输入,和cmake-gui图形设置。
1、手动cmake命令:
cmake -G "Visual Studio 17 2022" "-DCMAKE_INSTALL_PREFIX=D:\Project\Cpp\mongo-cxx-driver\mongo-c-driver\" "-DCMAKE_PREFIX_PATH=D:\Project\Cpp\mongo-cxx-driver\" ..\mongo-c-driver-1.27.6
其中,INSTALL_PATH 是设置后面编译输入路径,这个也可以自定义。
2、直接使用cmake-gui,更直观,也方便修改。
点击Configure, 如果设置没有报错,即可点击Generate,生成build文件。
Generate后,即可以在build目录下发现 mongo-c-driver.sln文件,即可以使用Visual Studio编译库文件。
把debug模式改为release模式,并右键“ALL_BUILD”,选择“生成”。
生成成功后,再右键“INSTALL”,选择“生成”。
如此mongo-c-driver就安装完成了,可以看到在Build文件夹下,生成一个bin文件夹存放*.dll文件,lib文件夹存放*.lib文件,include文件夹都是编码需要的头文件。
编译安装Boost
编译安装Boost的过程相对简单,总的来说就是编译Boost源码后,设置Boost环境变量。
1、运行boost源码包中的bootstrap.bat,在源码包中会生成b2.exe
2、运行b2.exe, 会生成stage目录,里面就是编译完成的boost的库文件
编译mongo-cxx-driver
编译过程类似mongo-c-driver的编译过程,但需要使用mongo-c-driver编译后的库文件。
cmake命令:
cmake -G "Visual Studio 17 2022" "-DBOOST_ROOT=D:\xxxx\boost_1_86_0" "-DCMAKE_PREFIX_PATH=D:\Project\Cpp\mongo-cxx-driver\mongo-cxx-driver" "-DCMAKE_INSTALL_PREFIX=D:\Project\Cpp\mongo-cxx-driver\mongo-cxx-driver" -Dbson-1.0_DIR=D:\Project\Cpp\mongo-cxx-driver\mongo-c-driver\bin\bson-1.0 -Dmongoc-1.0_DIR=D:\Project\Cpp\mongo-cxx-driver\mongo-c-driver\bin\mongoc-1.0 -DBUILD_VERSION=1.27.6 ..\mongo-cxx-driver-r3.10.2
其中的 BOOST_ROOT填写你的boost路径, install_path 写自定义输出路径, bson-1.0_DIR和mongoc-1.0_DIR填写前面编译好的mongo-c-driver对应的路径。
这里还有一个需要注意的地方,mongo-cxx-driver-r3.10.2,要求使用C++17 Polyfill或者更高,如果不使用,则需要在命令中添加
-DENABLE_BSONCXX_POLY_USE_IMPLS=ON
也可以在cmake-gui中设置:
接下来和mongo-c-driver一样的步骤, 在Visual Studio中打开项目,编译即可获得mongo-cxx-driver的库文件。
Qt调用
在Qt 的.pro文件中添加INCLUDEPATH,和LIBS, 将生成的库文件包含进项目。
或者将需要的库文件复制到自定义文件夹中,并在Qt .pro文件中包含,
再添加 boost文件路径:
INCLUDEPATH += $$PWD/libs/include
LIBS += -L$$PWD/libs/mongo-cxx/ -lmongocxx -lbsoncxx
#boost路径
INCLUDEPATH += D:\xxxxx\boost-1.86.0
下面是简要的实现代码, 用来测试本地MongoDB数据库是否能够连接。
mongo.h
#ifndef MONGO_H
#define MONGO_H
#include <QObject>
#include <QDebug>
#include <bsoncxx/builder/stream/document.hpp>
#include <bsoncxx/types.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
#include <bsoncxx/json.hpp>
// #pragma execution_character_set("utf-8");
class Mongo : public QObject
{
Q_OBJECT
public:
explicit Mongo(QObject *parent = nullptr);
~Mongo();
static void connectToMongoDB();
bool connectToHost(QString m_hostName, QString m_port);
private:
mongocxx::instance* m_dbInstance = nullptr;
mongocxx::client* m_client = nullptr;
signals:
};
#endif // MONGO_H
mongo.cpp
#include "mongo.h"
Mongo::Mongo(QObject *parent)
: QObject{parent}
{
bool ret = connectToHost("localhost", "27017");
if(!ret) {
qDebug() << "mongodb连接失败!";
}
}
Mongo::~Mongo()
{
delete m_dbInstance;
m_dbInstance = NULL;
delete m_client;
m_client = NULL;
}
void Mongo::connectToMongoDB(){
}
bool Mongo::connectToHost(QString m_hostName, QString m_port)
{
if(m_hostName=="" || m_port=="")
return false;
mongocxx::uri uri{ QString("mongodb://%1:%2").arg(m_hostName).arg(m_port).toLatin1().data()};
m_dbInstance = new(std::nothrow) mongocxx::instance();
m_client = new(std::nothrow) mongocxx::client(uri);
if (!m_client)
return false;
qDebug() << "连接成功!";
return true;
}
然后运行测试: