Comienza con el driver de C++

Instala todas las dependencias.

Antes de comenzar este tutorial, asegúrate de tener las siguientes dependencias instaladas en tu entorno de desarrollo:

• Compilador que admite C++17, como GCC, Clang o Visual Studio

• CMake v3.15 o posterior

• pkg-config

Descarga el driver de C++.

Para descargar la última versión del controlador C++ desde el repositorio mongo-cxx-driver de Github, ejecuta los siguientes comandos en tu shell desde el directorio raíz:

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

Configura el driver para la instalación.

Selecciona la pestaña correspondiente a tu sistema operativo y ejecuta el siguiente comando desde tu directorio 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  \

Compila e instala el controlador.

Selecciona la pestaña correspondiente a tu sistema operativo y ejecuta los siguientes comandos para instalar el controlador:

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

cmake --build . --config Release
cmake --build . --config Debug
cmake --install . --config Release
cmake --install . --config Debug

Crea una implementación gratuita de MongoDB en Atlas.

Completa la Guía de inicio de MongoDB para configurar una nueva cuenta de Atlas y cargar datos de muestra en una nueva implementación de MongoDB de nivel gratuito.

Guarda tus credenciales.

Después de crear un usuario de base de datos, guardar el nombre de usuario y la contraseña de ese usuario en una ubicación segura para usarlos en un paso próximo.

Encuentra tu cadena de conexión de MongoDB Atlas.

Para recuperar su cadena de conexión para la implementación que creó en el paso anterior, inicie sesión en su cuenta de Atlas y navegue hasta la Clusters Página en la sección Database. Haga clic en el botón Connect para su nueva implementación.

Si aún no tienes un usuario de base de datos configurado, MongoDB te pedirá que crees y configures un nuevo usuario.

Haz clic en el botón Drivers en la sección Connect to your application y selecciona “C++” del menú de selección Driver y la versión que mejor coincida con la versión que instalaste del menú de selección Version.

Asegúrate de que la opción View full code sample esté desmarcada para ver solo la cadena de conexión.

Copie su cadena de conexión.

Haz clic en el botón a la derecha de la cadena de conexión para copiarla en el portapapeles, como se muestra en la siguiente captura de pantalla:

Actualiza el marcador de posición de la contraseña.

Pega esta cadena de conexión en un archivo en tu editor de texto preferido y reemplaza el marcador de posición <db_password> con la contraseña de tu usuario de base de datos. La cadena de conexión ya está completada con el nombre de usuario de tu usuario de base de datos.

Guarda este archivo en una ubicación segura para usarlo en el siguiente paso.

Crea un directorio de proyecto.

Desde su directorio raíz, ejecute el siguiente comando en su shell para crear un directorio llamado cpp-quickstart para este proyecto:

mkdir cpp-quickstart

Ejecuta los siguientes comandos para crear un archivo de aplicación quickstart.cpp en el directorio cpp-quickstart:

cd cpp-quickstart
touch quickstart.cpp

Crea tu aplicación de controlador en C++.

Copie y pegue el siguiente código en el archivo quickstart.cpp, que hace un query en la colección movies en la base de datos sample_mflix:

#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;
}

Asigna la cadena de conexión.

Reemplaza el marcador de posición <connection string> con la cadena de conexión que se copió del paso Crear una cadena de conexión de esta guía.

Ejecuta tu aplicación C++.

En tu shell, ejecuta los siguientes comandos para compilar y ejecutar esta aplicación:

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

La salida de la línea de comandos contiene detalles sobre el documento de película recuperado:

{ "_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",
...

Si encuentras un error o no ves ninguna salida, asegúrate de haber especificado la cadena de conexión correcta en el archivo quickstart.cpp y de haber cargado los datos de muestra.