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 a desarrollar con Kotlin/JVM, consulte "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á utilizando un IDE, consulte la guía Creación de nuevas compilaciones de Gradle o la guía Creación de Maven para obtener más información sobre cómo configurar su proyecto.

Agregar la lista de materiales del conductor

En su IDE, cree un nuevo proyecto Maven o Gradle. Agregue la Lista de Materiales (BOM) de los artefactos de la JVM de MongoDB a su proyecto para organizar las versiones de las dependencias. La BOM simplifica la gestión de dependencias, garantizando el mantenimiento de versiones consistentes y compatibles, por ejemplo, entre el controlador de Kotlin y la biblioteca principal de controladores. Use la BOM para evitar conflictos de versiones y simplificar las actualizaciones.

Seleccione entre las siguientes opciones Maven y Gradle pestañas para ver instrucciones para agregar la lista de materiales para cada administrador de dependencia:

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

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

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 está utilizando Gradle para administrar sus paquetes, agregue la siguiente entrada a su build.gradle.kts lista de dependencias:

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

Si está utilizando Maven para administrar sus paquetes, agregue la siguiente entrada a su pom.xml lista de dependencias:

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

Dado que instaló la BOM, puede omitir una versión en la entrada de dependencia del controlador Kotlin. La versión que especifique en la BOM determinará las versiones de dependencia 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 biblioteca de serialización

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

• bson-kotlinx (Recomendado)

• bson-kotlin

Si está utilizando Gradle para administrar sus paquetes, agregue una de las siguientes entradas a su lista de dependencias build.gradle.kts:

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

Si está utilizando Maven para administrar sus paquetes, agregue una de las siguientes entradas a su 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, consulte Serialización de Kotlin.

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

A continuación, cree un archivo llamado QuickStartDataClassExample.kt en su 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 ejecuta la función main, la aplicación imprime los detalles de un documento de película que coincide con la consulta, 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 ve ningún resultado o recibe un error, compruebe si incluyó la cadena de conexión correcta en su aplicación. Además, confirme que cargó correctamente el conjunto de datos de muestra en su 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.

Trabajar con la clase 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 ejecuta la función main, la aplicación imprime los detalles de un documento de película que coincide con la consulta, 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 ve ningún resultado o recibe un error, compruebe si incluyó la cadena de conexión correcta en su aplicación. Además, confirme que cargó correctamente el conjunto de datos de muestra en su clúster de MongoDB Atlas.