MongoDB driver for Kotlin (synchronous) • opensavvy.ktmongo.sync.operations • UpdatePipelineOperations • upsertOneWithPipeline

upsertOneWithPipeline

abstract fun upsertOneWithPipeline(options: <Document>.() -> Unit = {}, filter: <Document>.() -> Unit = {}, update: <Document>.() -> Unit)

Updates a single document that matches filter according to the update pipeline.

If multiple documents match filter, only the first one is updated.

If no documents match filter, a new one is created.

Example

class User(
    val name: String,
    val age: Int,
)

collection.upsertOneWithPipeline(
    filter = {
         User::name eq "Patrick"
    }
) {
    set {
        User::age set 15
    }
}

External resources

• Official documentation

See also

• UpdatePipelineOperations.updateOneWithPipeline Do nothing if the document doesn't already exist.