mongo-java-driver

发布说明

发布说明可在此处查看。

文档

Java 驱动程序的参考和 API 文档可在此处查看。

Kotlin 驱动程序的参考和 API 文档可在此处查看。

Scala 驱动程序的参考和 API 文档可在此处查看。

教程/培训

有关如何使用 MongoDB JVM 驱动程序的教程，请参考 MongoDB 大学。MongoDB 开发者中心中还可以找到使用 Java 驱动程序和 Kotlin 驱动程序的其他教程、视频和代码示例。

支持/反馈

对于 MongoDB Java、Kotlin 和 Scala 驱动程序的问题、疑问或反馈，请查看我们的支持渠道。请勿直接向任何驱动程序开发人员发送电子邮件询问问题或疑问 - 您更有可能在 MongoDB 社区论坛或 StackOverflow 上得到答案。

请至少在您的描述中包含您正在使用的驱动程序的确切版本。如果您遇到连接问题，通常还需要粘贴构造 MongoClient 实例的代码行，以及传递给构造函数的所有参数值。您还应该检查应用程序日志中是否有任何与连接相关的异常，并将其一并发布。

错误/功能请求

认为在 Java、Kotlin 或 Scala 驱动程序中发现了错误？想在驱动程序中看到新功能？请在我们的问题管理工具 JIRA 中创建一个案例：

创建账户并登录。
导航至 JAVA 项目。
点击创建问题 - 请尽可能提供有关问题类型、您使用的驱动程序以及如何重现问题的详细信息。

JIRA 中关于驱动程序和核心服务器（即 SERVER）项目的错误报告是公开的。

如果您发现驱动程序或任何其他 MongoDB 项目中存在安全漏洞，请按照此处的说明进行报告。

版本控制

当对公共 API 进行破坏性更改时，将进行主要版本递增（例如 4.x -> 5.x）。在主要版本发布中删除的所有方法和类都将在先前主要版本分支的某个版本中被弃用，和/或在发布说明中特别说明。

次要版本 5.x 递增（例如 5.1、5.2 等）将在添加非平凡的新功能或进行重大增强或错误修复时发生，这些更改可能会影响某些边缘情况的行为（例如依赖于由错误导致的行为）。增强的一个例子是添加方法或类以支持 MongoDB 服务器添加的新功能。除非另有说明，次要版本通常与同一主要版本分支的先前次要版本在二进制上兼容。

补丁版本 5.x.y 递增（例如 5.0.0 -> 5.0.1、5.1.1 -> 5.1.2 等）仅用于错误修复，并且始终与同一次要版本分支的先前补丁版本在二进制上兼容。

@Alpha

标有 @Alpha 注解的 API 处于开发初期阶段，可能会在未来版本中进行不兼容的更改，甚至被移除，并且可能缺少一些预期功能。带有 @Alpha 注解的 API 可能包含已知的影响功能、性能和稳定性的问题。它们也不受其所在库提供的任何兼容性保证的约束。

不建议应用程序在生产环境中使用 Alpha API，也不建议库（它们被包含在用户的 CLASSPATH 中，超出库开发人员的控制范围）依赖这些 API。Alpha API 仅用于实验目的。

@Beta

在类或方法级别标有 @Beta 注解的 API 可能会发生变化。它们可以以任何方式进行修改，甚至随时被删除。如果您的代码本身就是一个库（即它被用于您无法控制的用户的 CLASSPATH 上），则不应使用 Beta API，除非您对其进行重新打包（例如通过使用 shading 等）。

@Deprecated

在类或方法级别标有 @Deprecated 注解的 API 将继续受支持，直到下一个主要版本发布，但建议停止使用它们。

com.mongodb.internal.*

com.mongodb.internal.* 包中的所有代码都被视为私有 API，不应依赖。它可能随时发生变化。

二进制文件

Maven、Gradle、Ivy 等的二进制文件和依赖信息可以在 http://search.maven.org 找到。

Maven 示例：

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
    <version>x.y.z</version>
</dependency>

快照版本也会通过 Sonatype 定期发布。

Maven 示例：

    <repositories>
        <repository>
            <id>sonatype-snapshot</id>
            <url>https://oss.sonatype.org/content/repositories/snapshots/</url>
        </repository>
    </repositories>

构建

构建和编译源代码需要 Java 17+ 和 git。要构建和测试驱动程序：

$ git clone https://github.com/mongodb/mongo-java-driver.git
$ cd mongo-java-driver
$ ./gradlew check

测试套件要求 mongod 运行时启用 enableTestCommands，可以使用 --setParameter enableTestCommands=1 命令行参数设置：

$ mkdir -p data/db
$ mongod --dbpath ./data/db --logpath ./data/mongod.log --port 27017 --logappend --fork --setParameter enableTestCommands=1

如果在运行测试时遇到 "Too many open files" 错误，则需要在启动 mongod 之前增加可用文件描述符的数量，如 https://www.mongodb.com/docs/manual/reference/ulimit/ 中所述。

IntelliJ IDEA

要在 IntelliJ 中运行代码，需要进行一些手动配置步骤：

构建和编译源代码需要 Java 17+。
错误： java: cannot find symbol: class SNIHostName location: package javax.net.ssl 修复： 设置/首选项 > 构建、执行、部署 > 编译器 > Java 编译器 - 取消勾选"使用 '--release' 选项进行跨编译（Java 9 及更高版本）"
错误： java: package com.mongodb.internal.build does not exist 修复： 以下任一方法： 
- 运行 generateBuildConfig 任务：例如：./gradlew generateBuildConfig 或通过 Gradle > driver-core > Tasks > buildconfig > generateBuildConfig
- 将 generateBuildConfig 设置为在构建之前执行。通过 Gradle > Tasks > buildconfig > 右键单击 generateBuildConfig - 单击"在构建之前执行"
- 将所有构建操作委托给 Gradle：设置/首选项 > 构建、执行、部署 > 构建工具 > Gradle > 使用 Gradle 构建和运行/使用 Gradle 运行测试 - 选择"Gradle"