Notas de versão

Descontinuações no 5.1

• O suporte para o MongoDB Server v3.6 está obsoleto e será removido na próxima versão do driver. Para saber como atualizar seu sistema do MongoDB Server , consulte Notas de versão no manual do MongoDB Server .

Melhorias na versão 5.1

• Testes internos da tecnologia de imagem nativa GraalVM. Esses testes envolvem a criação de aplicativos nativos usando a ferramenta de imagem nativa GraalVM.

• Compatibilidade aprimorada para o mecanismo de autenticação MONGODB-OIDC. Para obter mais informações sobre o OIDC, consulte a seção MONGODB-OIDC do guia Enterprise Authentication Mechanisms.

Novos recursos em 5.1

• Introduz a opção serverMonitoringMode de conexão URI. Para obter mais informações sobre essa opção, consulte o guia Opções de conexão .

Depreciações na versão 5.0

• O método org.mongodb.scala.Observable.completeWithUnit() está obsoleto. Esse método não é mais útil porque o driver agora expõe org.mongodb.scala.Observable[Unit] em vez de org.mongodb.scala.Observable[Void]. Isso está relacionado a uma mudança radical sobre Observables nesta versão.

Mudanças comportamentais no 5.0

• O método getElapsedTime() em com.mongodb.event.ConnectionReadyEvent inclui o tempo necessário para entregar o ConnectionCreatedEvent. Ou seja, o tempo retornado inclui a duração do método com.mongodb.event.ConnectionPoolListener.connectionCreated() .

  Os métodos getElapsedTime() em com.mongodb.event.ConnectionCheckedOutFailedEvent e com.mongodb.event.ConnectionCheckedOutEvent incluem o tempo necessário para entregar o com.mongodb.event.ConnectionCheckOutStartedEvent . Ou seja, o tempo retornado inclui a duração do método com.mongodb.eventConnectionPoolListener.connectionCheckOutStarted() .

Novos recursos no 5.0

A versão 5.0 do driver introduz os seguintes recursos:

• Adiciona suporte para a opção authorizedCollection do comando listCollections . Isso foi feito alterando os métodos com.mongodb.client.MongoDatabase.listCollectionNames() . O tipo de retorno agora é com.mongodb.client.ListCollectionNamesIterable, enquanto anteriormente era um MongoIterable<String>. Esta alteração permite que o valor de retorno seja configurado utilizando o método ListCollectionNamesIterable.authorizedCollections() e especificando a opção authorizedCollections . Foram feitas alterações equivalentes nas seguintes classes e interfaces:

  • com.mongodb.reactivestreams.client.MongoDatabase

  • org.mongodb.scala.MongoDatabase

  • com.mongodb.kotlin.client.MongoDatabase

  • com.mongodb.kotlin.client.coroutine.MongoDatabase

  Essas alterações introduzem uma alteração de quebra binária no método listCollectionsNames(). Para obter mais informações sobre o método MongoDatabase.listCollectionNames() e a opção authorizedCollections , consulte a página de manual listCollections MongoDB Server ou Obter uma lista de coleções.

Depreciações na versão 4.11

A versão 4.11 do driver substitui os seguintes itens:

• Os métodos de instância getStats() e isCapped() da classe DBCollection são preteridos. Os comandos de servidor correspondentes são preteridos no MongoDB v6.2 e posterior. Use o estágio do aggregation pipeline do $collStats para recuperar as informações fornecidas por esses métodos. Você pode executar a agregação como mostrado no seguinte exemplo de código:

  Cursor cursor = collection.aggregate(Arrays.asList(
          new BasicDBObject("$collStats",
                  new BasicDBObject("storageStats", new BasicDBObject()))),
          AggregationOptions.builder().build()
  );

  Para determinar se uma coleção é uma coleção limitada, acesse o valor do campo storageStats.capped retornado pela instância Cursor na agregação de exemplo anterior.

  Para saber mais sobre o operador de agregação do $collStats, consulte a entrada manual do servidor $collStats (agregação).

• Os seguintes métodos relacionados ao endereço de rede são preteridos e serão removidos na v5.0:

  • O ServerAddress métodos 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.

  • O método UnixServerAddress getUnixSocketAddress().

    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 o UnixSocketAddress, consulte a documentação da API UnixSocketAddress.

• Os seguintes métodos e tipos relacionados à interface StreamFactory foram preteridos e agendados para remoção na v5.0:

  • streamFactoryFactory() método de MongoClientSettings.Builder

  • getStreamFactoryFactory() método de MongoClientSettings

  • NettyStreamFactoryFactory classe

  • NettyStreamFactory classe

  • AsynchronousSocketChannelStreamFactory classe

  • AsynchronousSocketChannelStreamFactoryFactory classe

  • BufferProvider classe

  • SocketStreamFactory classe

  • Stream classe

  • StreamFactory classe

  • StreamFactoryFactory classe

  • TlsChannelStreamFactoryFactory classe

  Se você configurar o Netty utilizando MongoClientSettings.Builder.streamFactoryFactory(), seu código poderá se assemelhar ao seguinte:

  import com.mongodb.connection.netty.NettyStreamFactoryFactory;
  // ...
  MongoClientSettings settings = MongoClientSettings.builder()
          .streamFactoryFactory(NettyStreamFactoryFactory.builder().build())
          .build();

  Substitua este código pelo TransportSettings.nettyBuilder() como mostrado no exemplo a seguir:

  import com.mongodb.connection.TransportSettings;
  // ...
  MongoClientSettings settings = MongoClientSettings.builder()
          .transportSettings(TransportSettings.nettyBuilder().build())
          .build();

Novos recursos na versão 4.11

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

• Suporte para conexão ao MongoDB usando um proxy SOCKS5. Para saber mais, consulte Conectar ao MongoDB usando um proxy SOCKS5.

• Foi adicionado o método getSplitEvent() à classe ChangeStreamDocument para identificar fragmentos de um evento de fluxo de alteração que excede 16 MB. Você deve usar o estágio de agregação $changeStreamSplitLargeEvent em seu fluxo de alterações para lidar com eventos que excedam 16 MB. Para saber mais, consulte Dividir eventos de transmissão de grande mudança.

• Foi adicionado um construtor de estágio de aggregation para $vectorSearch. Para saber mais, consulte Atlas Vector Search.

• Foram adicionados auxiliares de gerenciamento de índices do Atlas Search. Para saber mais, consulte Índices de Atlas Search.

• Versões atualizadas da biblioteca de compressão Snappy e Zstd. Para saber mais sobre as versões de dependência atuais, consulte Compressão de rede.

• Foram adicionados métodos getElapsedTime() às seguintes classes para monitorar a duração dos eventos do pool de conexões:

  • ConnectionCheckOutFailedEvent

  • ConnectionCheckedOutEvent

  • ConnectionReadyEvent

• Suporte para threads virtuais Java 21 e simultaneidade estruturada. Os componentes internos do driver foram atualizados para evitar a fixação desnecessária de threads virtuais e para preservar o status de interrupção de um thread, já que esse último é importante para a simultaneidade estruturada, onde é usado para cancelamento.

  Para saber mais sobre threads virtuais, consulte a proposta de aprimoramento do JDK de threads virtuais. Para saber mais sobre simultaneidade estruturada, consulte a proposta de aprimoramento JDK de simultaneidade estruturada.

• Documentação da API atualizada para os seguintes tipos:

  • ClusterListener

  • ServerListener

  • ServerMonitorListener