Insertar un documento

Puede insertar un solo documento en una colección utilizando el insertOne() Método en un objeto MongoCollection. Para insertar un documento, construya un objeto Document que contenga los campos y valores que desea almacenar. Si llama al método insertOne() en una colección que aún no existe, el servidor la crea automáticamente.

Tras una inserción exitosa, insertOne() devuelve una instancia de InsertOneResult. Puede recuperar información como el campo _id del documento insertado llamando al método getInsertedId() en la instancia InsertOneResult.

Si la operación de inserción falla, el controlador genera una excepción. Para obtener más información sobre los tipos de excepciones generadas en condiciones específicas, consulte la documentación de la API de insertOne(), cuyo enlace encontrará al final de esta página.

Ejemplo

El siguiente fragmento inserta un solo documento en la colección movies.

Cuando ejecute el ejemplo, debería ver el resultado con el documento insertado ObjectId en el campo de valor:

Nota

Este ejemplo se conecta a una instancia de MongoDB mediante una URI de conexión. Para obtener más información sobre cómo conectarse a su instancia de MongoDB, consulte Guía de conexión.

import com.mongodb.MongoException
import com.mongodb.kotlin.client.coroutine.MongoClient
import kotlinx.coroutines.runBlocking
import org.bson.codecs.pojo.annotations.BsonId
import org.bson.types.ObjectId
data class Movie(@BsonId val id: ObjectId, val title: String, val genres: List<String>)
fun main() = runBlocking {
    // Replace the uri string with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    try {
        val result = collection.insertOne(
            Movie(ObjectId(), "Ski Bloopers", listOf("Documentary", "Comedy"))
        )
        println("Success! Inserted document id: " + result.insertedId)
    } catch (e: MongoException) {
        System.err.println("Unable to insert due to an error: $e")
    }
    mongoClient.close()
}

Success! Inserted document id: BsonObjectId{value=...}

Para obtener información adicional sobre las clases y métodos mencionados en esta página, consulte la siguiente documentación de API: