Docs Menu

Docs Home → Develop Applications → MongoDB Drivers → Kotlin Coroutine

Quick Reference

This page shows the driver syntax for several MongoDB commands and links to their related reference and API documentation.

The examples on the page use the following data class to represent MongoDB documents:

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

API Documentation
Usage Example
Fundamentals
collection.find(
    Filters.eq(Movie::title.name, "Shrek")
).firstOrNull()
Find Multiple Documents

API Documentation
Usage Example
Fundamentals
collection.find(
    Filters.eq(Movie::year.name, 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")
)
Update Multiple Documents

API Documentation
Usage Example
Fundamentals
collection.updateMany(
    Filters.regex(Movie::title.name, "Shrek"),
    Updates.set(Movie::rated.name, "PG")
)
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"))
)
Replace a Document

API Documentation
Usage Example
Fundamentals
collection.replaceOne(
    Filters.eq(Movie::title.name, "Shrek"),
    Movie("Kersh", 1002, "GP")
)
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()
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)
Limit the Number of Documents Retrieved

API Documentation
Fundamentals
collection.find()
    .limit(2)
Skip Retrieved Documents

API Documentation
Fundamentals
collection.find()
    .skip(2)
Sort the Documents When Retrieving Them

API Documentation
Fundamentals
collection.find().sort(Sorts.descending(Movie::year.name))
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))
Create an Index

API Documentation
Fundamentals
collection.createIndex(Indexes.ascending(Movie::title.name))
Search Text

API Documentation
Fundamentals
collection.find(Filters.text("Forever"));
Install the Driver Dependency with Maven
pom.xml
<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-kotlin-coroutine</artifactId>
        <version>5.1.0</version>
    </dependency>
</dependencies>
Install the Driver Dependency with Gradle
build.gradle.kts
dependencies {
    implementation("org.mongodb:mongodb-driver-kotlin-coroutine:5.1.0")
}
Access Data from a Flow Iteratively

API Documentation
Fundamentals
val flow = collection.find(
    Filters.eq(Movie::year.name, 2004)
)
flow.collect { println(it) }
← Kotlin Driver Quick Start
What's New →