新增功能

5.1 中的弃用

• 对 MongoDB 服务器 v 3.6的支持已弃用，并将在下一驱动程序版本中删除。 要了解如何升级 MongoDB Server 部署，请参阅 MongoDB Server 手册中的发布说明。

5.1 中的改进

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

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

• 修复了以下问题：在使用多态MongoCollection实例时，操作使用了不正确的编解码器。 这可确保使用bson-kotlinx时鉴别器信息不会丢失。

• 修复了以下问题：解码时类鉴别器是第一个字段，导致使用多态MongoCollection实例时出现字段类型错误。

5.1 中的新功能

• 支持多态序列化。 要学习；了解更多信息，请参阅Kotlin序列化指南的多态序列化部分。

• 引入serverMonitoringMode连接 URI 选项。 要学习；了解更多信息，请参阅连接选项指南。

4.11 中的弃用

4.11 版驱动程序已弃用以下内容：

• 以下与网络地址相关的方法已弃用，并将在 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。

• 向 ChangeStreamDocument 类添加 getSplitEvent() 方法，从而识别超过 16 MB 的变更流事件的片段。您必须在变更流中使用聚合阶段 $changeStreamSplitLargeEvent 来处理超过 16 MB 的事件。

• 已为 $vectorSearch 添加了聚合阶段构建器。

• 添加了 Atlas Search 索引管理辅助工具。

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

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

  • ConnectionCheckOutFailedEvent

  • ConnectionCheckedOutEvent

  • ConnectionReadyEvent

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

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

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

  • ClusterListener

  • ServerListener

  • ServerMonitorListener