Comece a usar o driver Kotlin Sync

Criar um projeto Kotlin

Primeiro, certifique-se de que seu sistema tenha o Kotlin instalado e em execução no JDK 1.8 ou posterior.

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.

Para obter mais informações sobre como começar a usar o Kotlin e criar seu primeiro projeto, consulte Introdução ao Kotlin/ JVM na documentação da linguagem Kotlin .

Adicionar a lista de materiais do driver

No seu IDE, crie um novo projeto Maven ou Gradle. Adicione a lista de materiais (BOM) para artefatos JVM do MongoDB ao seu projeto para organizar as versões de dependência. O BOM simplifica o gerenciamento de dependências garantindo que você mantenha versões consistentes e compatíveis de dependências, como entre o driver Kotlin Sync e a biblioteca principal de drivers. Use o BOM para evitar conflitos de versão e simplificar as atualizações.

Selecione a partir das seguintes abas Maven e Gradle para visualizar as instruções para adicionar o BOM para cada gerenciador de dependência:

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.3.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.3.0"))
}

Para visualizar uma lista de dependências que o BOM gerencia, consulte a lista de dependência mongodb-driver-bom no site do Repositório Maven.

Adicionar MongoDB como dependência

Se você estiver utilizando a Mesa para gerenciar seus pacotes, adicione a seguinte entrada na sua lista de dependências do build.gradle.kts :

dependencies {
    implementation("org.mongodb:mongodb-driver-kotlin-sync:5.3.0")
}

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

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-kotlin-sync</artifactId>
        <version>5.3.0</version>
    </dependency>
</dependencies>

Como você instalou o BOM, você pode omitir uma versão na entrada de dependência do driver Kotlin Sync. A versão especificada no BOM determina as versões de dependência a serem instaladas.

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.3.0")
// OR
implementation("org.mongodb:bson-kotlin:5.3.0")

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.3.0</version>
</dependency>
<!--OR-->
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlin</artifactId>
    <version>5.3.0</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 de dados.

Crie uma MongoDB deployment gratuita no Atlas

Complete o guia Iniciar com Atlas para configurar uma nova conta Atlas e carregar dados de amostra em uma nova implantação MongoDB de camada gratuita.

Salvar suas credenciais

Depois de criar o usuário de banco de dados, salve o nome de usuário e a senha do usuário em um local seguro para uso em uma etapa futura.

Encontre sua connection string do MongoDB Atlas

Para recuperar a string de conexão da implantação criada na etapa anterior, faça login na sua conta do Atlas, navegue até a seção Database e clique no botão Connect da sua nova implantação.

Vá para a seção Connect your application e selecione Kotlin no menu de seleção Driver .

Selecione o mecanismo de autenticação Password (SCRAM).

Desmarque a opção Include full driver code example para visualizar somente a string de conexão.

Copie a connection string

Clique no botão à direita da string de conexão para copiá-la para a área de transferência, como mostrado na seguinte captura de tela:

Atualizar os espaços reservados

Cole esta connection string em um arquivo no editor de texto de sua preferência e substitua os placeholders <username> e <password> pelo seu nome de usuário e senha de utilizador de banco de dados.

Salve este arquivo em um local seguro para usar na próxima etapa.

Criar o Arquivo de Aplicativo

Crie um arquivo chamado DemoDataClassExample.kt em seu projeto.

Copie o código de exemplo a seguir no arquivo e substitua o valor do espaço reservado <connection URI string> pela string de conexão do MongoDB Atlas que você salvou na etapa anterior.

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.MongoClient
// Create data class to represent a MongoDB document
data class Movie(val title: String, val year: Int, val directors: List<String>)
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection URI string>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    // Find a document with the specified title
    val doc = collection.find(eq(Movie::title.name, "Before Sunrise")).firstOrNull()
    if (doc != null) {
        // Print the matching document
        println(doc)
    } else {
        println("No matching documents found.")
    }
}

Executar o aplicativo

Quando você executa o aplicação, ele imprime os detalhes de um documento de filme que corresponde à query, conforme mostrado na saída a seguir:

Movie(title=Before Sunrise, year=1995, directors=[Richard Linklater])

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.

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

Usar a classe de documento para modelar dados (Alternativa)

A etapa 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 o Documento classe para armazenar e recuperar dados do MongoDB.

Em um arquivo denominado DemoDocumentExample.kt, cole o seguinte código de amostra para executar uma query no seu conjunto de dados de amostra no MongoDB Atlas. Substitua o valor do espaço reservado <connection URI string> por sua string de conexão do MongoDB Atlas :

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection URI string>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Document>("movies")
    // Find a document with the specified title
    val doc = collection.find(eq("title", "Before Sunrise")).firstOrNull()
    if (doc != null) {
        // Print the matching document
        println(doc)
    } else {
        println("No matching documents found.")
    }
}

Quando você executa o aplicação, ele imprime os detalhes de um documento de filme que corresponde à query, conforme mostrado na saída a seguir:

Document{{_id=..., plot=A young man and woman ..., genres=[Drama, Romance], ...}}

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.