/ /

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 al pasar una MongoClientSettings objeto para el constructor MongoClient. Selecciona el Connection String o la 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 para que la selección del servidor tenga éxito antes de lanzar una excepción. por defecto: `30000` (30 segundos)
`localThresholdMS`	entero	Al comunicarse con múltiples instancias de MongoDB en un set de réplicas, el driver solo envía solicitudes a un servidor cuya respuesta es menor o igual a la del 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 driver intenta encontrar a todos los nodos de ese conjunto. Por defecto: `null`
`directConnection`	booleano	Especifica que el controlador debe conectarse directamente al host. Esto equivale a aplicar `mode(ClusterConnectionMode.SINGLE)` a tu `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 SRV el driver recupera para construir tu lista de nodos iniciales. Debe utilizar el formato de conexión de lista de nodos iniciales de DNS en su URI de conexión para utilizar 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, consulta la Cadena de conexión documentación de la API.

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 puedes encadenar a tu configuración para modificar el comportamiento del driver:

Método

Descripción

addClusterListener()

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

applyConnectionString()

Usa los parámetros de un objeto ConnectionString.

applySettings()

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

hosts()

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

localThreshold()

Define la cantidad de tiempo que puede tomar un viaje de ida y vuelta a 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 requerido para el clúster.

requiredReplicaSetName()

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

serverSelectionTimeout()

Establece el tiempo máximo para seleccionar un nodo primario antes de lanzar una excepción por tiempo de espera.

Por defecto: 30 seconds

serverSelector()

Agrega un selector de servidor para aplicar antes de la selección del 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 el número máximo de hosts a los que el driver puede conectarse cuando se utiliza el protocolo de conexión de la lista de nodos iniciales DNS (SRV), identificado por el prefijo de la 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