Atualizar versões do driver

A API do construtor setWindowFields não é mais beta. O novo construtor quebra a compatibilidade binária e de origem. Consulte a documentação da API de agregações para obter informações, as novas setWindowFields() assinaturas de método.

Se seu aplicativo usa esse construtor em uma versão anterior à v4.7, atualize seu código-fonte para usar a nova assinatura do método e reconstrua seu binário.

A classe ObjectId e seu campo serialVersionUID foram atualizados para usar um novo formato que reduz problemas de compatibilidade de serialização em diferentes versões do driver.

Se um aplicativo utilizando esta versão ou posterior do driver tenta executar a serialização de objetos Java em quaisquer objetos que contenham um ObjectId e foram serializados por uma versão anterior do driver, Java lança um InvalidClassException.

Para saber mais sobre a serialização de objetos Java, veja a documentação Java em Objetos serializáveis.

Diversas classes e métodos marcados como obsoletos na versão 3.12 foram removidos nesta versão.

Os métodos auxiliares de inserção geram um objeto de resultado de inserção em vez de void.

Os métodos toJson() no BsonDocument, Document e DbObject retornam um formato de JSON relaxado em vez de um formato de JSON rigoroso. Isso torna os documentos JSON mais legíveis, mas pode dificultar a identificação das informações do tipo de BSON, como a diferença entre um número inteiro de 32-bit e 64-bit. Se seu aplicativo depender do formato JSON rigoroso, utilize o modo rigoroso ao ler ou gravar dados. Saiba como especificar o formato JSON na API atual no guia Formato de dados do documento: JSON estendido.

A representação-padrão BSON do valor java.util.UUID foi alterada de JAVA_LEGACY para UNSPECIFIED. Os aplicativos que armazenam ou recuperam valores UUID devem especificar explicitamente qual representação usar. Você pode especificar a representação na propriedade uuidRepresentation de MongoClientSettings.

A representação do UUID que você especifica controla estritamente como o driver decodifica os UUIDs. Nas versões anteriores do driver, se você especificasse a representação JAVA_LEGACY, o driver decodificaria objetos binários dos subtipos 3 e 4 como UUIDs. Na versão 4.0, a representação JAVA_LEGACY funciona somente com subtipo 3.

Para obter uma lista de nós na enumeração UuidRepresentation, consulte a documentação da API v4.0

O pool de conexões não restringe mais o número de threads de fila de espera ou tarefas assíncronas que exigem uma conexão com o MongoDB. O aplicativo deve limitar as solicitações conforme necessário, em vez de depender do driver para lançar um MongoWaitQueueFullException.

O driver deixa de registrar utilizando o pacote java.util.logging (JUL) e somente apoia o framework de registro SLF4J.

Os drivers incorporados e de Android foram removidos. Se o seu aplicativo depender desses drivers, você deverá continuar usando uma versão 3.x do driver Java.

Os uber JARs, mongo-java-driver e mongodb-driver não são mais publicados. Se seu aplicativo depender de um deles, você deverá alternar para mongodb-driver-sync ou mongodb-driver-legacy dependendo de qual API o aplicativo usa. Certifique-se de remover os uber JARs das suas dependências.

As atualizações de várias classes introduziram quebras de compatibilidade binária, como a alteração da assinatura do método para os métodos auxiliares de inserção. Recompile todas as classes vinculadas ao driver nessa versão ou posterior para garantir que elas continuem funcionando.