Atualizar versões do driver

Versão 5.5 Alterações interruptivas

• O driver não é mais compatível com o MongoDB Server versão 4.0. Para saber mais sobre essa alteração, consulte a seção Alterações de suporte do servidor da versão do driver 5.5 .

Versão 5.2 Alterações interruptivas

Esta versão do driver apresenta a seguinte alteração interruptiva:

• Elimina o suporte para o MongoDB Server v3.6. Para saber mais sobre essa alteração, consulte a seção Alterações de suporte do servidor da versão do 5.2 driver.

• Revisa a versão de dependência mongodb-crypt para corresponder à versão dos drivers da JVM . Versões futuras do mongodb-crypt serão lançadas junto com o driver e compartilharão o mesmo número de versão. Você deve atualizar sua dependência mongodb-crypt para v5.2.0 ao atualizar seu driver para esta versão.

Versão 5.1 Alterações interruptivas

Esta versão do driver apresenta a seguinte alteração interruptiva:

• Ao usar o mecanismo de autenticação MONGODB-OIDC , você não deve incluir vírgulas no valor da string de conexão authMechanismProperties .

alteração interruptiva na versão 5.0

Esta versão do driver apresenta a seguinte alteração interruptiva:

• Introduza as seguintes alterações na classe ConnectionId:

  • O construtor ConnectionId agora aceita um valor do tipo long como seu segundo parâmetro em vez do tipo int. Da mesma forma, o construtor agora aceita um valor do tipo Long como seu terceiro parâmetro em vez do tipo Integer. Como essa alteração quebra a compatibilidade binária, recrie qualquer código existente que chame o construtor ConnectionId .

  • O método withServerValue() agora aceita um parâmetro do tipo long em vez do tipo int. Como essa alteração quebra a compatibilidade binária, você deve recompilar qualquer código que chame o método withServerValue().

  • O método getServerValue() agora retorna um valor do tipo Long em vez do tipo Integer . Da mesma forma, o método getLocalValue() retorna um valor do tipo long em vez do tipo int. Como essa alteração quebra a compatibilidade binária e de origem, atualize qualquer código-fonte que use esses métodos e reconstrua seu binário.

• Substitui as seguintes anotações de registro do pacote org.bson.codecs.record.annotations por anotações do mesmo nome do pacote org.bson.codecs.pojo.annotations :

  • BsonId

  • BsonProperty

  • BsonRepresentation

• Altera o tipo de dados do parâmetro de duração do tempo limite connectTimeout para os métodos SocketSettings.Builder.connectTimeout() e SocketSettings.Builder.readTimeout(). O tipo de dados deste parâmetro é agora long em vez de int.

  Nas versões anteriores, esse parâmetro é do tipo int para ambos os métodos. Essa alteração quebra a compatibilidade binária e requer recompilação, mas não requer alterações de código.

• Remove o método Filters.eqFull(), lançado exclusivamente em Beta, que permitia construir um filtro de igualdade ao executar uma pesquisa vetorial. Em vez disso, você pode usar o método Filters.eq() ao instanciar um tipo VectorSearchOptions, conforme mostrado no código a seguir:

  VectorSearchOptions opts = vectorSearchOptions().filter(eq("x", 8));

• Remove a classe implícita org.mongodb.scala.ObservableImplicits.ToSingleObservableVoid. O tipo org.reactivestreams.Publisher[Void] não converte mais automaticamente para org.mongodb.scala.SingleObservable[Void]. A API também expõe org.mongodb.scala.Observable[Unit] em vez de org.mongodb.scala.Observable[Void].

  Para obter mais informações, consulte a documentação de tração observável da API Scala.

• Altera como ClusterSettings calcula a configuração ClusterConnectionMode, tornando-a mais consistente usando o nome do conjunto de réplicas especificado, independentemente de como ela é configurada. Anteriormente, o driver tratava o nome do conjunto de réplicas somente se ele fosse definido na string de conexão.

  Por exemplo, as duas amostras de código a seguir retornam o valor ClusterConnectionMode.MULTIPLE. Anteriormente, o segundo exemplo retornava ClusterConnectionMode.SINGLE.

  ClusterSettings.builder()
      .applyConnectionString(new ConnectionString("mongodb://127.0.0.1:27017/?replicaSet=replset"))
      .build()
      .getMode()

  ClusterSettings.builder()
      .hosts(Collections.singletonList(
              new ServerAddress("127.0.0.1", 27017)
      ))
      .requiredReplicaSetName("replset")
      .build()
      .getMode()

• BsonDecimal128 os valores respondem às chamadas de método da mesma forma que os valores Decimal128 . BsonDecimal128.isNumber() agora retorna true e BsonDecimal128.asNumber() retorna o equivalente BsonNumber.

• Remove os métodos ServerAddress getSocketAddress() e getSocketAddresses().

  Em vez de getSocketAddress(), utilize o método de instância getByName() de java.net.InetAddress.

  Em vez de getSocketAddresses(), utilize o método de instância getAllByName() de java.net.InetAddress.

• Remove os métodos UnixServerAddress getSocketAddress() e getUnixSocketAddress().

  Em vez de getSocketAddress(), utilize o método de instância getByName() de java.net.InetAddress.

  Em vez de getUnixSocketAddress(), construa uma instância de jnr.unixsocket.UnixSocketAddress. Passe o caminho completo do arquivo de soquete UNIX para o construtor. Por padrão, o MongoDB cria um arquivo de soquete UNIX localizado em "/tmp/mongodb-27017.sock". Para saber mais sobre a classe UnixSocketAddress, consulte a documentação da API UnixSocketAddress.

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

• Remove o método isSlaveOk() das classes ReadPreference e TaggableReadPreference . Para verificar se uma preferência de leitura permite a leitura de um membro secundário de um conjunto de réplicas, use os métodos isSecondaryOk() dessas classes.

• Remove os métodos auxiliares DBCollection.getStats() e DBCollection.isCapped() do comando collStats. Em vez desses métodos, você pode utilizar o estágio de pipeline de agregação $collStats.

• Remove as classes MapCodec e IterableCodec . Em vez de MapCodec, use MapCodecProvider. Em vez de IterableCodec , use CollectionCodecProvider ou IterableCodecProvider para tipos de Iterable que não são tipos Collection .

• Remove os métodos sharded() e nonAtomic() das classes MapReducePublisher e MapReduceIterable .

• Remove os seguintes métodos para utilizar com índices geoHaystack :

  • Indexes.geoHaystack()

  • IndexOptions.getBucketSize()

  • IndexOptions.bucketSize()

  Em vez disso, você pode usar o estágio de pipeline de agregação $geoNear ou um operador de query geoespacial em um índice 2d. Para obter mais informações, consulte a página de queries geoespaciais no manual do MongoDB Server.

• Remove a opção oplogReplay das operações de localização. Os seguintes métodos do oplogReplay não estão mais disponíveis:

  • DBCursor.oplogReplay()

  • DBCollectionFindOptions.isOplogReplay()

  • DBCollectionFindOptions.oplogReplay()

  • FindPublisher.oplogReplay()

  • FindIterable.oplogReplay()

• Remove os seguintes construtores Exception :

  • MongoBulkWriteException(BulkWriteResult, List<BulkWriteError>, WriteConcernError, ServerAddress)

  • MongoCursorNotFoundException(long, ServerAddress)

  • MongoQueryException(ServerAddress, int, String)

  • MongoQueryException(ServerAddress, int, String, String)

  • MongoQueryException(MongoCommandException)

• Remove as seguintes sobrecargas para o método BulkWriteResult.acknowledged() :

  • acknowledged(Type, int, List<BulkWriteUpsert>)

  • acknowledged(Type, int, Integer, List<BulkWriteUpsert>)

  • acknowledged(int, int, int, Integer, List<BulkWriteUpsert>)

• Remove os seguintes construtores ChangeStreamDocument :

  • ChangeStreamDocument(String, BsonDocument, BsonDocument, BsonDocument, TDocument, TDocument, BsonDocument, ...)

  • ChangeStreamDocument(String, BsonDocument, BsonDocument, BsonDocument, TDocument, BsonDocument, BsonTimestamp, ...)

  • ChangeStreamDocument(OperationType, BsonDocument, BsonDocument, BsonDocument, TDocument, BsonDocument, BsonTimestamp, ...)

• Remove os seguintes construtores para eventos:

  • CommandEvent(RequestContext, int, ConnectionDescription, String)

  • CommandEvent(int, ConnectionDescription, String)

  • CommandEvent(RequestContext, long, int, ConnectionDescription, String)

  • CommandFailedEvent(RequestContext, int, ConnectionDescription, String, long, Throwable)

  • CommandFailedEvent(int, ConnectionDescription, String, long, Throwable)

  • CommandStartedEvent(RequestContext, int, ConnectionDescription, String, String, BsonDocument)

  • CommandStartedEvent(int, ConnectionDescription, String, String, BsonDocument)

  • CommandSucceededEvent(RequestContext, int, ConnectionDescription, String, BsonDocument, long)

  • CommandSucceededEvent(int, ConnectionDescription, String, BsonDocument, long)

  • ConnectionCheckedInEvent(ConnectionId)

  • ConnectionCheckedOutEvent(ConnectionId, long)

  • ConnectionCheckedOutEvent(ConnectionId)

  • ConnectionCheckOutFailedEvent(ServerId, long, Reason)

  • ConnectionCheckOutFailedEvent(ServerId, Reason)

  • ConnectionCheckOutStartedEvent(ServerId)

  • ConnectionReadyEvent(ConnectionId)

  • ServerHeartbeatFailedEvent(ConnectionId, long, Throwable)

  • ServerHeartbeatSucceededEvent(ConnectionId, BsonDocument, long)

• Remove a opção errorLabels da classe WriteConcernError . Isso inclui os métodos addLabel() e getErrorLabels() e o construtor que inclui um parâmetro errorLabels . Em vez disso, você pode usar os rótulos de erro incluídos no objeto MongoException que contém o WriteConcernError.

• Remove as seguintes classes do pacote com.mongodb.event :

  • ConnectionAddedEvent

  • ConnectionPoolOpenedEvent

  • ConnectionRemovedEvent

  • ClusterListenerAdapter

  • ConnectionPoolListenerAdapter

  • ServerListenerAdapter

  • ServerMonitorListenerAdapter

  O driver também remove os seguintes métodos relacionados da interface ConnectionPoolListener:

  • connectionAdded()

  • connectionPoolOpened()

  • connectionRemoved()

  Para obter mais informações sobre o pacote com.mongodb.event, consulte a documentação da API.

• Adiciona a opção authorizedCollection para o comando listCollections. Isso introduz uma alteração binária de quebra no método MongoDatabase.listCollectionNames(). Essa alteração não requer nenhuma alteração no código-fonte, mas você deve recompilar qualquer código que use esse método.

• Remove os seguintes métodos e tipos relacionados à interface Stream:

  • MongoClientSettings.Builder.streamFactoryFactory() método. Use o método MongoClientSettings.Builder.transportSettings().

  • MongoClientSettings.getStreamFactoryFactory() método. Use o método MongoClientSettings.getTransportSettings().

  • NettyStreamFactoryFactory classe. Em vez disso, chame o método TransportSettings.nettyBuilder() para criar um objeto NettyTransportSettings. Em seguida, chame o método MongoClientSettings.Builder.transportSettings() para aplicar as configurações.

  • NettyStreamFactory classe.

  • AsynchronousSocketChannelStreamFactory classe.

  • AsynchronousSocketChannelStreamFactoryFactory classe.

  • BufferProvider interface.

  • SocketStreamFactory classe.

  • Stream interface.

  • StreamFactory interface.

  • StreamFactoryFactory interface.

  • TlsChannelStreamFactoryFactory classe.

Alterações significativas na versão 4.8

Esta versão do driver apresenta a seguinte alteração interruptiva:

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

• Requer a adição de uma dependência explícita no módulo org.bson.codecs.record se seu aplicação distribuir o driver em um contêiner OSGi e depender do driver para codificar e decodificar registros Java .

• RecordCodec desserializa POJOs e classes de registro que são especificados como parâmetros de tipo de campos List ou Map para o registro apropriado e tipos de POJO. Anteriormente, este codec os desserializava como valores Document.

  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.

Versão 4.7: mudanças importantes

Esta versão do driver apresenta a seguinte alteração interruptiva:

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

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

Alterações significativas na versão 4.2

Esta versão do driver apresenta a seguinte alteração interruptiva:

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

  Se um aplicação utilizando a versão do driver 4.2 ou posterior 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, consulte Objetos serializáveis na documentação Java.

Alterações significativas na versão 4.0

Esta versão do driver apresenta a seguinte alteração interruptiva:

• Remove várias classes e métodos marcados como obsoletos na versão 3.12.

• Modifica inserir métodos assistente para retornar um objeto InsertOneResult ou InsertManyResult em vez de void.

• Modifica os métodos toJson() nas classes BsonDocument, Document e DbObject para retornar 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 32bits e 64bits. Se o seu aplicação depender do formato JSON rigoroso, utilize o modo rigoroso ao ler ou gravar dados.

• Altera a representação BSON padrão dos valores java.util.UUID 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 um objeto MongoClientSettings.

  A representação do UUID que você especifica controla estritamente como o driver decodifica os UUIDs. Na versão 4.0, a representação JAVA_LEGACY funciona somente com subtipo 3. 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.

  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 aplicação limita 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 e somente suporta 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 para o driver Java , mongo-java-driver e mongodb-driver, não são mais publicados. Se o seu aplicação depender desses uber JARs, remova-os como uma dependência e use um dos seguintes pacotes:

  • Se seu aplicação usar a API atual, adicione o pacote mongodb-driver-sync como dependência.

  • Se seu aplicação usar a API legado , adicione o pacote mongodb-driver-legacy como dependência.

• Várias classes introduzem quebras de compatibilidade binária, como a alteração da assinatura do método para os métodos assistente de inserção. Recompile todas as classes vinculadas ao driver nessa versão ou posterior para garantir que elas continuem funcionando.

Versão do driver 5.5 Alterações no suporte do servidor

O driver v5.5 elimina o suporte para o MongoDB Server 4.0. Para usar o v5.5 driver, você deve se conectar ao MongoDB Server 4.2 ou posterior. Para saber como atualizar seu sistema do MongoDB Server, consulte Notas de versão no manual do MongoDB Server.

Versão do servidor 8.1 Mudanças no suporte

Você não pode usar uma versão 3.x do driver Scala para se conectar a uma implementação do MongoDB executando o MongoDB Server v8.1. Iniciando no MongoDB Server v8.1, o comando buildinfo exige autenticação, causando uma incompatibilidade com o v3.x motorista.

Versão do driver 5.2 Alterações no suporte do servidor

O driver v5.2 elimina o suporte para o MongoDB Server 3.6. Para usar o v5.2 driver, você deve se conectar ao MongoDB Server 4.0 ou posterior. Para saber como atualizar seu sistema do MongoDB Server, consulte Notas de versão no manual do MongoDB Server.

Versão do driver 4.8 Alterações no suporte do servidor

O driver v4.8 elimina o suporte para o MongoDB Server 3.4 e versões anteriores. Para usar o v4.8 driver, você deve se conectar ao MongoDB Server 3.6 ou posterior. Para saber como atualizar seu sistema do MongoDB Server, consulte Notas de versão no manual do MongoDB Server.