다운로드 및 설치

설치 종속성

개발 환경에 JDK 버전 8 이상이 설치되어 있는지 확인합니다.

이 가이드 에서는 통합 개발 환경(IDE)에서 Maven 또는 Gradle을 사용하여 MongoDB Java 운전자 종속성을 추가하는 방법을 보여줍니다. IntelliJ IDEA 또는 Eclipse IDE와 같은 IDE를 사용할 것을 권장합니다. IDE를 사용하면 프로젝트 를 빌드 하고 실행 하도록 Maven 또는 Gradle을 더 편리하게 구성할 수 있습니다.

IDE를 사용하지 않는 경우 프로젝트 설정하다 방법에 대한 자세한 내용은 Maven 빌드 또는 새 Gradle 빌드 만들기 를 참조하세요. Maven에서 직접 운전자 및 종속성을 다운로드 하려면 MongoDB Reactive Streams 드라이버 참조하세요.

드라이버 및 프로젝트 Reactor BOM 추가

IDE에서 새 Maven 또는 Gradle 프로젝트 만듭니다. 이 가이드 Reactive Streams 사양을 기반으로 하는 라이브러리인 Reactor 라이브러리의 메서드를 사용하므로 종속성 관리 위해 BOM(Bill of Material)을 추가해야 합니다. 프로젝트 에 BOM for MongoDB JVM 아티팩트 및 Project Reactor를 추가하여 종속성 버전을 구성합니다. BOM은 Java Reactive Streams 드라이버와 코어 드라이버 라이브러리 간에 일관되고 호환되는 버전의 종속성을 유지하도록 하여 종속성 관리를 간소화합니다. BOM을 사용하여 버전 충돌을 방지하고 업그레이드를 간소화하세요.

다음 Maven 및 Gradle 탭에서 선택하여 각 종속성 관리자에 대한 BOM을 추가하는 방법에 대한 지침을 확인합니다.

<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"))
}

BOM이 관리하는 종속성 목록을 보려면 Maven 리포지토리 웹사이트에서 mongodb-driver-bom 종속성 및 Reactor-bom 종속성 목록을 참조하세요.

프로젝트 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을 설치했으므로 프로젝트 리액터 종속성 항목에서 버전을 생략할 수 있습니다. 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에서 프로젝트 를 새로 고쳐 프로젝트 에서 사용할 수 있는지 확인합니다.