安装依赖项

在开始本教程之前，请确保您已在开发环境中安装以下依赖项：

• 支持C++17 的编译器，例如 GCC , Clang ，或 Visual Studio

• CMake v3 。15或更高版本

• pkg-config

下载C++驾驶员

要从 存储库下载最新版本的C++ 驾驶员，请在mongo-cxx-driverGithub shell中的根目录运行以下命令：

curl -OL https://github.com/mongodb/mongo-cxx-driver/releases/download/r4.0.0/mongo-cxx-driver-r4.0.0.tar.gz
tar -xzf mongo-cxx-driver-r4.0.0.tar.gz
cd mongo-cxx-driver-r4.0.0/build

配置驾驶员以进行安装

选择与操作系统相对应的标签页，然后从mongo-cxx-driver-r4.0.0/build目录运行以下命令：

cmake ..                                \
    -DCMAKE_BUILD_TYPE=Release          \
    -DCMAKE_CXX_STANDARD=17

'C:\<path>\cmake.exe' .. \
    -G "Visual Studio <version> <year>" -A "x64"         \
    -DCMAKE_CXX_STANDARD=17                     \
    -DCMAKE_INSTALL_PREFIX=C:\mongo-cxx-driver  \

构建并安装驾驶员

选择与您的操作系统相对应的标签页并运行以下命令以安装驾驶员：

cmake --build .
sudo cmake --build . --target install

cmake --build . --config RelWithDebInfo
cmake --build . --target install --config RelWithDebInfo

在 Atlas 上创建免费 MongoDB 部署

请按照 Atlas 入门指南中的步骤，设置新的 Atlas 账户并将示例数据加载到新的免费套餐 MongoDB 部署中。

保存凭证

创建数据库用户后，请将该用户的用户名和密码保存在一个安全位置，以便在后续步骤中使用。

查找 MongoDB Atlas 连接字符串

要检索您在上一步中创建的部署的连接字符串，登录您的Atlas帐户并导航到Database部分，然后单击新部署的Connect按钮。

进入Connect your application 部分，从 选择菜单中选择“C++”，然后从Driver Version选择菜单中选择与您安装的版本最匹配的版本。

选择Password (SCRAM)身份验证机制。

取消选择 Include full driver code example 选项以仅查看连接string 。

复制连接字符串

单击连接string右侧的按钮将其复制到剪贴板，如以下屏幕截图所示：

更新占位符

将此连接字符串粘贴到您首选文本编辑器中的文件中，并将<username>和<password>占位符替换为数据库用户的用户名和密码。

将此文件保存到安全位置，以便在下一步中使用。

创建项目目录

在根目录中，在shell中运行以下命令，为此项目创建一个名为 cpp-quickstart 的目录：

mkdir cpp-quickstart

运行以下命令，在cpp-quickstart目录中创建quickstart.cpp应用程序文件：

cd cpp-quickstart
touch quickstart.cpp

创建C++驾驶员应用程序

将以下代码复制并粘贴到quickstart.cpp文件中，该文件将查询sample_mflix数据库中的movies集合：

#include <cstdint>
#include <iostream>
#include <vector>
#include <bsoncxx/builder/basic/document.hpp>
#include <bsoncxx/json.hpp>
#include <mongocxx/client.hpp>
#include <mongocxx/instance.hpp>
#include <mongocxx/uri.hpp>
using bsoncxx::builder::basic::kvp;
using bsoncxx::builder::basic::make_document;
int main() {
    mongocxx::instance instance;
    mongocxx::uri uri("<connection string>");
    mongocxx::client client(uri);
    auto db = client["sample_mflix"];
    auto collection = db["movies"];
    auto result = collection.find_one(make_document(kvp("title", "The Shawshank Redemption")));
    std::cout << bsoncxx::to_json(*result) << std::endl;
}

指定连接字符串

将 <connection string> 占位符替换为从本指南的“创建连接字符串”步骤中复制的连接字符串。

运行C++应用程序

在shell中，运行以下命令以编译并运行此应用程序：

c++ --std=c++17 quickstart.cpp $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out

dyld[54430]: Library not loaded: @rpath/libmongocxx._noabi.dylib

c++ --std=c++17 quickstart.cpp -Wl,-rpath,/usr/local/lib/ $(pkg-config --cflags --libs libmongocxx) -o ./app.out
./app.out

命令行输出包含有关检索到的电影文档的详细信息：

{ "_id" : { "$oid" : "573a1399f29313caabceeb20" },
"plot" : "Two imprisoned men bond over a number of years, finding solace
and eventual redemption through acts of common decency.",
...
"title" : "The Shawshank Redemption",
...

如果遇到错误或看不到输出，请确保在quickstart.cpp文件中指定了正确的连接字符串并加载了样本数据。