NOVIDADES

Novidades em 5.1.1

O 5.1. O patch do driver 1 inclui as seguintes alterações:

• Ao usar o mecanismo de autenticação MONGODB-OIDC , você não deve incluir vírgulas no valor da connection string authMechanismProperties . Para saber mais sobre esse comportamento, consulte a seção MONGODB-OIDC do guia Autenticação empresarial.

• Otimiza a taxa de transferência do GridFS removendo a clonagem de array de bytes redundante. Os tipos GridFSDownloadStream e GridFSUploadStream usam o tipo BsonDocument em vez de Document.

Novidades no 5.1

Esta seção inclui as seguintes informações:

• Descontinuações no 5.1

• Melhorias na versão 5.1

• Novos recursos em 5.1

Novidades no 5.0

Esta seção inclui as seguintes informações:

• Depreciações na versão 5.0

• Mudanças comportamentais no 5.0

• Novos recursos no 5.0

Novidades no 4.11

Esta seção inclui as seguintes informações:

• Depreciações na versão 4.11

• Novos recursos na versão 4.11

Novidades no 4.10

As novas funcionalidades da versão do driver do 4,10 incluem:

• Implementação dos métodos Accumulators.percentile() e Accumulators.median() para agregações estatísticas.

• As interfaces no pacote com.mongodb.client.model.search agora são marcadas como @Sealed em vez de @Evolving. Interfaces seladas não devem ser estendidas ou implementadas pelos consumidores da biblioteca.

• Resolvido um problema em que o driver emitia mensagens de registro duplicadas para operações de repetição. O driver emite agora corretamente uma mensagem de registo para cada nova tentativa de operação.

• A interface org.bson.codecs.Parameterizable está obsoleta. Em vez de implementar essa interface em um tipo de Codec personalizado, substitua o método CodecProvider.get() no CodecProvider do codec se o codec for destinado a um tipo parametrizado.

• Suporte para resolvedores de DNS personalizados.

• Suporte para Queryable Encryption (QE). Para saber mais sobre os requisitos para usar o recurso QE, consulte a Queryable Encryption Driver Compatibility Table.

Novidades no 4.9

Os novos recursos da versão do driver 4.9 incluem:

• Foi adicionada uma nova exceção para identificar quando um construtor anotado pelo BsonCreator contém parâmetros com anotações diferentes de BsonProperty ou BsonId.

• Foi alterado o formato da mensagem de registro para mensagens de monitoramento de comando relatadas pelo pacote org.mongodb.driver.protocol.command.

• Adição de suporte para o estágio de pipeline de agregação $documents à classe auxiliar Aggregates.

• Adicionado MongoClientSettings.Builder.applyToLoggerSettings() e LoggerSettings.Builder.maxDocumentLength() métodos que permitem especificar um comprimento máximo para a representação JSON estendida de um documento BSON em uma mensagem de registro.

4.8: quais as novidades

As mudanças comportamentais com a versão 4.8 do driver incluem:

• Requisito que você adicione uma dependência explícita no módulo org.bson.codecs.record se seu aplicativo distribuir o driver em um container OSGi e depender do driver para codificar e decodificar registros Java.

• Registro de novas mensagens de conexão no nível DEBUG em vez de em INFO.

Os novos recursos da versão do driver 4.8 incluem:

• Suporte para autenticação com AWS. O driver tem uma dependência opcional do AWS SDK versão 1 e versão 2.

• Suporte para obter credenciais do ambiente para GCP e Azure para criptografia em uso.

• Suporte para desserialização de registros contendo componentes com parâmetros genéricos.

• Suporte para desserialização de registros contendo componentes com tipos de contêiner mais específicos, como SortedSet, NavigableMap, LinkedList ou TreeSet.

• Suporte para tipos de registro recursivos, registros cujas definições de tipo contêm ciclos.

• Inclusão do campo disambiguatedPaths nos eventos de atualização do stream de alterações quando o recurso de servidor showExpandedEvents está ativado no MongoDB v6.1 e posterior. Saiba mais sobre este campo em getDisambiguatedPaths() Documentação da API. Saiba mais sobre a configuração showExpandedEvents na documentação do servidor Expanded Events .

Novidades no 4.7.1

O driver 4.7.1 corrige um bug que afeta a criptografia no nível do campo do lado do cliente e a Queryable Encryption. O bug pode causar corrupção de dados ao girar Chaves de criptografia de dados (DEKs) criptografadas com uma Chave mestre do cliente hospedada no Google Cloud Key Management Service ou Azure Key Vault. O bug estava presente na versão 4.7.0 do driver no método RewrapManyDataKey e causa a perda de suas DEKs.

O que há de novo em 4.7

Os novos recursos da versão do driver 4.7 incluem:

• Suporte completo adicionado para MongoDB 6.0.

• Adicionadas as seguintes melhorias de suporte ao fluxo de mudança:

  • Suporte aprimorado pré e pós-imagem para fluxos de alteração. Os auxiliares de observação de fluxo de alteração agora aceitam whenAvailable e required para a opção fullDocument . Consulte a documentação de referência do fluxo de alterações para obter mais informações.

  • Foi adicionada uma nova opção fullDocumentBeforeChange, que aceita whenAvailable e required.

  • Alterar eventos agora inclui um campo fullDocumentBeforeChange quando configurado para exibição em sua coleção MongoDB.

  • Adicionado suporte showExpandedEvents para fluxos de mudança.

  • Adicionado suporte wallTime à classe ChangeStreamDocument .

• Suporte de criação de índice agrupado adicionado.

• Suporte para novos recursos relacionados à criptografia Queryable Encryption, incluindo suporte para criptografia automática (MongoDB v6.0 Enterprise ou posterior é necessário) e criptografia manual.

  • Suporte para a nova biblioteca compartilhada do Queryable Encryption, que remove a necessidade do mongocryptd processo do . A biblioteca compartilhada de criptografia consultável exige org.mongodb:mongodb-crypt versão 1.5.1.1 ou posterior.

• Foi adicionada uma nova API para o gerenciamento de chaves de criptografia.

• Foram adicionados métodos de API do construtor para mais estágios de agregação, incluindo $search/$searchMeta (somente Atlas), $densify e $fill. Saiba mais sobre esses métodos na página Construtor de agregados.

• Foi adicionada a anotação BsonExtraElements que pode ser usada com codificação e decodificação POJO. BsonExtraElements permite decodificar objetos que podem receber novos campos no futuro sem exigir que os desenvolvedores mapeiem explicitamente esses novos campos.

• Otimizações de desempenho, incluindo:

  • Implementações sem travamento do pool de sessão do servidor e do pool de buffer.

  • Uma nova implementação de limpeza de DBCursor que usa a API Cleaner do Java em vez de finalização, disponível no Java 9 ou posterior.

• A API do construtor setWindowFields não é mais um recurso beta. Mudanças na API quebram a compatibilidade binária e de origem. Consulte Alterações importantes na versão 4.7 para obter mais informações.

4.6: quais as novidades

As novas funcionalidades da versão do driver Java 4,6 incluem:

• O buffer pool agora é compartilhado por todas as MongoClient instâncias. O conjunto de buffers remove buffers que ficaram inativos por um minuto.

• Foi adicionada uma API para especificar fornecedores de credenciais do AWS KMS para criptografia em nível de campo do lado do cliente (CSFLE). Consulte o AutoEncryptionSettings.Builder.kmsProviderPropertySuppliers() e os clientEncryptionSettings.Builder.kmsProviderPropertySuppliers() Documentação da API para obter mais informações.

• Compatibilidade adicionada ao org.mongodb:mongodb-crypt, uma dependência do CSFLE, para hardware baseado em ARM1 da Apple.

• Foi adicionada uma interface de provedor de serviços (SPI) para permitir que o driver especifique um cliente DNS personalizado. Consulte a documentação da API da interface DnsClient e DnsClientProvider para obter mais informações.

• Adicionado suporte de driver para codificação e decodificação entre registros Java e documentos BSON, que estão habilitados por padrão. Consulte Formato de dados do documento: registros para obter mais informações.

Novidades no 4.5.1

Se o servidor DNS retornar um erro de NXDomain, indicando um domínio inexistente, o driver do 4,5,1 não lançará mais uma exceção.

Novidades no 4.5

As novas funcionalidades da versão 4,5 do driver Java incluem:

• Foi adicionado suporte para especificar nomes de serviços personalizados de registros de recursos SRV. Consulte a configuração do srvServiceName no guia Opções de Conexão para mais informações.

• Foi adicionado suporte para personalizar a representação de UUID em um registro de codec usando o método CodecRegistries.withUuidRepresentation().

• Adicionado suporte para substituir as configurações de ouvinte nos construtores ClusterSettings, ServerSettings e ConnectionPoolSettings.

• Todos os eventos recebidos por ClusterListener, ServerListener e ServerMonitorListener agora são totalmente ordenados usando uma relação happens-before quando os ouvintes não são compartilhados por instâncias diferentes do MongoClient. Para saber mais sobre a ordem antes de acontecer,consulte Ordem antes deacontecer na Especificação da linguagem Java.

• Foram adicionadas classes EnumCodec e EnumCodecProvider para separar o suporte de codec para tipos de enum da classe PojoCodec. Os registros de codec padrão, que você pode acessar a partir das interfaces do MongoClientSettings e Bson, agora incluem as classes de codec do enum. Se o seu aplicativo usar um codec de enumeração personalizado e um dos registros padrão, certifique-se de ordená-los conforme descrito na seção sobre substituição de codecs.

• Resolveu problemas de desempenho que afetaram as versões 4.4 e 4.3 do driver. O desempenho nesta versão é semelhante ao desempenho em 4.2.

• Foi resolvido um problema no qual os erros originados da recuperação da descrição do cluster não eram passados para a chamada de resposta do assinante onError

• Foi resolvido um problema com a liberação de instâncias ByteBuf quando você se conecta com a compactação habilitada.

• Foi removida uma dependência desnecessária dos pacotes javax.annotation.* do pacote org.mongodb.driver-core OSGi.

O que há de novo em 4.4

As novas funcionalidades da versão do driver do 4,4 Java incluem:

• Compatibilidade com MongoDB 5.1 e suporte para Java 17

• Adicionado suporte para dicas de índice em um AggregateIterable

• Adicionado suporte para os estágios de agregação $merge e $out em secundários

• Uso do método mergeObjects() no construtor Updates

• DocumentCodec não ignora um CodecRegistry ao escrever em uma instância do Iterable ou Map

Novidades no 4.3

As novas funcionalidades da versão do driver do 4,3 Java incluem:

• Suporte adicionado para a API estável do MongoDB. Para obter mais informações, consulte nosso Guia de API estável.

  Observação

  A partir de fevereiro de 2022, a API Versionada é conhecida como a API estável. Todos os conceitos e funcionalidades permanecem os mesmos com essa mudança de nomenclatura.

• Suporte adicionado para conexão com Instâncias sem servidor do MongoDB Atlas. Para obter mais informações sobre a instalação, consulte nossa documentação sobre como criar uma nova instância sem servidor

• Foi adicionada uma API de construtor para o estágio de pipeline setWindowFields para permitir o uso de operadores de janela

• Suporte adicionado para configurar Netty io.netty.handler.ssl.SslContext

• Adicionado suporte para leituras de snapshots para ClientSession

• Taxa limitada de estabelecimento de novas conexões por pool de conexões

• Removeu a maioria das restrições aos caracteres permitidos nos nomes dos campos dos documentos que você insere ou substitui. Essa é uma mudança comportamental para qualquer aplicativo que dependa da aplicação dessas restrições pelo lado do cliente.

A tabela a seguir mostra o status de restrição em caracteres permitidos nos nomes de campo dos documentos:

4.2: quais as novidades

As novas funcionalidades da versão 4.2 do driver Java incluem:

• Adição de armazenamentos de chaves do Azure e do GCP à criptografia no nível do campo no lado do cliente

• Adição de tickets de cache Kerberos para reutilização em várias solicitações de autenticação

• MongoClients adicionados instâncias com MongoClientSettings ou ConnectionString como a configuração

• Uso do explain() método ao encontrar e agregar comandos

• Adição de um JsonObject classe para tornar a codificação e a decodificação para JSON mais eficientes, evitando uma representação intermediária do mapa

• Adição de uma BsonRepresentação anotação que permite representar os ObjectId valores BSON como String no POJO aulas

• Adição de um arquivo Filters.empty() método

Novidades no 4.1

As novas funcionalidades da versão do driver do 4.1 Java incluem:

• Redução significativa nos tempos de failover percebidos pelo cliente durante eventos de manutenção planejados

• Os métodos update() e delete() agora suportam dicas de índice

• O método find() é compatível com allowDiskUse() para tipos que exigem muita memória para serem executados na RAM

• Foi adicionado suporte ao mecanismo de autenticação MONGODB-AWS usando as credenciais do Amazon Web Services (AWS) Identity e Access Management (IAM)

• A autenticação exige menos viagens de ida e volta para o servidor, resultando em uma configuração de conexão mais rápida

4.0: quais as novidades

Esta versão não adiciona novos recursos.