NOVIDADES

Visão geral

Descubra as novidades de cada versão:

• Versão 4.1

• Versão 4.0

• Versão 3.11

• Versão 3.10

• Versão 3.9

Novidades no 4.1

A versão do driver v4.1 inclui os seguintes novos recursos:

• Descontinua o método storage_options() para o método storage_engine() recém-adicionado em mongocxx::v_noabi::options::index

• Adiciona suporte para o tipo de vetor binário BSON.

  Para obter mais informações, consulte os seguintes recursos:

  • Tipos de BSON de dados binários no manual do MongoDB Server

  • exemplo de uso do vetor binário BSON no Github

• Corrige o bug da versão da API do driver C observado na versão v4.0

• Adiciona uma alteração na opção padrão de configuração do ENABLE_TESTS que foi originalmente lançada para a versão4.0. Para obter mais informações, consulte a descrição da alteração interruptiva na página Atualização.

Para saber mais sobre esta versão, consulte as notas de versão v4.1 no Github.

4.0: quais as novidades

A versão do driver v4.0 inclui os seguintes novos recursos:

• Adiciona um método de getter para o campo start_at_operation_time de uma instância do mongocxx::options::change_stream.

A versão inclui o seguinte bug:

• O CMake pode definir incorretamente a versão da API de um driver C baixado automaticamente como 0.0.0 quando o projeto CMake é configurado mais de uma vez ou com o mesmo valor da versão da API do driver C++ quando BUILD_VERSION é explicitamente definido durante a configuração inicial. O CMake só fará o download automático do driver C com o driver C++ se não conseguir encontrar uma instalação de driver C existente usando find_package(). Esse bug será corrigido em uma futura versão de patch.

Para saber mais sobre esta versão, consulte as notas de versão v4.0 no Github.

Novidades no 3.11

A versão do driver v3.11 inclui os seguintes novos recursos:

• Adiciona suporte para MongoDB Server v8.0.

• Adiciona suporte para queries de intervalo de Queryable Encryption . Para usar esse recurso, seu aplicativo deve se conectar ao MongoDB Server 8.0 ou posterior. Para obter mais informações sobre Queryable Encryption, consulte Queryable Encryption no manual do MongoDB Server .

• Adiciona a função de membro empty() para mongocxx::v_noabi::bulk_write.

A versão inclui o seguinte bug:

• O CMake pode definir incorretamente a versão da API de um driver C baixado automaticamente como 0.0.0 quando o projeto CMake é configurado mais de uma vez ou com o mesmo valor da versão da API do driver C++ quando BUILD_VERSION é explicitamente definido durante a configuração inicial. O CMake só fará o download automático do driver C com o driver C++ se não conseguir encontrar uma instalação de driver C existente usando find_package(). Esse bug será corrigido em uma futura versão de patch.

Para saber mais sobre esta versão, consulte as notas de versão v3.11 no Github.

Novidades no 3.10

O v3.10.0 a versão do driver inclui as seguintes novas funcionalidades:

• Adiciona cabeçalhos de encaminhamento que fornecem declarações não definidoras de tipos de classe bsoncxx e mongocxx . O driver não é compatível com declarações de encaminhamento definidas pelo usuário de qualquer entidade de biblioteca. Para obter a declaração ou definição de uma entidade da biblioteca, inclua sempre o cabeçalho correspondente.

• A opção ENABLE_BSONCXX_USE_POLY_IMPLS do CMake permite selecionar bsoncxx implementações de polyfills17 C++ por padrão quando nenhuma biblioteca de polyfill é solicitada. Esta opção é OFF por padrão.

• A opção BSONCXX_POLY_USE_IMPLS do CMake permite selecionar implementações bsoncxx 1} de polyfills17 do C++ em vez de bibliotecas externas ou da biblioteca padrão do C++ . Esta opção é OFF por padrão.

• Os namespaces bsoncxx::v_noabi e mongocxx::v_noabi não são mais declarados embutidos. As declarações de namespace raiz ainda são suportadas e espera-se que permaneçam equivalentes às definições anteriores. Por exemplo, bsoncxx::document ainda é equivalente a bsoncxx::v_noabi::document e mongocxx::client ainda é equivalente a mongocxx::v_noabi::client.

• Por padrão, quando os nomes de arquivos da biblioteca são compilados com MSVC (conforme detectado pela variável MSVC do CMake), eles são incorporados a uma string de caracteres de tag ABI. Essas strings são semelhantes às seguintes:

  bsoncxx-v_noabi-rhs-x64-v142-md.lib

  Para desabilitar este comportamento, defina o ENABLE_ABI_TAG_IN_LIBRARY_FILENAMES=OFF como parte de sua configuração do CMake.

  A string da tag ABI também pode ser incorporada em nomes de arquivos de metadados pkg-config, semelhantes aos seguintes:

  libbsoncxx-v_noabi-rhs-x64-v142-md.pc

  Para habilitar este comportamento, defina ENABLE_ABI_TAG_IN_LIBRARY_FILENAMES=ON e ENABLE_ABI_TAG_IN_PKGCONFIG_FILENAMES=ON como parte de sua configuração do CMake.

Para saber mais sobre esta versão, consulte as notas de versão v3.10 no Github.

Novidades no 3.9

A versão do driver v3.9 inclui os seguintes novos recursos:

• A imagem do container do driver C++ agora está disponível no Docker Hub.

• O driver baixa automaticamente a dependência do driver MongoDB C se você não fornecer.

• O driver já não constrói testes como parte do alvo all . Para construir testes, defina o BUILD_TESTING=ON como parte da configuração do CMake.

• O driver usa o módulo FetchContent para baixar e construir a biblioteca de polyfill SNMLSTC Core, se não for fornecida pelo sistema, em vez do módulo ExternalProject. Ele também não corrige diretivas include em cabeçalhos MONMLSTC Core.

• Adiciona a opção CMake MONGOCXX_OVERRIDE_DEFAULT_INSTALL_PREFIX. Se essa opção estiver definida como TRUE, a opção CMAKE_INSTALL_PREFIX assumirá como padrão o diretório de construção. O valor padrão desta opção é TRUE.

• Adiciona uma API para gerenciar índices de pesquisa MongoDB .

• Adiciona o recurso VERSIONINFO a bsoncxx.dll e mongocxx.dll.

• Documenta explicitamente que lançar uma exceção de uma chamada de resposta de resposta APM é um comportamento indefinido.

• Não instala prematuramente cabeçalhos MONMLSTC Core durante a etapa de compilação do CMake.

• Requer que um pacote MongoDB C Driver CMake seja encontrado via find_dependency() para todas as configurações de pacote de driver C++ instaladas.

Para saber mais sobre esta versão, consulte as notas de versão v3.9 no Github.