커서에서 데이터 액세스

개요

이 가이드에서는 Kotlin 동기화 드라이버를 사용하여 커서 에서 데이터에 액세스하는 방법을 배울 수 있습니다.

커서는 읽기 작업의 결과를 반복 가능한 배치로 반환하는 메커니즘입니다. 커서는 주어진 시간에 문서의 하위 집합만 보유하므로 커서는 메모리 소비와 드라이버가 서버에 보내는 요청 수를 모두 줄여줍니다.

Kotlin Sync 드라이버가 여러 문서를 반환하는 읽기 작업을 수행할 때마다 커서에 해당 문서가 자동으로 반환됩니다.

data class Restaurant(
    @BsonId
    val id: ObjectId,
    val name: String
)

반복적으로 커서 내용에 액세스

커서의 내용을 반복하려면 다음 예제와 같이 forEach() 메서드를 사용합니다.

val results = collection.find()
results.forEach { result ->
    println(result)
}

또는 use() 메서드를 사용하여 커서에 루프를 구현합니다.

val results = collection.find()
results.cursor().use { cursor ->
    while (cursor.hasNext()) {
        println(resultCursor.next())
    }
}

문서 개별 조회

next() 메서드를 호출하여 커서에서 문서를 개별적으로 검색합니다.

다음 예에서는 컬렉션에서 name 값이 "Dunkin' Donuts" 인 모든 문서를 찾습니다. 그런 다음 next() 메서드를 호출하여 커서의 첫 번째 문서를 인쇄합니다.

val results = collection
    .find<Restaurant>(eq(Restaurant::name.name, "Dunkin' Donuts"))
results.cursor().use { cursor ->
    println(if (cursor.hasNext()) cursor.next()
            else "No document matches the filter")
}

모든 문서 검색

커서에서 모든 문서를 검색하려면 다음 예와 같이 커서를 List 로 변환합니다.

val results = collection.find<Restaurant>(eq(Restaurant::name.name, "Dunkin' Donuts"))
val resultsList = results.toList()
for (result in resultsList) {
    println(result)
}

맞춤형 커서

고정 사이즈 컬렉션 을 쿼리할 때 클라이언트가 커서에서 결과를 모두 사용한 후에도 계속 열려 있는 테일 커서( tailable cursor )를 사용할 수 있습니다. 고정 사이즈 컬렉션을 사용하여 테일 커서(tailable cursor)를 만들려면 FindIterable 객체의 cursorType 메서드에 CursorType.TailableAwait 를 지정합니다.

다음 예제에서는 고정 사이즈 컬렉션에 테일 커서(tailable cursor)를 생성합니다.

val results = collection.find<Document>().cursorType(CursorType.TailableAwait)

테일 커서(tailable cursor) 및 사용법에 대해 자세히 알아보려면 MongoDB 서버 매뉴얼의 테일 커서(tailable cursor) 가이드 를 참조하세요.

문제 해결

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

• find()

• FindIterable

• MongoCursor

• CursorType