Overview
Para conectarte a una implementación de MongoDB, necesitas dos cosas:
Una URI de conexión, también conocida como cadena de conexión, que le indica al controlador Kotlin a qué implementación de MongoDB conectarse.
Un objeto MongoClient, que crea la conexión a la implementación de MongoDB y permite realizar operaciones en ella.
También puede utilizar cualquiera de estos componentes para personalizar la forma en que se comporta el controlador Kotlin mientras está conectado a MongoDB.
Esta guía le muestra cómo crear una cadena de conexión y utilizar una MongoClient objeto para conectarse a MongoDB.
URI de conexión
El URI de conexión proporciona un conjunto de instrucciones que el driver utiliza para conectarte a una implementación de MongoDB. Instruye al driver sobre cómo debe conectarse a MongoDB y cómo debe comportarse mientras está conectado. En la siguiente figura, se explica cada parte de un URI de conexión de muestra:
Esta figura utiliza el Formato mongodb de cadena de conexión estándar, para el protocolo. También puede usar el formato demongodb+srv conexión de lista de semillas DNS,, si desea mayor flexibilidad de implementación y la posibilidad de cambiar los servidores en rotación sin reconfigurar los clientes.
Nota
Si su implementación está en MongoDB Atlas, consulte la guía de conexión del controlador Atlas y seleccione Kotlin desde el menú desplegable de idioma para recuperar su cadena de conexión.
La siguiente parte del URI de conexión contiene sus credenciales si utiliza un mecanismo de autenticación basado en contraseña. Reemplace el valor user con el nombre de usuario de su base de datos y pass con la contraseña de dicho usuario. Si su mecanismo de autenticación no requiere credenciales, omita esta parte del URI de conexión.
La siguiente parte del URI de conexión especifica el nombre de host o la dirección IP, seguido del puerto de tu instancia de MongoDB. En el ejemplo, sample.host representa el nombre de host y 27017 es el número de puerto. Reemplaza estos valores para hacer referencia a tu instancia de MongoDB.
La última parte del URI de conexión contiene opciones de conexión como parámetros. En el ejemplo, se establecen dos opciones de conexión: maxPoolSize=20 y w=majority. Para obtener más información sobre las opciones de conexión, consulte
Guía deopciones de conexión.
MongoClient
Puede conectarse y comunicarse con MongoDB mediante la clase MongoClient.
Utilice el método MongoClient.create() para construir un MongoClient.
El siguiente código muestra cómo crear un MongoClient que se conecta a una implementación local de MongoDB:
import com.mongodb.kotlin.client.coroutine.MongoClient val uri = "mongodb://localhost:27017/" val client = MongoClient.create(uri)
Importante
Reutilizar el cliente
Dado que cada MongoClient representa un grupo seguro para subprocesos de conexiones a la base de datos, la mayoría de las aplicaciones solo requieren una única instancia de MongoClient, incluso en varios subprocesos. Todos los límites de uso de recursos, como el máximo de conexiones, se aplican a instancias individuales de MongoClient.
Para obtener más información sobre las diferentes configuraciones que puede utilizar para controlar el comportamiento de MongoClient su, consulte la guía de configuración de MongoClient.
Tip
Llama siempre a MongoClient.close() para limpiar recursos cuando una instancia ya no sea necesaria.
Documentación de la API
Para obtener más información sobre los métodos y clases mencionados en esta sección, consulte la siguiente documentación de API: