Crea un MongoClient

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 indica al driver de Kotlin sincronizar 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 el comportamiento del controlador Kotlin sincronizar 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 incluyes estos, el cliente autentica al usuario de base de datos contra la base de datos especificada en `authSource`. Para obtener más información sobre la opción de conexión `authSource`, consulta 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, consulta 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.

Puedes pasar un URI de conexión como string al método MongoClient.create() para conectar 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, use el método builder para especificar su cadena de conexión, utilizando el método applyConnectionString(), y cualquier otra opción del cliente. Una vez que hayas realizado la configuración deseada, llama al build() método.

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