Conecte-se ao MongoDB

Cliente Mongo

Você pode se conectar e se comunicar com MongoDB usando a classe MongoClient.

Utilize o método MongoClients.create() para construir um MongoClient.

Todos os limites de uso de recursos, como conexões máximas, se aplicam a instâncias individuais do MongoClient.

Para saber mais sobre as diferentes configurações que você pode utilizar para controlar o comportamento do seu MongoClient, consulte o guia em Configurações do MongoClient.

URI de conexão

O URI de conexão fornece um conjunto de instruções que o driver utiliza para se conectar a uma implantação MongoDB. Ele instrui o driver sobre como deve se conectar ao MongoDB e como deve se comportar enquanto conectado. A figura a seguir explica cada parte de um URI de conexão de amostra:

Neste exemplo, você se conecta a um sistema do Atlas MongoDB que tem um registro DNS SRV. Para obter mais detalhes, consulte a documentação do Formato de Conexão da Lista de Sementes DNS . Este formato oferece flexibilidade no sistema e a capacidade de alterar os servidores em rotação sem reconfigurar os clientes.

Se você estiver se conectando a uma instância ou conjunto de réplicas que não tenha um endereço SRV DNS, deverá usar mongodb para o protocolo, que especifica o Formato Padrão de Connection String.

Após o protocolo, a connection string contém suas credenciais se você estiver usando um mecanismo de autenticação baseado em senha. Substitua o valor de user pelo seu nome de usuário e pass pela sua senha. Se o mecanismo de autenticação não exigir credenciais, omita esta parte do URI de conexão.

A próxima parte do URI de conexão especifica o nome do host ou endereço IP, seguido pela porta da sua instância do MongoDB. No exemplo, sample.host representa o nome do host e 27017 é o número da porta. Substitua estes valores para consultar a sua instância MongoDB.

A última parte do URI de conexão contém opções de conexão como parâmetros. No exemplo, você define duas opções de conexão: maxPoolSize=20 e w=majority. Para obter mais informações sobre as opções de conexão, vá para a seção Opções de conexão deste guia.

Exemplo de conexão do Atlas

Para se conectar a uma implementação do MongoDB no Atlas, crie um cliente. Você pode criar um cliente que use sua conexão e outras opções do cliente passando um objeto MongoClientSettings para o método MongoClients.create() .

Para instanciar um objeto MongoClientSettings, use o método builder para especificar sua string de conexão e quaisquer outras opções de cliente e, em seguida, chame o método build(). Encadeie o método applyConnectionString() ao construtor para especificar seu URI de conexão.

Você pode definir a opção de cliente da versão Stable API para evitar alterações significativas ao atualizar para uma nova versão do servidor MongoDB. Para saber mais sobre o recurso de API estável, consulte a página de API estável.

O código a seguir mostra como você pode especificar a cadeia de conexão e a opção de cliente Stable API ao se conectar a uma implementação do MongoDB no Atlas e verificar se a conexão foi bem-sucedida:

package fundamentals;
import com.mongodb.*;
import org.bson.BsonDocument;
import org.bson.BsonInt64;
import org.bson.Document;
import org.bson.conversions.Bson;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoDatabase;
public class MongoClientConnectionExample {
    public static void main(String[] args) {
        // Replace the placeholder with your Atlas connection string
        String uri = "<connection string>";
        // Construct a ServerApi instance using the ServerApi.builder() method
        ServerApi serverApi = ServerApi.builder()
                .version(ServerApiVersion.V1)
                .build();
        MongoClientSettings settings = MongoClientSettings.builder()
                .applyConnectionString(new ConnectionString(uri))
                .serverApi(serverApi)
                .build();
        // Create a new client and connect to the server
        try (MongoClient mongoClient = MongoClients.create(settings)) {
            MongoDatabase database = mongoClient.getDatabase("admin");
            try {
                // Send a ping to confirm a successful connection
                Bson command = new BsonDocument("ping", new BsonInt64(1));
                Document commandResult = database.runCommand(command);
                System.out.println("Pinged your deployment. You successfully connected to MongoDB!");
            } catch (MongoException me) {
                System.err.println(me);
            }
        }
    }
}

Outras maneiras de se conectar ao MongoDB

Se estiver se conectando a uma única implementação ou conjunto de réplicas do MongoDB que não esteja hospedado no Atlas, consulte as seções a seguir para saber como se conectar.