Overview
Para conectarte a una implementación de MongoDB, necesitas dos cosas:
Un URI de conexión, también conocido como cadena de conexión, que le indica al controlador de 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 puedes utilizar cualquiera de estos componentes para personalizar el comportamiento del controlador de Kotlin mientras esté conectado a MongoDB.
Esta guía muestra cómo crear una cadena de conexión y utilizar un 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 estándar de cadena de conexión, mongodb para el protocolo. También puedes usar el Formato de conexión de lista de nodos iniciales DNS, mongodb+srv, si quieres más flexibilidad en el despliegue y la capacidad de cambiar los servidores en rotación sin reconfigurar los clientes.
Nota
Si tu implementación está en MongoDB Atlas, consulta la Guía de conexión del driver de Atlas y selecciona Kotlin del menú desplegable de lenguaje para recuperar tu cadena de conexión.
La siguiente parte de la URI de conexión contiene tus credenciales si estás utilizando un mecanismo de autenticación basado en contraseña. Reemplaza el valor de user con tu nombre de usuario de base de datos y pass con la contraseña de tu usuario de base de datos. Si tu mecanismo de autenticación no requiere credenciales, omite 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 las opciones de conexión como parámetros. En el ejemplo, configuramos dos opciones de conexión: maxPoolSize=20 y w=majority. Para obtener más información sobre las opciones de conexión, consultar la
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 aprender sobre las diferentes configuraciones que puedes usar para controlar el comportamiento de tu MongoClient, consulta la guía 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: