Baixar e instalar

Instalar dependências

Certifique-se de ter o JDK versão 8 ou posterior instalado em seu ambiente de desenvolvimento.

Este guia mostra como adicionar as dependências do driver MongoDB Java usando Maven ou Gradle em um ambiente de desenvolvimento integrado (IDE). Recomendamos que você use um IDE como IntelliJ IDEA ou Eclipse IDE. Um IDE torna mais conveniente configurar o Maven ou o Gradle para construir e executar seu projeto.

Se você não estiver usando um IDE, consulte Construindo o Maven ou Criando Novas Construções Gradle para obter mais informações sobre como definir seu projeto. Consulte O MongoDB Reactive Streams Driver para baixar o driver e as dependências diretamente do Maven.

Adicionar a lista de materiais do driver e do reator do projeto

No seu IDE, crie um novo projeto Maven ou Gradle. Este guia usa métodos da biblioteca Reactor, uma biblioteca baseada na especificação Reactive Streams, portanto, você deve adicionar sua Lista de materiais (BOM) para gerenciamento de dependência. Adicione o BOM para artefatos JVM do MongoDB e o Project Reactor ao seu projeto para organizar as versões de dependência. O BOM simplifica o gerenciamento de dependências garantindo que você mantenha versões consistentes e compatíveis de dependências, como entre o driver Java Reactive Streams e a biblioteca principal de drivers. Use o BOM para evitar conflitos de versão e simplificar as atualizações.

Selecione a partir das seguintes abas Maven e Gradle para visualizar as instruções para adicionar o BOM para cada gerenciador de dependência:

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

Para ver uma lista de dependências que o BOM gerencia, consulte as listas de dependências do mongodb-driver-bom e do react-bom no site do Repositório Maven.

Instale a biblioteca do reator do projeto

Se você estiver usando o Maven, adicione o seguinte ao seu pom.xml arquivo :

<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 o Reactor usando o Gradle, adicione o seguinte à sua build.gradle.kts lista de dependências :

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

Como instalou o BOM, você pode omitir uma versão na entrada de dependência do Project Reactor. A versão especificada no BOM determina as versões de dependência a serem instaladas.

Depois de configurar suas dependências, certifique-se de que elas estejam disponíveis para seu projeto executando o gerenciador de dependências e atualizando o projeto em seu IDE.

Instale o driver Java Reactive Streams

Em seu projeto, se você estiver usando Maven, adicione o seguinte à sua pom.xml lista de dependências do :

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

Se você estiver usando o Gradle, adicione o seguinte à sua lista de dependências build.gradle.kts:

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

Como instalou o BOM, você pode omitir uma versão na entrada de dependência do driver Java Reactive Streams . A versão especificada no BOM determina as versões de dependência a serem instaladas.

Depois de configurar suas dependências, certifique-se de que elas estejam disponíveis para seu projeto executando o gerenciador de dependências e atualizando o projeto em seu IDE.