Incluye y vincula el driver en tu programa

Datos de muestra

Los ejemplos en esta página usan el Programa de ejemploview_and_value.cpp del código fuente del controlador C++. Obtenga el código fuente del controlador C++ siguiendo las instrucciones. Guíade descarga e instalación.

En las siguientes secciones, sustituya <path-to-mongo-cxx-driver-sources> por la ruta real donde está el árbol de origen del controlador C++ en su sistema.

No es necesario que ejecutes este programa en un servidor de MongoDB.

Referencias de la biblioteca

Los ejemplos en esta página hacen referencia a los destinos de la librería del driver C++. Los ejemplos de la sección CMake usan el destino mongo::bsoncxx_shared, y los ejemplos de la sección pkg-config usan el paquete libbsoncxx. Puede utilizar los siguientes objetivos alternativos de librerías, dependiendo de las necesidades de su Proyecto:

• CMake: - mongo::bsoncxx_shared - mongo::mongoccxx_shared - mongo::bsoncxx_static - mongo::mongoccxx_static

• pkg-config: - libbsoncxx - libmongocxx - libbsoncxx-static - libmongocxx-static

La disponibilidad de objetivos depende del método de instalación particular.

Solución de problemas

En las siguientes secciones, si encuentra errores, es posible que deba especificar opciones adicionales al comando inicial de CMake. Las opciones específicas dependen de su entorno. Sin embargo, las siguientes opciones solucionan los problemas más comunes:

• Si su compilador no tiene como valor predeterminado al menos C++17, utilice la opción -DCMAKE_CXX_STANDARD=17 de CMake.

• Si instaló el controlador en una ubicación no estándar, especifique la opción -DCMAKE_PREFIX_PATH=/<path-to-mongo-cxx-driver-installation>. Por ejemplo:

cmake -Bbuild -DCMAKE_CXX_STANDARD=17 -DCMAKE_PREFIX_PATH=/opt/mongodb/cxx-driver

Con instalación del controlador

Después de instalar el controlador de C++, puedes usar el comando find_package de CMake para integrar el controlador con tu proyecto.

Para usar el comando find_package, cree un archivo CMakeLists.txt en el directorio del proyecto. El siguiente ejemplo crea un archivo CMakeLists.txt en el directorio del proyecto /home/user/project1 que usa find_package:

cmake_minimum_required (VERSION 3.15)
project (builder_basic LANGUAGES CXX)
find_package (bsoncxx 4.0 REQUIRED)
add_executable (view_and_value /<path-to-mongo-cxx-driver-sources>/examples/bsoncxx/view_and_value.cpp)
# we need target_include_directories because view_and_value.cpp refers to a common example header
target_include_directories (view_and_value PRIVATE /<path-to-mongo-cxx-driver-sources>)
target_link_libraries (view_and_value PRIVATE mongo::bsoncxx_shared)

Luego, ejecutar los siguientes comandos para compilar su proyecto:

$ cd /home/user/project1
$ cmake -Bbuild
$ cmake --build build

Estos comandos devuelven información sobre el proceso de compilación. Después de que se complete la compilación, ejecuta el ejecutable producido en el paso anterior:

$ ./build/view_and_value

La salida es similar a la siguiente:

{ "team" : "platforms", "id" : { "$oid" : "66f4be6fef9eb8b9240619f0" }, "members" : [ "tyler", "jason", "drew", "sam", "ernie", "john", "mark", "crystal" ] }
Got key, key = team
Got String!
Got key, key = id
Got ObjectId!
Got key, key = members
Got Array!
array element: tyler
array element: jason
array element: drew
array element: sam
array element: ernie
array element: john
array element: mark
array element: crystal
as expected, we have a team
document has 3 keys.
document keys are:
team
id
members

Sin instalación de controladores

Como alternativa, puede usar el comando add_subdirectory de CMake sin instalar el controlador de C++. Esta es una técnica avanzada que, a diferencia del comando find_package, no permite especificar restricciones de versión.

Para usar el comando add_subdirectory, cree un archivo CMakeLists.txt en el directorio del proyecto. El siguiente ejemplo crea un archivo CMakeLists.txt en el directorio del proyecto /home/user/project2 que usa add_subdirectory:

cmake_minimum_required (VERSION 3.15)
project (builder_basic LANGUAGES CXX)
# specify a source_dir which is out-of-tree from this project, so also specify bin_dir
add_subdirectory (/<path-to-mongo-cxx-driver-sources> ./build/mongo-cxx-driver)
add_executable (view_and_value /<path-to-mongo-cxx-driver-sources>/examples/bsoncxx/view_and_value.cpp)
# we need target_include_directories because view_and_value.cpp refers to a common example header
target_include_directories (view_and_value PRIVATE /<path-to-mongo-cxx-driver-sources>)
# no mongo:: namespace prefix, since the targets are use directly without installation
target_link_libraries (view_and_value PRIVATE bsoncxx_shared)

Luego, ejecutar los siguientes comandos para compilar su proyecto:

$ cd /home/user/project1
$ cmake -Bbuild
$ cmake --build build

Estos comandos devuelven información sobre el proceso de compilación. Después de que se complete la compilación, ejecuta el ejecutable producido en el paso anterior:

$ ./build/view_and_value

La salida es similar a la siguiente:

{ "team" : "platforms", "id" : { "$oid" : "67207dcf532837a4470cc090" }, "members" : [ "tyler", "jason", "drew", "sam", "ernie", "john", "mark", "crystal" ] }
Got key, key = team
Got String!
Got key, key = id
Got ObjectId!
Got key, key = members
Got Array!
array element: tyler
array element: jason
array element: drew
array element: sam
array element: ernie
array element: john
array element: mark
array element: crystal
as expected, we have a team
document has 3 keys.
document keys are:
team
id
members