Especificar configurações do MongoClient

Visão geral

Neste guia, você aprenderá sobre as diferentes configurações para controlar o comportamento do seu MongoClient.

As seções a seguir descrevem as configurações comumente usadas:

• Configurações do MongoClient

• Configurações de clusters

• Configurações do soquete

• Configurações do Pool de Conexões

• Configurações do Servidor

• Configurações TLS/SSL

Configurações do MongoClient

Você pode controlar o comportamento do seu MongoClient criando e passando um objeto MongoClientSettingspara o método MongoClients.create().

Para criar um objeto MongoClientSettings, utilize o método MongoClientSettings.builder() e métodos de cadeia para especificar suas configurações. Após encadeá-los, use o método build() para criar o objeto MongoClientSettings.

A tabela a seguir descreve os métodos que você pode criar para modificar seu comportamento de conexão:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("<your connection string>"))
    .build());

MongoClient mongoClient = MongoClients.create(
   MongoClientSettings.builder().applyConnectionString(new ConnectionString("mongodb+srv://<db_username>:<db_password>@<hostname>:<port>/<auth db>?connectTimeoutMS=2000"))
      .applyToSocketSettings(builder ->
      builder.connectTimeout(5L, SECONDS))
      .build());

Configurações de clusters

Encadeie o método applyToClusterSettings() para modificar o comportamento do driver ao interagir com o cluster do MongoDB.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

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

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

Configurações do Pool de Conexões

Encadeie o método applyToConnectionPoolSettings() para modificar a maneira como o driver gerencia seu pool de conexões.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToConnectionPoolSettings(builder ->
        builder.maxWaitTime(10, SECONDS)
        .maxSize(200)
    .build());

Configurações do registrador

Encadeie o método applyToLoggerSettings() para modificar o comportamento de registro do driver.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento de registro:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToLoggerSettings(builder ->
         builder.maxDocumentLength(5_000))
    .build());

Configurações do Servidor

Encadeie o método applyToServerSettings() para modificar o comportamento do driver ao monitorar cada implantação do MongoDB.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToServerSettings(builder ->
        builder.minHeartbeatFrequency(700, MILLISECONDS)
        .heartbeatFrequency(15, SECONDS))
    .build());

Configurações do soquete

Encadeie o método applyToSocketSettings() para modificar o comportamento do driver ao se conectar e se comunicar com sua implantação do MongoDB.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

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

Configurações TLS/SSL

Encadeie o método applyToSslSettings() para modificar o comportamento do driver ao usar TLS/SSL para proteger uma conexão entre o aplicativo e o MongoDB.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder().applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToSslSettings(builder ->
        builder.enabled(true))
    .build());