Comenzar con el driver de Kotlin

Install Kotlin

Asegúrese de que su sistema tenga Kotlin instalado y ejecutándose en JDK 1.8 o posterior. Para obtener más información sobre cómo comenzar con el desarrollo de Kotlin/JVM, consulte la Comenzar con Kotlin/JVM en la documentación del lenguaje Kotlin.

Crea el proyecto

Esta guía le muestra cómo agregar las dependencias del controlador Kotlin de MongoDB mediante Gradle o Maven. Le recomendamos usar un entorno de desarrollo integrado (IDE) como IntelliJ IDEA o Eclipse IDE para configurar Gradle o Maven y compilar y ejecutar su proyecto.

Si no estás utilizando un IDE, consulta la Guía para crear nuevas compilaciones de Gradle o la Guía para la compilación con Maven para obtener más información sobre cómo configurar tu proyecto.

Agregar la lista de materiales del conductor

En tu IDE, crea un nuevo Maven o Gradle proyecto. Agrega la lista de materiales (BOM) para los artefactos JVM de MongoDB a tu proyecto para organizar las versiones de las dependencias. El BOM simplifica la gestión de dependencias al garantizar que mantengas versiones consistentes y compatibles de las dependencias, como la del driver de Kotlin y la de la librería central del driver. Utiliza el BOM para evitar conflictos de versiones y simplificar las actualizaciones.

Seleccione de lo siguiente Maven y Gradle pestañas para ver las instrucciones de añadir la BOM para cada gestor de dependencias:

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

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

Para ver una lista de dependencias que gestiona el BOM, consulta la mongodb-driver-bom dependency listing en el sitio web de Maven Repositorio.

Agregar MongoDB como una dependencia

Si utiliza Gradle para gestionar tus paquetes, agregue la siguiente entrada a tu lista de dependencias de build.gradle.kts:

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

Si usas Maven para gestionar tus paquetes, agrega la siguiente entrada a tu lista de dependencias pom.xml:

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

Porque ya instalaste el BOM, puedes omitir una versión en la entrada de dependencia del controlador de Kotlin. La versión que especifique en el BOM determina las versiones de dependencias que se instalarán.

Después de configurar tus dependencias, se debe garantizar de que estén disponibles para el proyecto ejecutando el administrador de dependencias y actualizando el proyecto en el IDE.

Agregar dependencias de la librería de serialización

Para permitir que el controlador convierta entre objetos Kotlin y BSON, el formato de datos para documentos en MongoDB, también debes agregar uno o ambos de los siguientes paquetes de serialización a tu aplicación:

• bson-kotlinx (Recomendado)

• bson-kotlin

Si estás usando Gradle para gestionar tus paquetes, agrega una de las siguientes entradas a tu lista de dependencias build.gradle.kts:

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

Si usas Maven para gestionar tus paquetes, añade una de las siguientes entradas a tu lista de dependencias pom.xml:

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

Después de configurar tus dependencias, se debe garantizar de que estén disponibles para el proyecto ejecutando el administrador de dependencias y actualizando el proyecto en el IDE.

Para obtener más información sobre estos paquetes, consulta Serialización de Kotlin.

Se debe realizar un query en el clúster de MongoDB desde la aplicación

A continuación, crea un archivo llamado QuickStartDataClassExample.kt en tu proyecto.

Copia el siguiente código de muestra en el archivo y reemplaza el valor de la variable uri con tu cadena de conexión de MongoDB Atlas que guardaste en el paso anterior. Reemplaza el marcador de posición <db_password> de tu cadena de conexión con la contraseña que configuraste para tu usuario que tiene permisos de 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()
}

Cuando se ejecuta la función main, la aplicación imprime los detalles de un documento de película que coincide con la query, como se muestra en la siguiente salida:

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

Si no ves ningún resultado o recibes un error, verifica si incluiste la cadena de conexión correcta en tu aplicación. Además, verifica que hayas cargado correctamente el conjunto de datos de muestra en tu clúster de MongoDB Atlas.

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

Después de completar este paso, tendrá una aplicación funcional que utiliza el controlador Kotlin para conectarse a su clúster MongoDB, ejecutar una consulta en los datos de muestra e imprimir el resultado.

Trabajando con la clase de documento (alternativa)

La sección anterior muestra cómo ejecutar una query en una colección de muestra para recuperar datos utilizando una clase de datos Kotlin. Esta sección muestra cómo usar la clase documento para almacenar y recuperar datos de MongoDB.

En un nuevo archivo llamado QuickStartDocumentExample.kt, pegue el siguiente código de ejemplo para ejecutar una consulta en su conjunto de datos de ejemplo en MongoDB Atlas. Reemplace el valor de la variable uri con su cadena de conexión de 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()
}

Cuando se ejecuta la función main, la aplicación imprime los detalles de un documento de película que coincide con la query, como se muestra en la siguiente salida:

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

Si no ves ningún resultado o recibes un error, verifica si incluiste la cadena de conexión correcta en tu aplicación. Además, verifica que hayas cargado correctamente el conjunto de datos de muestra en tu clúster de MongoDB Atlas.