Descargue e instale

Instale las dependencias

Asegúrate de tener JDK versión 8 o posterior instalados en tu entorno de desarrollo.

Esta guía te muestra cómo agregar las dependencias del controlador Java de MongoDB utilizando Maven o Gradle en un entorno de desarrollo integrado (IDE). Recomendamos utilizar un IDE como IntelliJ IDEA o Eclipse IDE. Un IDE facilita la configuración de Maven o Gradle para compilar y ejecutar tu proyecto.

Si no usa un IDE,consulte "Compilar Maven" o "Crear nuevas compilaciones de Gradle" para obtener más información sobre cómo configurar su proyecto.Consulte "El controlador MongoDB Reactive Streams" para descargar el controlador y sus dependencias directamente desde Maven.

Agrega el controlador y el proyecto Bill of Materials de Reactor

En tu IDE, crea un nuevo Maven o Gradle proyecto. Esta guía utiliza métodos de la librería Reactor, una librería basada en la especificación Reactive Streams, por lo que es necesario agregar su Bill of Materials (BOM) para la gestión de dependencias. Agregue el BOM para los artefactos MongoDB JVM y Project Reactor a su proyecto para organizar las versiones de dependencias. La BOM simplifica la gestión de dependencias al garantizar que se mantengan versiones coherentes y compatibles de las dependencias, como entre el driver Java Reactive Streams y la librería principal del driver. Utiliza el BOM para evitar conflictos de versión y simplificar las actualizaciones.

Seleccione de lo siguiente Maven y Gradle pestañas para ver las instrucciones de añadir la BOM para cada gestor de dependencias:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.6.4</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.6.4"))
    implementation(platform("io.projectreactor:reactor-bom:2025.0.0"))
}

Para ver una lista de las dependencias que gestiona el BOM, consulta la dependencia mongodb-driver-bom y la dependencia reactor-bom en el sitio web del repositorio de Maven.

Instalar la librería Project Reactor

Si está usando Maven, añade lo siguiente a tu archivo 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>

Para instalar Reactor usando Gradle, agregue lo siguiente a su lista de dependencias build.gradle.kts:

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

Dado que has instalado el BOM, puedes omitir una versión en la entrada de dependencia de Proyecto Reactor. La versión que especifiques en el BOM determina las versiones de dependencias que se instalarán.

Después de configurar las dependencias, es necesario garantizar que estén disponibles para el proyecto ejecutando el administrador de dependencias y actualizando el proyecto en el IDE.

Instalar el controlador Java Reactive Streams

En tu proyecto, si utilizas Maven, agrega lo siguiente a la lista de dependencias de tu pom.xml:

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

Si está utilizando Gradle, añada lo siguiente a su lista de dependencias build.gradle.kts:

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

Como se ha instalado el BOM, se puede omitir una versión en la entrada de dependencia del controlador Java Reactive Streams. La versión que se especifica en el BOM determina las versiones de las dependencias que se instalarán.

Después de configurar las dependencias, es necesario garantizar que estén disponibles para el proyecto ejecutando el administrador de dependencias y actualizando el proyecto en el IDE.