Menu Docs
Página inicial do Docs
/
Línguas
/
Kotlin
/
Kotlin Coroutine
/
Exemplos de uso
/
Inserir operações

Insira um documento

Você pode inserir um único documento em uma coleção usando o método insertOne() em um objeto MongoCollection. Para inserir um documento, crie um objeto Document que contenha os campos e valores que você deseja armazenar. Se você chamar o método insertOne() em uma coleção que ainda não existe, o servidor criará automaticamente para você.

Após uma inserção bem-sucedida, o insertOne() retorna uma instância de InsertOneResult. Você pode recuperar informações como o campo _id do documento inserido chamando o método getInsertedId() na instância InsertOneResult.

Se a sua operação de inserção falhar, o driver emitirá uma exceção. Para obter mais informações sobre os tipos de exceções geradas em condições específicas, consulte a documentação da API para insertOne(), cujo link está no final desta página.

Exemplo

O trecho a seguir insere um único documento na coleção movies.

Ao executar o exemplo, você deverá visualizar a saída com o ObjectId do documento inserido no campo de valor:

Observação

Esse exemplo se conecta a uma instância do MongoDB usando um URI de conexão. Para saber mais sobre como se conectar à sua instância do MongoDB, consulte oguia de conexão .

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()
}

Para obter mais informações sobre as classes e métodos mencionados nesta página, consulte a seguinte documentação da API:

  • insertOne()

  • Documento

  • InsertOneResult

Voltar

Inserir operações

Próximo

Insira vários documentos