Crea un MongoClient

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 de Kotlin Sync a qué implementación de MongoDB conectarse.
Un objeto MongoClient, que crea la conexión y realiza operaciones en la implementación de MongoDB.

También puedes utilizar MongoClientSettings para personalizar la forma en que se comporta el controlador Kotlin Sync mientras está conectado a MongoDB.

Esta guía muestra cómo crear una cadena de conexión y usar un objeto MongoClient para realizar la conexión a MongoDB.

URI de conexión

Una cadena de conexión estándar incluye los siguientes componentes:

Componente	Descripción
`mongodb://`	Requerido. Un prefijo que identifica esto como un string en el formato de conexión estándar.
`db_username:db_password`	Opcional. Credenciales de autenticación. Si las incluye, el cliente autentica al usuario de la base de datos con la base de datos especificada en `authSource`. Para obtener más información sobre la opción de conexión `authSource`, consulte Mecanismos de autenticación.
`host[:port]`	Requerido. El host y el número de puerto opcional donde se ejecuta MongoDB. Si no incluyes el número de puerto, el controlador utiliza el puerto por defecto, `27017`.
`/defaultauthdb`	Opcional. La base de datos de autenticación que se debe usar si la cadena de conexión incluye las credenciales de autenticación `db_username:db_password@` pero no la opción `authSource`. Si no incluyes este componente, el cliente autentica al usuario contra la base de datos `admin`.
`?<options>`	Opcional. Un string del query que especifica opciones específicas de conexión como pares `<name>=<value>`. Consulta Opciones de conexión para obtener una descripción completa de estas opciones.

Para obtener más información sobre cómo crear una cadena de conexión, consulte Cadenas de conexión en la documentación del servidor MongoDB.

Ejemplo de Conexión de Atlas

Para conectarse a una implementación de MongoDB en Atlas, primero debe crear un cliente.

Puede pasar una URI de conexión como una cadena al método MongoClient.create() para conectarse a una instancia de MongoDB:

// Replace the placeholder with your Atlas connection string
val uri = "<connection string>"
// Create a new client and connect to the server
val mongoClient = MongoClient.create(uri)
val database = mongoClient.getDatabase("sample_mflix")

También puede crear un cliente con las configuraciones deseadas pasando un objeto MongoClientSettings al método MongoClient.create().

Para instanciar un objeto MongoClientSettings, utilice el método constructor para especificar la cadena de conexión, utilizando el método applyConnectionString() y cualquier otra opción del cliente. Una vez que tenga la configuración deseada, llame al método build().

Puedes configurar la opción de cliente de Stable API para evitar cambios disruptivos al actualizar a una nueva versión del servidor. Para obtener más información sobre la funcionalidad Stable API, consulta la página Stable API.

El siguiente código muestra cómo se puede especificar la cadena de conexión y la opción de cliente de la Stable API al conectarse a una implementación de MongoDB en Atlas y verificar que la conexión sea exitosa:

// Replace the placeholder with your Atlas connection string
val uri = "<connection string>"
val mongoClient1 = MongoClient.create(uri)
// end-connect-to-atlas-w-uri
// Construct a ServerApi instance using the ServerApi.builder() method
val serverApi = ServerApi.builder()
    .version(ServerApiVersion.V1)
    .build()
val settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString(uri))
    .serverApi(serverApi)
    .build()
// Create a new client and connect to the server
val mongoClient = MongoClient.create(settings)
val database = mongoClient.getDatabase("sample_mflix")
try {
    // Send a ping to confirm a successful connection
    val command = Document("ping", BsonInt64(1))
    val commandResult = database.runCommand(command)
    println("Pinged your deployment. You successfully connected to MongoDB!")
} catch (me: MongoException) {
    System.err.println(me)
}

Documentación de la API

Para obtener más información sobre cómo crear un objeto MongoClient con el driver Kotlin sincronizar, consulta la siguiente documentación de la API:

Volver

Conectar

Elija un destino de conexión