코틀린 동기 (Kotlin Sync) 드라이버 시작하기

코틀린( 코틀린 (Kotlin) ) 프로젝트 만들기

먼저 시스템에 Kotlin이 설치되어 있고 JDK 1.8 이상에서 실행 중인지 확인합니다.

IntelliJ IDEA 또는 Eclipse IDE와 같은 통합 개발 환경(IDE)을 사용하여 프로젝트를 빌드하고 실행하도록 Gradle 또는 Maven을 구성하는 것이 좋습니다.

코틀린 (Kotlin) 시작하기 및 첫 번째 프로젝트 만들기에 대한 자세한 내용 은 코틀린 (Kotlin)/ JVM 시작하기를 참조하세요. 코틀린 (Kotlin) 언어 문서에서 확인할 수 있습니다.

드라이버 BOM 추가

IDE에서 새 Maven 또는 Gradle 프로젝트 만듭니다. 프로젝트 에 MongoDB JVM 아티팩트에 대한 BOM(Bill of Material)을 추가하여 종속성 버전을 구성합니다. BOM은 코틀린 동기 (Kotlin Sync) 운전자 와 코어 운전자 라이브러리 간에 일관적인 되고 호환되는 버전의 종속성을 유지하도록 하여 종속성 관리 간소화합니다. BOM을 사용하여 버전 충돌을 방지하고 업그레이드를 간소화하세요.

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

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.5.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.5.0"))
}

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

종속성으로 MongoDB 추가하기

Gradle을 사용하여 패키지를 관리 경우 build.gradle.kts 종속성 목록에 다음 항목을 추가합니다.

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

Maven을 사용하여 패키지를 관리 경우 pom.xml 종속성 목록에 다음 항목을 추가합니다.

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

BOM을 설치했으므로 코틀린 동기 (Kotlin Sync) 운전자 종속성 항목에서 버전을 생략할 수 있습니다. BOM에 지정한 버전에 따라 설치할 종속성 버전이 결정됩니다.

종속성을 구성한 후에는 종속성 관리자를 실행하고 IDE에서 프로젝트를 새로 고침하여 프로젝트에서 종속성을 사용할 수 있는지 확인합니다.

직렬화 라이브러리 종속성 추가

드라이버가 Kotlin 객체와 MongoDB의 문서 데이터 형식인 BSON 간에 변환할 수 있도록 하려면 다음 직렬화 패키지 중 하나 또는 둘 모두를 애플리케이션에 추가해야 합니다.

• bson-kotlinx (권장 사항)

• bson-kotlin

Gradle을 사용하여 패키지를 관리하는 경우 build.gradle.kts 종속성 목록에 다음 항목 중 하나를 추가합니다.

implementation("org.mongodb:bson-kotlinx")
// OR
implementation("org.mongodb:bson-kotlin")

Maven을 사용하여 패키지를 관리하는 경우 pom.xml 종속성 목록에 다음 항목 중 하나를 추가합니다.

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlinx</artifactId>
</dependency>
<!--OR-->
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlin</artifactId>
</dependency>

종속성을 구성한 후에는 종속성 관리자를 실행하고 IDE에서 프로젝트를 새로 고침하여 프로젝트에서 종속성을 사용할 수 있는지 확인합니다.

이러한 패키지에 학습 보려면 코틀린 (Kotlin) 직렬화 를 참조하세요.

Atlas에 무료 MongoDB 배포서버 생성

Atlas 시작하기 가이드를 완료하여 새 Atlas 계정을 설정하고 새로운 프리 계층 MongoDB 배포서버에 샘플 데이터를 로드하세요.

자격 증명 저장

데이터베이스 사용자를 생성한 후에는 다음 단계에서 사용할 수 있도록 사용자의 사용자 이름 과 비밀번호를 안전한 위치 에 저장합니다.

MongoDB Atlas 연결 문자열 찾기

이전 단계에서 만든 배포서버에 대한 연결 문자열 조회 하려면 Atlas 계정에 로그 Database 섹션으로 이동한 다음 새 배포서버 에 대한 Connect 버튼을 클릭합니다.

Connect your application 섹션으로 이동한 다음 Driver 선택 메뉴에서 코틀린 (Kotlin) 을 선택합니다.

Password (SCRAM) 인증 메커니즘을 선택합니다.

연결 string 만 보려면 Include full driver code example 옵션을 선택 취소합니다.

연결 문자열 복사

다음 스크린샷에 표시된 대로 연결 문자열 오른쪽에 있는 버튼을 클릭하여 클립보드에 복사합니다.

자리 표시자 업데이트

이 연결 문자열을 원하는 텍스트 편집기의 파일에 붙여넣고 <username> 및 <password> 자리 표시자를 데이터베이스 사용자의 사용자 이름 및 비밀번호로 바꿉니다.

다음 단계에서 사용할 수 있도록 이 파일 을 안전한 위치 에 저장합니다.

애플리케이션 파일 만들기

프로젝트 에 DemoDataClassExample.kt 파일 을 만듭니다.

다음 샘플 코드를 파일 에 복사하고 <connection URI string> 자리 표시자 값을 이전 단계에서 저장한 MongoDB Atlas 연결 string 로 바꿉니다.

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.MongoClient
// Create data class to represent a MongoDB document
data class Movie(val title: String, val year: Int, val directors: List<String>)
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection URI string>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    // Find a document with the specified title
    val doc = collection.find(eq(Movie::title.name, "Before Sunrise")).firstOrNull()
    if (doc != null) {
        // Print the matching document
        println(doc)
    } else {
        println("No matching documents found.")
    }
}

애플리케이션 실행

애플리케이션 을 실행 하면 다음 출력과 같이 쿼리 와 일치하는 영화 문서 의 세부 정보가 출력됩니다.

Movie(title=Before Sunrise, year=1995, directors=[Richard Linklater])

출력이 표시되지 않거나 오류가 발생하는 경우 애플리케이션에 적절한 연결 문자열을 포함했는지 확인합니다. 또한 샘플 데이터세트를 MongoDB Atlas 클러스터에 성공적으로 로드했는지 확인합니다.

이 단계를 완료하면 코틀린 동기 (Kotlin Sync) 운전자 를 사용하여 MongoDB cluster 에 연결하고, 샘플 데이터에 대해 쿼리 를 실행 하고, 결과를 출력하는 애플리케이션 이 작동합니다.

문서 클래스를 사용하여 데이터 모델링(대안)

이전 단계에서는 코틀린 (Kotlin) 데이터 클래스를 사용하여 샘플 컬렉션 에서 쿼리 를 실행 하여 데이터를 조회 하는 방법을 보여 줍니다. 이 섹션에서는 문서 클래스를 사용하여 MongoDB 에서 데이터를 저장 하고 조회 합니다.

DemoDocumentExample.kt 파일 에 다음 샘플 코드를 붙여넣어 MongoDB Atlas 의 샘플 데이터 세트에 대한 쿼리 를 실행 합니다. <connection URI string> 자리 표시자의 값을 MongoDB Atlas 연결 string 로 바꿉니다.

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection URI string>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Document>("movies")
    // Find a document with the specified title
    val doc = collection.find(eq("title", "Before Sunrise")).firstOrNull()
    if (doc != null) {
        // Print the matching document
        println(doc)
    } else {
        println("No matching documents found.")
    }
}

애플리케이션 을 실행 하면 다음 출력과 같이 쿼리 와 일치하는 영화 문서 의 세부 정보가 출력됩니다.

Document{{_id=..., plot=A young man and woman ..., genres=[Drama, Romance], ...}}

출력이 표시되지 않거나 오류가 발생하는 경우 애플리케이션에 적절한 연결 문자열을 포함했는지 확인합니다. 또한 샘플 데이터세트를 MongoDB Atlas 클러스터에 성공적으로 로드했는지 확인합니다.