1 安装(全程指导,傻瓜安装)
1.1 说明(提供下载链接)
本教程使用版本:mongodb3.6, boost 1_59_0, cmake 3.11.1, mongo-cxx-driver r3.1.4, mongo-c-driver 1.8.0
本教程参考并使用 mongo 官方教程和互联网上的其它教程。
另: 需要安装 vs 2015,编译此版本必须要求的编译器版本。
1.2 安装mongo c drivers
需要先安装好cmake(安装时记得把安装路径加入环境变量中),并把msbuild目录 C:\Program Files (x86)\MSBuild\14.0\Bin 加入环境变量path中。
下载mongoc 解压,编译bson:
cd mongo-c-driver-1.8.0\src\libbson
cmake -G "Visual Studio 14 2015 Win64" "-DCMAKE_INSTALL_PREFIX=C:\mongo-c-driver"
"-DCMAKE_BUILD_TYPE=Release"
msbuild /p:Configuration=Release ALL_BUILD.vcxproj
msbuild /p:Configuration=Release INSTALL.vcxproj
编译mongoc:
cd mongo-c-driver-1.8.0
cmake -G "Visual Studio 14 2015 Win64" "-DENABLE_SSL=WINDOWS" "-DENABLE_SASL=SSPI"
"-DCMAKE_INSTALL_PREFIX=C:\mongo-c-driver" "-DCMAKE_PREFIX_PATH=C:\mongo-c-driver"
"-DCMAKE_BUILD_TYPE=Release"
msbuild /p:Configuration=Release ALL_BUILD.vcxproj
msbuild /p:Configuration=Release INSTALL.vcxproj
查看 C:\mongo-c-driver 已经安装好的文件,并把bin目录加入环境变量。
1.3 安装boost for windows
下载boost-binariers 1_59_0,选择目录,按提示进行安装即可。
1.4 安装mongocxx
编译过程中如果遇到bson mongoc无法找到,请按提示把目录 C:\mongo-cxx-driver 加入。
下载并解压mongocxx,开始编译:
cmake -G "Visual Studio 14 2015 Win64" -DCMAKE_INSTALL_PREFIX=C:\mongo-cxx-driver
-DCMAKE_PREFIX_PATH=c:\mongo-c-driver -DBOOST_ROOT=c:\local\boost_1_59_0
-DLIBBSON_DIR=c:\mongo-c-driver -DLIBMONGOC_DIR=c:\mongo-c-driver
msbuild /p:Configuration=Release ALL_BUILD.vcxproj
msbuild /p:Configuration=Release INSTALL.vcxproj
查看 C:\mongo-cxx-driver 已经安装好的文件,并把bin目录加入环境变量。
1.5 测试
mongo数据库必须已经配置好,才可以测试。
c++代码:
#include <iostream>
#include <bsoncxx/builder/stream/document.hpp>
#include <bsoncxx/json.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
int main(int, char**) {
mongocxx::instance inst{};
mongocxx::client conn{mongocxx::uri{}};
bsoncxx::builder::stream::document document{};
auto collection = conn["testdb"]["testcollection"];
document << "hello" << "world";
collection.insert_one(document.view());
auto cursor = collection.find({});
for (auto&& doc : cursor) {
std::cout << bsoncxx::to_json(doc) << std::endl;
}
}
cmakelists.txt文件:(注意自行检查include文件位置是否正确)
cmake_minimum_required(VERSION 3.0)
project(test)
include_directories("C://mongo-cxx-driver//include//mongocxx//v_noabi//" "C://mongo-cxx-driver//include//bsoncxx//v_noabi//" "C://local//boost_1_59_0")
link_directories("C://mongo-c-driver//lib" "C://mongo-cxx-driver//lib")
link_libraries(bsoncxx.lib mongocxx.lib)
add_executable(test test.cpp)
执行
mkdir build
cd build
cmake -G "Visual Studio 14 2015 Win64" ..
msbuild ALL_BUILD.vcxproj
运行test.exe进行测试,查看数据库是否写入。
2 API学习
2.1 简单连接
2.2 插入数据
2.3 查找数据
2.4 tips
- bug1: 由于vs自定义宏与mongocxx里自定义函数max冲突,导致一系列错误,解决方法:链接。