Configuración de socket

Overview

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

Puede especificar la configuración de sus enchufes utilizando ya sea un cadena de conexión o al pasar una MongoClientSettings objeto al constructor de MongoClients. Selecciona el Connection String o la pestaña 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 más información sobre estos parámetros, vea el 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). `0`Predeterminado:, 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 a la applyToProxySettings() 5 5 configuración de tu5 socket para conectarte a MongoDB mediante un proxy SOCKS. Para aprender a usar un proxy SOCKS y configurarlo, consulta la guía "Conectarse a MongoDB mediante un proxy SOCKS ".

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 sobre los métodos encadenados, consulte la documentación de la API MongoClientSettings.Builder.

Volver

Configuración del servidor

Configurar los ajustes CRUD a nivel de cliente