/ /

Configuración de socket

Overview

En esta guía, puedes aprender cómo el driver de Java gestiona la configuración de los sockets.

Puedes especificar la configuración de tus sockets utilizando una cadena de conexión o pasando un objeto MongoClientSettings al constructor MongoClients. Selecciona la pestaña Connection String o MongoClientSettings para ver las opciones disponibles:

Nombre de la opción	Tipo	Descripción
`connectTimeoutMS`	entero	Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador de Java espera a que se abra una conexión antes de que se agote el tiempo de espera. Un valor de `0` indica al driver que nunca agote el tiempo de espera mientras espera que se abra una conexión. por defecto: `10000` (10 segundos)
`socketTimeoutMS`	entero	Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador Java esperará para enviar o recibir una solicitud antes de que se agote el tiempo de espera. Un valor de `0` le indica al controlador que nunca agote el tiempo de espera mientras espera para enviar o recibir una solicitud. Por defecto: `0`

Este ejemplo especifica que el controlador se agotará después de 15 segundos de esperar a que se abra una conexión:

ConnectionString connectionString = "mongodb://<host>:<port>/?connectTimeoutMS=15000"
MongoClient mongoClient = MongoClients.create(connectionString)

Para obtener más información sobre estos parámetros, consulta la Cadena de conexión documentación de la API.

Encadene el método applyToSocketSettings() para modificar el comportamiento del controlador al conectarse y comunicarse con su implementación de MongoDB.

La siguiente tabla describe los métodos que puedes encadenar a tu configuración para modificar el comportamiento del driver:

Método	Descripción
`applyConnectionString()`	Usa los parámetros de un objeto `ConnectionString`.
`applySettings()`	Utiliza los ajustes de socket especificados en un objeto `SocketSettings`.
`connectTimeout()`	Establece el tiempo máximo para conectarse a un socket disponible antes de lanzar una excepción por tiempo de espera. Por defecto: `10 seconds`
`readTimeout()`	Establece el tiempo máximo para leer desde un socket disponible antes de lanzar una excepción de tiempo de espera (timeout). Por defecto: `0`, lo que indica que no hay tiempo de espera.
`receiveBufferSize()`	Establece el tamaño del búfer del socket al recibir. Por defecto: por defecto del sistema operativo
`sendBufferSize()`	Establece el tamaño del búfer del socket al enviar. Por defecto: por defecto del sistema operativo

Nota

Conectar a MongoDB usando un proxy SOCKS5

Puedes encadenar el método applyToProxySettings() a tus ajustes de socket para conectarte a MongoDB usando un proxy SOCKS5. Para aprender a utilizar un proxy SOCKS5 y configurar los ajustes del proxy, consulte la guía Conectarse a MongoDB usando un proxy SOCKS5 .

Este ejemplo especifica el siguiente comportamiento del controlador en un socket de MongoDB:

Para conectarse a un socket disponible dentro de 10 SECONDS
Para leer de un socket disponible dentro de 15 SECONDS

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToSocketSettings(builder ->
        builder.connectTimeout(10, SECONDS)
        .readTimeout(15, SECONDS))
    .build());

Para obtener más información acerca de los métodos encadenados, consulta la documentación de la API de MongoClientSettings.Builder .

Volver

Configuraciones del servidor

Configurar los ajustes CRUD a nivel de cliente