/ /

Java Sync Driver

Docs Home

Librerías de clientes

Java

Java Sync Driver

Docs Home

Librerías de clientes

Java

Java Sync Driver

Configuración del clúster

Overview

En esta guía, puede aprender cómo el controlador Java administra los clústeres.

Puede especificar configuraciones para sus clústeres mediante un cadena de conexión o pasando una MongoClientSettings objeto al constructor MongoClient. Seleccione el Connection String o pestaña MongoClientSettings para ver las opciones disponibles:

Incluya los siguientes parámetros en su cadena de conexión para modificar el comportamiento del controlador al interactuar con su clúster MongoDB:

Nombre de la opción	Tipo	Descripción
`serverSelectionTimeoutMS`	entero	Especifica la cantidad máxima de tiempo, en milisegundos, que el controlador espera a que la selección del servidor tenga éxito antes de generar una excepción. Predeterminado: `30000` (30 segundos)
`localThresholdMS`	entero	Al comunicarse con varias instancias de MongoDB en un conjunto de réplicas, el controlador envía solicitudes solo a un servidor cuyo tiempo de respuesta sea menor o igual al servidor con el tiempo de respuesta más rápido más el umbral local, en milisegundos. Por defecto: `15`
`replicaSet`	string	Especifica que la cadena de conexión proporcionada incluye varios hosts. Cuando se especifica, el controlador intenta encontrar todos los miembros de ese conjunto. Por defecto: `null`
`directConnection`	booleano	Especifica que el controlador debe conectarse directamente al host. Esto implica aplicar `mode(ClusterConnectionMode.SINGLE)` a su `MongoClientSettings`. Por defecto: `false`
`loadBalanced`	booleano	Especifica si el controlador se conecta o no a MongoDB mediante un balanceador de carga. Por defecto: `null`
`srvServiceName`	string	Especifica el nombre del servicio del Registros de recursos SRVEl controlador recupera la información para construir su lista de semillas. Debe usar el formato de conexión de lista de semillas DNS en la URI de conexión para usar esta opción. Por defecto: `mongodb`

Este ejemplo conecta el controlador directamente a un servidor, independientemente del tipo de clúster MongoDB del que forme parte:

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

Para obtener más información sobre estos parámetros, consulte la documentación de la API ConnectionString.

Encadene el método applyToClusterSettings() para modificar el comportamiento del controlador al interactuar con su clúster MongoDB.

La siguiente tabla describe los métodos que puede encadenar a su configuración para modificar el comportamiento del controlador:

Método

Descripción

addClusterListener()

Agrega un detector para eventos relacionados con el clúster.

applyConnectionString()

Utiliza la configuración de un objeto ConnectionString.

applySettings()

Utiliza la configuración de clúster especificada en un objeto ClusterSettings.

hosts()

Establece todas las ubicaciones especificadas de una implementación de Mongo.

localThreshold()

Establece la cantidad de tiempo que puede tomar el viaje de ida y vuelta de un servidor y aún ser elegible para la selección de servidor.

Por defecto: 15 milliseconds

mode()

Configura cómo conectarse a una implementación de MongoDB.

requiredClusterType()

Establece el tipo de clúster necesario para el clúster.

requiredReplicaSetName()

Establece el nombre del conjunto de réplicas requerido para el clúster.

serverSelectionTimeout()

Establece el tiempo máximo para seleccionar un nodo principal antes de generar una excepción de tiempo de espera.

Por defecto: 30 seconds

serverSelector()

Agrega un selector de servidor para aplicar antes de la selección de servidor.

srvHost()

Establece el nombre de host que se utilizará para buscar un registro DNS SRV para encontrar los hosts de MongoDB.

Si desea habilitar el procesamiento de registros TXT asociados con el host, especifique el host SRV en la cadena de conexión utilizando el método applyConnectionString().

Por ejemplo:

MongoClient mongoClient =
  MongoClients.create(MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("mongodb+srv://host1.acme.com")))

srvMaxHosts()

Establece la cantidad máxima de hosts a los que el controlador puede conectarse cuando utiliza el protocolo de conexión de lista de semillas DNS (SRV), identificado por el prefijo de cadena de conexión mongodb+srv.

Lanza una excepción si no está utilizando el protocolo de conexión SRV.

Este ejemplo conecta el controlador directamente a un servidor, independientemente del tipo de clúster MongoDB del que forme parte:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyToClusterSettings(builder ->
        builder.mode(ClusterConnectionMode.SINGLE))
    .build());

Tip

Esto es similar al parámetro directConnection que puede especificar en la URI de conexión. Consulte la pestaña Cadena de conexión para obtener más información.

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

Volver

Pools de conexiones

Configuración del servidor