Windows 7上编译MongoDB C++ Driver

要从Qt里面访问MongoDB，Qt没有提供MongoDB的Driver，只好用MongoDB官方的C++Driver了。看了MongoDB官方的描述之后，又在网上搜了一番，发现并没有预编译好的版本，没有办法，只能自己动手编译了。看到了好多关于编译这个Driver的Blog，上面的方法都很复杂，要用scons，要用boost，还有的人要动手编译boost并给出参考页面，顿时心里凉了半截。看到官方文档上的描述，似乎最近的版本编译的方法略有简单的趋势，只要按照官方文档一步一步来了。

编译环境

• Windows 7 SP1 64位
• VS2010 (vc10)
• Python 2.7.3
• MongoDB C++ Driver legacy 1.0.0-rc0

编译过程

1. 要有Python环境。我的机器上一直使用的Python 2.7.3，所以就不用再装了。要保证python在环境变量中。

2. 安装scons。下载scons的源码（很好找），解压开里面有setup.py文件，使用命令：

    python setup.py install
   

就可以安装成功了。这里也要保证命令行能访问到scons命令，即Python27\Scripts目录也要在环境变量中。

3. 安装boost。看文档上说用1.55的版本，而且直接使用预编译好的库就行了。这里要给32位的程序用，所以下载32位的版本boost_1_55_0-msvc-10.0-32.exe（http://sourceforge.net/projects/boost/files/boost-binaries/1.55.0-build2/）。注意要对应编译器的版本。下载完以后解压开，我把它解压在 D:\programs\boost_1_55_0，所需要的头文件都在boost下面，库文件都在lib32-msvc-10.0文件夹下面。

4. 下载MongoDB C++ Driver的源码。我选择的是legacy1.0.0-rc0版本，所以直接把这个git库（https://github.com/mongodb/mongo-cxx-driver/releases/tag/legacy-1.0.0-rc0)clone下来就行。然后从命令行进入该文件夹，准备编译。我放在了D:\programs\mongodb\mongo-cxx-driver-legacy-1.0.0-rc0下面。

5. 编译命令，来自官方文档：

    Building a DLL (New in version 2.5.5)
    
    scons
        <--64 or --32>
        --sharedclient
        --dynamic-windows
        --prefix=<install-path>
        --cpppath=<path-to-boost-headers>
        --libpath=<path-to-boost-libs>
        install
   
    The following example will build and install the C++ driver, in a PowerShell:
    
    scons
        --64
        --sharedclient
        --dynamic-windows
        --prefix="%HOME%\mongo-client-install"
        --cpppath="C:\local\boost_1_55_0\include"
        --libpath="C:\local\boost_1_55_0\lib64-msvc-12.0"
        install
   

官方文档上解释了很多很详细，但还是有坑，这里我写成这样：

scons
    --32
    --sharedclient
    --dynamic-windows
    --prefix="D:\programs\mongodb\mongo-client-install"
    --cpppath="D:\programs\boost_1_55_0"
    --libpath="D:\programs\boost_1_55_0\lib32-msvc-10.0"
    --dbg=on

注意几点：

• install不能加，否则会报错。编译完成后头文件和库文件都会放在--prefix指定的路径下面。

• 要编译两次。一次release版不要加--dbg=on，一次是debug版要加。编译结果是两套库。我编译出来的库如下图所示：

  
  编译出来的库

代码示例

好了，库都有了，终于可以开发了。贴一小段代码用于测试：

#include <cstdlib>
#include <iostream>
#include <winsock2.h>  
#include "mongo/client/dbclient.h" // for the driver

void run() {
    mongo::DBClientConnection c;
    c.connect("192.168.1.2");
}

int main() {
    mongo::client::initialize();
    try {
        run();
        std::cout << "connected ok" << std::endl;
    } catch( const mongo::DBException &e ) {
        std::cout << "caught " << e.what() << std::endl;
    }
    getchar();
    return EXIT_SUCCESS;
}

这里还是有坑啊！

• #include <winsock2.h>这个头文件在Windows上必须加，否则会报错："You must include the windows and windows sockets headers before dbclient.h"。

• 这里如果和现有的工程结合的话，还有一个经典的问题要解决：winsock.h和winsock2.h冲突，类型重定义。这个网上有很多解决办法了，解释的比较好的算是这一个：http://www.cppblog.com/tx7do/archive/2008/04/20/47654.html

• 在vc工程中把头文件和库文件都要设置好，包括boost和MongoDB C++ Driver的头文件和库，这个是vc开发的基本要求，就不多说了。我链接的库如下：

    mongoclient.lib
    mongoclient-gd.lib
    boost_thread-vc100-mt-1_55.lib
    boost_system-vc100-mt-1_55.lib
    boost_regex-vc100-1_55.lib
  

到这里就结束了，感觉没个别博客中说的那么复杂，可能官方也在不断的改进。如果那么复杂才能用起来，那么肯定会用的人越来越少。希望以后直接有个安装包就好了。关于怎么用，请参考链接2吧。

参考

1. https://github.com/mongodb/mongo-cxx-driver/wiki/Download%20and%20Compile#choose-a-branch
2. https://github.com/mongodb/mongo-cxx-driver/wiki/Tutorial
3. http://docs.mongodb.org/manual/applications/drivers/