/ /

빠른 참조

이 페이지에서는 여러 MongoDB 명령의 드라이버 구문과 관련 참조 및 API 문서에 대한 링크를 보여줍니다.

이 페이지의 예제에서는 다음 데이터 클래스를 사용하여 MongoDB 문서를 나타냅니다.

data class Movie(
    val title: String,
    val year: Int,
    val rated: String? = "Not Rated",
    val genres: List<String>? = listOf()
)

명령

구문

Find a Document

API Documentation
Usage Example
Fundamentals

collection.find(
    Filters.eq(Movie::title.name, "Shrek")
).firstOrNull()

Movie(title=Shrek, year=2001, ...)

Find Multiple Documents

API Documentation
Usage Example
Fundamentals

collection.find(
    Filters.eq(Movie::year.name, 2004)
)

[
 Movie(title=Shrek 2, year=2004, ...),
 Movie(title=Spider-Man 2, year=2004, ...),
 Movie(title=National Treasure, year=2004, ...),
 ...
]

Insert a Document

API Documentation
Usage Example
Fundamentals

collection.insertOne(Movie("Shrek", 2001))

Insert Multiple Documents

API Documentation
Usage Example
Fundamentals

collection.insertMany(
    listOf(
        Movie("Shrek", 2001),
        Movie("Shrek 2", 2004),
        Movie("Shrek the Third", 2007),
        Movie("Shrek Forever After", 2010),
    )
)

Update a Document

API Documentation
Usage Example
Fundamentals

collection.updateOne(
    Filters.eq(Movie::title.name, "Shrek"),
    Updates.set(Movie::rated.name, "PG")
)

Movie(title=Shrek, year=2001, rated=PG, genres=[])

Update Multiple Documents

API Documentation
Usage Example
Fundamentals

collection.updateMany(
    Filters.regex(Movie::title.name, "Shrek"),
    Updates.set(Movie::rated.name, "PG")
)

[
  Movie(title=Shrek, year=2001, rated=PG, genres=[]),
  Movie(title=Shrek 2, year=2004, rated=PG, genres=[]),
  Movie(title=Shrek the Third, year=2007, rated=PG, genres=[]),
  Movie(title=Shrek Forever After, year=2010, rated=PG, genres=[])
]

Update an Array in a Document

API Documentation
Fundamentals

collection.updateOne(
    Filters.eq(Movie::title.name, "Shrek"),
    Updates.addEachToSet(Movie::genres.name, listOf("Family", "Fantasy"))
)

Movie(title=Shrek, year=2001, rated=Not Rated, genres=[Family, Fantasy])

Replace a Document

API Documentation
Usage Example
Fundamentals

collection.replaceOne(
    Filters.eq(Movie::title.name, "Shrek"),
    Movie("Kersh", 1002, "GP")
)

Movie(title=Kersh, year=1002, rated=GP, genres=[])

Delete a Document

API Documentation
Usage Example
Fundamentals

collection.deleteOne(
    Filters.eq(Movie::title.name, "Shrek")
)

Delete Multiple Documents

API Documentation
Usage Example
Fundamentals

collection.deleteMany(
    Filters.regex(Movie::title.name, "Shrek")
)

Bulk Write

API Documentation
Usage Example
Fundamentals

collection.bulkWrite(
    listOf(
        InsertOneModel(Movie("Shrek", 2001)),
        DeleteManyModel(Filters.lt(Movie::year.name, 2004)),
    )
)

Watch for Changes

API Documentation
Usage Example
Fundamentals

val changeStream = collection.watch()
changeStream.collect {
    println("Change to ${it.fullDocument?.title}")
}

Access Results from a Query as a List

collection.find().toList()

[
  Movie(title=Shrek, year=2001, rated=Not Rated, genres=[]),
  Movie(title=Shrek 2, year=2004, rated=Not Rated, genres=[]),
  Movie(title=Shrek the Third, year=2007, rated=Not Rated, genres=[]),
  Movie(title=Shrek Forever After, year=2010, rated=Not Rated, genres=[])
]

Count Documents

API Documentation
Usage Example

collection.countDocuments(Filters.eq("year", 2001))

List the Distinct Documents or Field Values
API Documentation
Usage Example

collection.distinct<String>(Movie::rated.name)

[Not Rated, PG, PG-13]

Limit the Number of Documents Retrieved

API Documentation
Fundamentals

collection.find()
    .limit(2)

[
  Movie(title=Shrek, year=2001, rated=Not Rated, genres=[]),
  Movie(title=Shrek 2, year=2004, rated=Not Rated, genres=[])
]

Skip Retrieved Documents

API Documentation
Fundamentals

collection.find()
    .skip(2)

[
  Movie(title=Shrek the Third, year=2007, rated=Not Rated, genres=[]),
  Movie(title=Shrek Forever After, year=2010, rated=Not Rated, genres=[])
]

Sort the Documents When Retrieving Them

API Documentation
Fundamentals

collection.find().sort(Sorts.descending(Movie::year.name))

[
  Movie(title=Shrek Forever After, year=2010, rated=Not Rated, genres=[]),
  Movie(title=Shrek the Third, year=2007, rated=Not Rated, genres=[]),
  Movie(title=Shrek 2, year=2004, rated=Not Rated, genres=[]),
  Movie(title=Shrek, year=2001, rated=Not Rated, genres=[])
]

Project Document Fields When Retrieving Them

API Documentation
Usage Example
Fundamentals

data class Result(val title: String)
    collection.find<Result>()
        .projection(Projections.include(Movie::title.name))

Result(title=Shrek)

Create an Index

API Documentation
Fundamentals

collection.createIndex(Indexes.ascending(Movie::title.name))

Search Text

API Documentation
Fundamentals

collection.find(Filters.text("Forever"));

[Movie(title=Shrek Forever After, year=2010, rated=Not Rated, genres=[])]

Install the Driver Dependency with Maven

pom.xml

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-kotlin-coroutine</artifactId>
        <version>5.3.0</version>
    </dependency>
</dependencies>

Install the Driver Dependency with Gradle

build.gradle.kts

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

Access Data from a Flow Iteratively

API Documentation
Fundamentals

val flow = collection.find(
    Filters.eq(Movie::year.name, 2004)
)
flow.collect { println(it) }

Movie(title=2001: A Space Odyssey, ...)
Movie(title=The Sound of Music, ...)

돌아가기

빠른 시작

새로운 기능