Comece a usar o driver Kotlin Sync

Crie 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 a criar seu primeiro projeto, consulte Introdução ao Kotlin/ JVM na documentação da linguagem Kotlin.

Adicione 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.4.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.4.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.

Adicione o MongoDB como uma 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")
}

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>
    </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.

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

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>
</dependency>
<!--OR-->
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlin</artifactId>
</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 um MongoDB deployment gratuito no Atlas.

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

Salve 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 string de conexão 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 e navegue até a Clusters página na Database seção. Clique no Connect botão para sua nova implementação.

Se você ainda não tiver um usuário de banco de dados configurado, o MongoDB solicitará que você crie e configure um novo usuário.

Clique no botão Drivers na seção Connect to your application e selecione "Kotlin" no menu de seleção Driver e a versão que melhor corresponde à versão instalada no menu de seleção Version.

Certifique-se de que a opção View full code sample esteja desmarcada para visualizar somente a string de conexão.

Copie a string de conexão

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:

Atualize o espaço reservado para senha.

Cole esta string de conexão em um arquivo no editor de texto de sua preferência e substitua o espaço reservado <db_password> pela senha do usuário do banco de dados . A string de conexão já está preenchida com o nome de usuário do usuário do banco de dados .

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

Crie o arquivo do aplicação .

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.")
    }
}

Execute 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.

Use a classe 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 a classe Documento 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.