下载并安装

安装依赖项

确保您的开发环境中安装了 JDK 版本 8 或更高版本。

本指南介绍如何在集成开发环境 (IDE) 中使用 Maven 或 Gradle 添加 MongoDB Java 驱动程序依赖项。我们建议您使用 IntelliJ IDEA 或 Eclipse IDE 等 IDE。IDE 可以更方便地配置 Maven 或 Gradle 以构建和运行项目。

如果您未使用 IDE，请参阅构建 Maven 或创建新的 Gradle 构建以了解有关如何设置项目的更多信息。请参阅 MongoDB Reactive Streams 驱动程序以直接从 Maven 下载驱动程序和依赖项。

添加驱动程序和项目 Reactor 物料清单

在 IDE 中，创建新的 Maven 或 Gradle项目。本指南使用 Reactor 库中的方法，该库基于 Reactive Streams 规范，因此您必须添加其物料清单 (BOM) 以进行依赖项管理。将MongoDB Java虚拟机（JVM）工件的 BOM 和 Project Reactor 添加到项目中以组织依赖项版本。 BOM 确保您保持一致且兼容的依赖项版本，例如Java Reactive Streams驾驶员和核心驾驶员库之间的依赖项版本，从而简化依赖项管理。使用 BOM 避免版本冲突并简化升级。

从以下 Maven 和 Gradle 标签页中进行选择，查看为每个依赖项管理器添加 BOM 的说明：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>io.projectreactor</groupId>
            <artifactId>reactor-bom</artifactId>
            <version>2025.0.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.4.0"))
    implementation(platform("io.projectreactor:reactor-bom:2025.0.0"))
}

要查看 BOM 管理的依赖项列表，请参阅 Maven 存储库网站上的 mongodb-driver-bom 依赖项和 Reactor-bom 依赖项列表。

安装 Project Reactor 库

如果使用 Maven，请将以下内容添加到 pom.xml文件中：

<dependencies>
    ...
    <dependency>
        <groupId>io.projectreactor</groupId>
        <artifactId>reactor-core</artifactId>
    </dependency>
    <dependency>
        <groupId>io.projectreactor</groupId>
        <artifactId>reactor-test</artifactId>
        <scope>test</scope>
    </dependency>
</dependencies>

要使用 Gradle 安装 Reactor，请将以下内容添加到build.gradle.kts 依赖项列表中：

dependencies {
    ...
    implementation("io.projectreactor:reactor-core")
  }

由于您安装了 BOM，因此可以省略 Project Reactor 依赖项条目中的版本。您在 BOM 中指定的版本决定了要安装的依赖项版本。

配置依赖项后，运行依赖项管理器并在 IDE 中刷新项目，确保它们可用于您的项目。

安装Java Reactive Streams驱动程序

在项目中，如果使用Maven，请将以下内容添加到 pom.xml 依赖项列表中：

<dependencies>
    ...
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-reactivestreams</artifactId>
    </dependency>
</dependencies>

如果使用 Gradle，则将以下内容添加到 build.gradle.kts 依赖项列表中：

dependencies {
    ...
    implementation("org.mongodb:mongodb-driver-reactivestreams")
}

由于您安装了 BOM，因此可以省略Java Reactive Streams驱动程序依赖项条目中的版本。您在 BOM 中指定的版本决定了要安装的依赖项版本。

配置依赖项后，运行依赖项管理器并在 IDE 中刷新项目，确保它们可用于您的项目。