C++驱动程序入门

安装所有依赖项。

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

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

• CMake v3.15或更高版本

• pkg-config

下载C++驱动程序。

要从 mongo-cxx-driver Github 存储库下载最新版本的 C++ 驱动程序，请在 shell 中的根目录运行以下命令：

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

配置用于安装的驱动程序。

选择与操作系统相对应的标签页，然后从mongo-cxx-driver-r3.11.1/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 Release
cmake --build . --config Debug
cmake --install . --config Release
cmake --install . --config Debug

在Atlas上创建免费MongoDB 部署。

Complete the MongoDB Get Started guide to set up a new Atlas account and load sample data into a new free tier MongoDB deployment.

保存您的凭证。

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

查找MongoDB Atlas连接字符串。

To retrieve your connection string for the deployment that you created in the previous step, log into your Atlas account and navigate to the Clusters page under the Database section. Click the Connect button for your new deployment.

如果您尚未配置数据库用户， MongoDB将提示您创建并配置新用户。

单击 Connect to your application 部分下的 Drivers 按钮，从 Driver 选择菜单中选择“C++”，然后从 Version 选择菜单中选择与您安装的版本最匹配的版本。

确保取消选择 View full code sample 选项以仅查看连接字符串。

复制连接字符串。

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

更新密码占位符。

将此连接字符串粘贴到首选文本编辑器中的文件中，并将 <db_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;
}

指定连接字符串。

Replace the <connection string> placeholder with the connection string that you copied from the Create a Connection String step of this guide.

运行您的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文件中指定了正确的连接字符串并加载了样本数据。