Início rápido do driver Kotlin

Install Kotlin

Certifique-se de que seu sistema tenha o Kotlin instalado e em execução no JDK 1.8 ou posterior. Para obter mais informações sobre como começar a desenvolver o Kotlin/ JVM , consulte Introdução ao Kotlin/ JVM na documentação da linguagem Kotlin .

Criar o projeto

Este guia mostra como adicionar as dependências do driver MongoDB Kotlin usando Gradle ou Maven. Recomendamos que você use um ambiente de desenvolvimento integrado (IDE) como IntelliJ IDEA ou Eclipse IDE para configurar Gradle ou Maven para construir e executar seu projeto.

Se você não estiver usando um IDE, consulte o guia Criando novas compilações do Gradle ou o guia Construindo Maven para obter mais informações sobre como configurar seu projeto.

Adicionar MongoDB como dependência

Se você estiver usando o Gradle para gerenciar seus pacotes, adicione a seguinte entrada à sua build.gradle.kts lista de dependências do :

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

Se você estiver usando o Maven para gerenciar seus pacotes, adicione a seguinte entrada à sua pom.xml lista de dependências do :

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

Depois de configurar suas dependências, certifique-se de que elas estejam disponíveis para seu projeto executando o gerenciador de dependências e atualizando o projeto em seu IDE.

Adicionar dependências da biblioteca de serialização

Para habilitar o driver para converter entre objetos Kotlin e BSON, o formato de dados para documentos no MongoDB, você também deve adicionar um ou ambos os seguintes pacotes de serialização ao seu aplicativo:

• bson-kotlinx (Recomendado)

• bson-kotlin

Se você estiver usando o Gradle para gerenciar seus pacotes, adicione uma das seguintes entradas à sua lista de dependências do build.gradle.kts:

implementation("org.mongodb:bson-kotlinx:5.2.1")
// OR
implementation("org.mongodb:bson-kotlin:5.2.1")

Se você estiver usando o Maven para gerenciar seus pacotes, adicione uma das seguintes entradas à sua lista de dependências do pom.xml:

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlinx</artifactId>
    <version>5.2.1</version>
</dependency>
<!--OR-->
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlin</artifactId>
    <version>5.2.1</version>
</dependency>

Depois de configurar suas dependências, certifique-se de que elas estejam disponíveis para seu projeto executando o gerenciador de dependências e atualizando o projeto em seu IDE.

Para saber mais sobre esses pacotes, consulte Serialização Kotlin .

Consulte seu cluster MongoDB a partir de seu aplicativo

Em seguida, crie um arquivo chamado QuickStartDataClassExample.kt em seu projeto.

Copie o código de exemplo a seguir no arquivo e substitua o valor da variável uri pela cadeia de conexão do MongoDB Atlas que você salvou na etapa anterior. Substitua o espaço reservado "<password>" da connection string pela senha que você definiu para o usuário com permissões atlasAdmin:

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.coroutine.MongoClient
import io.github.cdimascio.dotenv.dotenv
import kotlinx.coroutines.flow.firstOrNull
import kotlinx.coroutines.runBlocking
// Create data class to represent a MongoDB document
data class Movie(val title: String, val year: Int, val cast: List<String>)
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = CONNECTION_STRING_URI_PLACEHOLDER
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    // Get a collection of documents of type Movie
    val collection = database.getCollection<Movie>("movies")
    runBlocking {
        val doc = collection.find(eq("title", "Back to the Future")).firstOrNull()
        if (doc != null) {
            println(doc)
        } else {
            println("No matching documents found.")
        }
    }
    mongoClient.close()
}

Ao executar a função main, o aplicativo imprime os detalhes de um documento de filme que corresponde à consulta, como mostrado na seguinte saída:

Movie(
   title=Back to the Future,
   year=1985,
   cast=[Michael J. Fox, Christopher Lloyd, Lea Thompson, Crispin Glover]
)

Se você não vir nenhuma saída ou receber um erro, verifique se incluiu a connection string adequada em seu aplicação. Além disso, confirme se você carregou com êxito o conjunto de dados de amostra em seu cluster MongoDB Atlas.

javax.net.ssl.SSLHandshakeException: extension (5) should not be presented in certificate_request

Depois de concluir esta etapa, você tem um aplicativo funcional que usa o driver Kotlin para se conectar ao cluster MongoDB, executar uma consulta nos dados de amostra e imprimir o resultado.

Trabalhando com a classe de documento (Alternativa)

A seção anterior demonstra como executar uma consulta em uma coleção de exemplo para recuperar dados usando uma classe de dados Kotlin. Esta seção mostra como usar a classe Documento para armazenar e recuperar dados do MongoDB.

Em um novo arquivo denominado QuickStartDocumentExample.kt, cole o seguinte código de amostra para executar uma consulta no seu conjunto de dados de amostra no Atlas MongoDB. Substitua o valor da variável uri pela connection string do MongoDB Atlas:

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.coroutine.MongoClient
import io.github.cdimascio.dotenv.dotenv
import kotlinx.coroutines.flow.firstOrNull
import kotlinx.coroutines.runBlocking
import org.bson.Document
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = CONNECTION_STRING_URI_PLACEHOLDER
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Document>("movies")
    runBlocking {
        val doc = collection.find(eq("title", "Back to the Future")).firstOrNull()
        if (doc != null) {
            println(doc.toJson())
        } else {
            println("No matching documents found.")
        }
    }
    mongoClient.close()
}

Ao executar a função main, o aplicativo imprime os detalhes de um documento de filme que corresponde à consulta, como mostrado na seguinte saída:

{
  _id: ...,
  plot: 'A young man is accidentally sent 30 years into the past...',
  genres: [ 'Adventure', 'Comedy', 'Sci-Fi' ],
  ...
  title: 'Back to the Future',
  ...
}

Se você não vir nenhuma saída ou receber um erro, verifique se incluiu a connection string adequada em seu aplicação. Além disso, confirme se você carregou com êxito o conjunto de dados de amostra em seu cluster MongoDB Atlas.