Introdução ao driver C++

Instalar dependências

Antes de iniciar este tutorial, verifique se você tem as seguintes dependências instaladas em seu ambiente de desenvolvimento:

• Compilador compatível com C++17, como GCC, Clang ou Visual Studio

• CMake v3.15 ou mais tarde

• pacote-config

Baixe o driver C++

Para baixar a versão mais recente do driver C++ do repositório mongo-cxx-driver do Github, execute os seguintes comandos em seu shell a partir do diretório raiz:

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

Configurar o driver para instalação

Selecione a guia correspondente ao seu sistema operacional e execute o seguinte comando no diretório 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  \

Construa e instale o driver

Selecione a guia correspondente ao seu sistema operacional e execute os seguintes comandos para instalar o driver:

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

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

Crie uma MongoDB deployment gratuita no Atlas

Complete o guia Iniciar com Atlas para configurar uma nova conta Atlas e carregar dados de amostra em uma nova implantação MongoDB de camada gratuita.

Salvar suas credenciais

Depois de criar o usuário do banco de dados, salve o nome de usuário e a senha desse usuário em um local seguro para uso em uma próxima etapa.

Encontre sua connection string do MongoDB Atlas

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas e navegue até a seção Database e clique no botão Connect para a nova implantação.

Vá para a seção Connect your application e selecione "C++" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version .

Selecione o mecanismo de autenticação Password (SCRAM).

Desmarque a opção Include full driver code example para visualizar somente a string de conexão.

Copie a connection string

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

Atualizar os espaços reservados

Cole esta connection string em um arquivo no editor de texto de sua preferência e substitua os placeholders <username> e <password> pelo seu nome de usuário e senha de utilizador de banco de dados.

Salve este arquivo em um local seguro para uso na próxima etapa.

Criar uma diretoria de projeto

A partir do seu diretório raiz, execute o seguinte comando na sua shell para criar um diretório chamado cpp-quickstart para este projeto:

mkdir cpp-quickstart

Execute os seguintes comandos para criar um arquivo de aplicação quickstart.cpp no diretório cpp-quickstart :

cd cpp-quickstart
touch quickstart.cpp

Criar seu aplicação de driver C++

Copie e cole o seguinte código no arquivo quickstart.cpp , que consulta a coleção movies no banco de banco de dados 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;
}

Atribuir a connection string

Substitua o placeholder <connection string> pela string de conexão que você copiou da etapa Criar uma connection string deste guia.

Execute seu aplicação C++

Em sua shell, execute os seguintes comandos para compilar e executar este aplicação:

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

A saída da linha de comando contém detalhes sobre o documento de filme 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",
...

Se você encontrar um erro ou não vir nenhuma saída, verifique se especificou a string de conexão adequada no arquivo quickstart.cpp e se carregou os dados de amostra.