版本说明

5.1 中的弃用

• 对MongoDB Server v 3.6的支持已弃用，并将在下一驾驶员发布中删除。 要学习；了解如何升级MongoDB Server部署，请参阅MongoDB Server手册中的发布说明。

5.1 中的改进

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

• 增强了对 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 中的行为变更

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

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

5.0 中的新功能

5.0 驱动程序版本引入了以下功能：

• 添加对listCollections命令的authorizedCollection选项的支持。 这是通过更改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 MongoDB Server手册页或获取集合列表。

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（聚合）服务器”手册条目。

• 以下与网络地址相关的方法已弃用，并将在 v5.0 中删除：

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

    使用 java.net.InetAddress 的 getByName() 实例方法，而不是 getSocketAddress()。

    使用 java.net.InetAddress 的 getAllByName() 实例方法，而不是 getSocketAddresses()。

  • UnixServerAddress 方法 getUnixSocketAddress()。

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

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

  • streamFactoryFactory() 方法来自 MongoClientSettings.Builder

  • getStreamFactoryFactory() 方法来自 MongoClientSettings

  • NettyStreamFactoryFactory class

  • NettyStreamFactory class

  • AsynchronousSocketChannelStreamFactory class

  • AsynchronousSocketChannelStreamFactoryFactory class

  • BufferProvider class

  • SocketStreamFactory class

  • Stream class

  • StreamFactory class

  • StreamFactoryFactory class

  • TlsChannelStreamFactoryFactory class

  如果使用 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() 方法，从而识别超过 16 MB 的变更流事件的片段。您必须在变更流中使用聚合阶段 $changeStreamSplitLargeEvent 来处理超过 16 MB 的事件。要了解详情，请参阅分割大型变更流事件。

• $vectorSearch为 添加了聚合阶段构建器。要学习；了解更多信息，请参阅MongoDB Vector Search。

• 添加了MongoDB Search索引管理助手。要学习；了解更多信息，请参阅MongoDB搜索索引。

• 更新了 Snappy 和 Zstd 压缩库依赖项版本。要了解有关当前依赖项版本的更多信息，请参阅网络压缩。

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

  • ConnectionCheckOutFailedEvent

  • ConnectionCheckedOutEvent

  • ConnectionReadyEvent

• 支持 Java 21 虚拟线程和结构化并发。驱动程序内部结构已更新，以避免不必要地虚拟线程绑定，并保留线程中断状态，后者对于用于取消的结构化并发很重要。

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

• 已更新以下类型的 API 文档：

  • ClusterListener

  • ServerListener

  • ServerMonitorListener