新增功能

5.1版中的弃用功能

• 对MongoDB服务器v3.6的支持已弃用，将在下一个驱动程序版本中删除。有关如何升级MongoDB服务器部署的说明，请参阅MongoDB服务器手册中的发行说明。

5.1版中的改进

• 对GraalVM原生图像技术的内部测试。这些测试涉及使用GraalVM native-image工具构建原生应用程序。

• 增强了对MONGODB-OIDC身份验证机制的支持。有关OIDC的更多信息，请参阅企业身份验证机制指南中的MONGODB-OIDC部分。

5.1版新增功能

• 引入了 serverMonitoringMode 连接 URI 选项。有关此选项的更多信息，请参阅连接选项指南。

5.0版中的弃用

• org.mongodb.scala.Observable.completeWithUnit() 方法已弃用。此方法不再有用，因为驱动程序现在公开了 org.mongodb.scala.Observable[Unit] 而不是 org.mongodb.scala.Observable[Void]。这涉及到本发行版关于 Observables 的重大变更。

5.0版本中的行为变化

• getElapsedTime() 方法在 com.mongodb.event.ConnectionReadyEvent 上包括交付 ConnectionCreatedEvent 所花费的时间。也就是说，返回的时间包括 com.mongodb.event.ConnectionPoolListener.connectionCreated() 方法所持续的时间。

  getElapsedTime() 方法在 com.mongodb.event.ConnectionCheckedOutFailedEvent 和 com.mongodb.event.ConnectionCheckedOutEvent 上包括交付 com.mongodb.event.ConnectionCheckOutStartedEvent 所花费的时间。也就是说，返回的时间包括 com.mongodb.eventConnectionPoolListener.connectionCheckOutStarted() 方法所持续的时间。

5.0版本中的新功能

5.0版本的驱动程序发布引入了以下功能

• 增加了对 authorizedCollection 选项的支持，该选项用于 listCollections 命令。这是通过更改 com.mongodb.client.MongoDatabase.listCollectionNames() 方法实现的。现在的返回类型是 com.mongodb.client.ListCollectionNamesIterable，而之前是 MongoIterable<String>。此更改允许使用 ListCollectionNamesIterable.authorizedCollections() 方法配置返回值并指定 authorizedCollections 选项。对以下类和接口进行了等效的更改

  • com.mongodb.reactivestreams.client.MongoDatabase

  • org.mongodb.scala.MongoDatabase

  • com.mongodb.kotlin.client.MongoDatabase

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

  这些更改引入了对listCollectionsNames()方法的二进制不兼容更改。有关MongoDatabase.listCollectionNames()方法和authorizedCollections选项的更多信息，请参阅listCollections服务器手册页面或获取集合列表。

4.11版本中的弃用功能

4.11驱动程序版本弃用了以下项

• DBCollection类的getStats()和isCapped()实例方法已被弃用。相应的服务器命令在MongoDB v6.2及以后的版本中也被弃用。请使用$collStats聚合管道阶段来获取这些方法提供的信息。您可以使用以下代码示例运行聚合

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

  要确定集合是否为固定集合，请访问上一个示例聚合中由Cursor实例返回的storageStats.capped字段的值。

  要了解关于 $collStats 聚合运算符的更多信息，请参阅$collStats (aggregation) 服务器手册条目。

• 以下与网络地址相关的函数已弃用，将在 v5.0 版本中删除。

  • ServerAddress 方法 getSocketAddress() 和 getSocketAddresses()。

    代替 getSocketAddress()，使用 java.net.InetAddress 的 getByName() 实例方法。

    代替 getSocketAddresses()，使用 java.net.InetAddress 的 getAllByName() 实例方法。

  • UnixServerAddress 方法 getUnixSocketAddress()。

    不要使用getUnixSocketAddress()，而是构建一个jnr.unixsocket.UnixSocketAddress实例。将UNIX套接字文件的完整路径传递给构造函数。默认情况下，MongoDB创建的UNIX套接字文件位于"/tmp/mongodb-27017.sock"。要了解更多关于UnixSocketAddress的信息，请参阅UnixSocketAddress API文档。

• 与StreamFactory接口相关的方法和类型已在v5.0版本中弃用，并计划删除

  • streamFactoryFactory()方法，来自MongoClientSettings.Builder

  • getStreamFactoryFactory()方法，来自MongoClientSettings

  • NettyStreamFactoryFactory类

  • NettyStreamFactory类

  • AsynchronousSocketChannelStreamFactory类

  • AsynchronousSocketChannelStreamFactoryFactory类

  • BufferProvider类

  • SocketStreamFactory类

  • Stream类

  • StreamFactory类

  • StreamFactoryFactory类

  • TlsChannelStreamFactoryFactory类

  如果你通过MongoClientSettings.Builder.streamFactoryFactory()配置Netty，则你的代码可能类似于以下内容

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

  将此代码替换为以下示例中的TransportSettings.nettyBuilder()，具体请参考

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

4.11版本新特性

4.11驱动程序版本的新特性包括

• 支持通过SOCKS5代理连接到MongoDB。欲了解更多信息，请参阅使用SOCKS5代理连接到MongoDB。

• 向ChangeStreamDocument类添加了getSplitEvent()方法，以识别超出16MB的更改流事件的片段。您必须在更改流中使用聚合阶段$changeStreamSplitLargeEvent来处理超出16MB的事件。欲了解更多信息，请参阅拆分大型更改流事件。

• 添加了针对$vectorSearch的聚合阶段构建器。欲了解更多信息，请参阅Atlas Vector Search。

• 添加了Atlas Search索引管理辅助工具。欲了解更多信息，请参阅Atlas Search Indexes。

• 更新了 Snappy 和 Zstd 压缩库依赖版本。要了解当前依赖版本，请参阅网络压缩。

• 向以下类添加了 getElapsedTime() 方法以监控连接池事件的持续时间

  • ConnectionCheckOutFailedEvent

  • ConnectionCheckedOutEvent

  • ConnectionReadyEvent

• 支持 Java 21 虚拟线程和结构化并发。更新了驱动内部结构，以避免对虚拟线程不必要的锁定，并保留线程的中断状态，因为在结构化并发中，中断状态对于取消操作至关重要。

  要了解有关虚拟线程的更多信息，请参阅虚拟线程 JDK 增强提案。要了解有关结构化并发的更多信息，请参阅结构化并发 JDK 增强提案。

• 更新了以下类型的 API 文档

  • ClusterListener

  • ServerListener

  • ServerMonitorListener