Descargue e instale

Instale las dependencias

Asegúrese de tener instalada 8 la versión o posterior de JDK en su 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 usas un IDE, consulta Compilando Maven o Creando nuevas compilaciones de Gradle para obtener más información sobre cómo configurar tu proyecto. Consulta El driver de flujos reactivos de MongoDB para descargar el driver y las dependencias directamente de 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.

Selecciona las siguientes pestañas Maven y Gradle para ver las instrucciones para agregar el BOM para cada administrador de dependencias:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.12.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.12.0"))
    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ás utilizando Maven, añade lo siguiente a tu pom.xml archivo:

<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 build.gradle.kts lista de dependencias:

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.

Instale el controlador de Java Reactive Streams

En tu proyecto, si estás usando Maven, agrega lo siguiente a tu pom.xml lista de dependencias:

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

Si estás utilizando Gradle, añade lo siguiente a tu build.gradle.kts lista de dependencias:

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.