Especifica opciones de conexión

Establecer opciones en la URI de conexión

Si pasa una URI de conexión al método MongoClient.create(), puede incluir opciones de conexión en la cadena como pares <name>=<value>. En el siguiente ejemplo, la URI de conexión contiene la opción connectTimeoutMS con un valor de 60000 y la opción tls con un valor de true:

val uri = "mongodb://<hostname>:<port>/?connectTimeoutMS=60000&tls=true"
val mongoClient = MongoClient.create(uri)

Establecer opciones en MongoClientSettings

Puede establecer opciones de conexión en una instancia MongoClientSettings utilizando métodos de la clase MongoClientSettings.Builder y luego pasando el objeto de configuración al método MongoClient.create().

Configurar la conexión de esta manera facilita el cambio de configuraciones en tiempo de ejecución y puede ayudarle a detectar errores en tiempo de compilación.

El siguiente ejemplo muestra cómo especificar el destino de conexión y ajustar otras opciones al crear una instancia de MongoClientSettings:

val settings = MongoClientSettings.builder()
    .applyToClusterSettings { builder -> builder.hosts(listOf(ServerAddress("localhost", 27017))) }
    .applyToSocketSettings { builder -> builder.connectTimeout(60000, TimeUnit.MILLISECONDS) }
    .applyToSslSettings { builder -> builder.enabled(true) }
    .build()
 val mongoClient = MongoClient.create(settings)

Si prefiere proporcionar una cadena de conexión en lugar de especificar el nombre de host y el puerto, puede usar el método applyConnectionString() y luego configurar otras opciones mediante los métodos del generador, como se muestra en el siguiente código:

val uri = "<connection string>"
val settings = MongoClientSettings.builder()
    .applyConnectionString(ConnectionString(uri))
    .applyToSocketSettings { builder -> builder.connectTimeout(60000, TimeUnit.MILLISECONDS) }
    .applyToSslSettings { builder -> builder.enabled(true) }
    .build()
val mongoClient = MongoClient.create(settings)

Compresión de la red

Tiempos de espera

applyToSocketSettings{ builder ->
    builder.connectTimeout(10, TimeUnit.SECONDS)
}

applyToSocketSettings{ builder ->
    builder.readTimeout(5, TimeUnit.SECONDS)
}

Selección de servidores

applyToClusterSettings{ builder ->
    builder.serverSelectionTimeout(30, TimeUnit.SECONDS)
}

Autenticación

credential(
    MongoCredential.createScramSha256Credential(...)
)

Operaciones de lectura y escritura

Para obtener más información sobre cómo conectar con diferentes tipos de implementaciones de MongoDB, consulta la guía Elige un Target de Conexión.

applyToClusterSettings{ builder ->
    builder.mode(ClusterConnectionMode.SINGLE)
}

applyToClusterSettings{ builder ->
    builder.localThreshold(35, TimeUnit.MILLISECONDS)
}

Documentación de la API

Para obtener más información sobre las clases y los métodos mencionados en esta guía, consulte la siguiente documentación de API:

• MongoClientSettings

• Configuración del cliente de Mongo.Builder

• Cadena de conexión

• Configuración del socket

• Configuración del clúster

• Credencial de Mongo