Atualizar versões do driver

O driver encerra o suporte para conexão com versões do MongoDB Server v3.4 e anteriores. Para saber mais sobre essa alteração, consulte a seção Alterações do suporte da versão do servidor versão 4.8.

Você deve adicionar 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.

O RecordCodec, implementado na versão 4.6, POJOs desserializados e classes de registro que são especificados como parâmetros de tipo dos campos List ou Map de um registro como valores Document em vez das suas respectivas classes. Essa versão agora os desserializa para os tipos de registro e POJO adequados.

Por exemplo, as seguintes definições da classe de registro mostram um registro Book que contém uma List que recebe um parâmetro do tipo Chapter:

public record Book(String title, List<Chapter> chapters) {}
public record Chapter(Integer number, String text) {}

A partir desta versão, o codec desserializa dados no List em classes de registro do Chapter em vez de valores de Document.

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 Aggregates para obter informações sobre as novas assinaturas do método setWindowFields().

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.

O driver v4.8 remove a compatibilidade com o MongoDB Server v3.4 e anterior. Para usar o driver v4.8, seu MongoDB Server deve ser v3.6 ou posterior. Para saber como atualizar seu MongoDB Server, consulte Notas da versão no manual do MongoDB Server.