Criar um MongoClient

Nesta página

Visão geral

URI de conexão
Cliente Mongo
Documentação da API

Visão geral

Para se conectar a um MongoDB deployment, você precisa de duas coisas:

Um URI de conexão, também conhecido como string de conexão, que informa ao driver do Java Reactive Streams a qual deployment do MongoDB se conectar.
Uma instância MongoClient , que cria conexões com a implantação do MongoDB e permite executar operações nele.

Você também pode usar qualquer um desses componentes para personalizar a maneira como o driver Java Reactive Streams se comporta enquanto conectado ao MongoDB.

Este guia mostra como criar uma string de conexão e utilizar uma instância do MongoClient para conectar ao MongoDB.

URI de conexão

Uma connection string padrão inclui os seguintes componentes:

Componente	Descrição
`mongodb://`	Obrigatório. Um prefixo que identifica o URI como uma string no formato de conexão padrão.
`username:password`	Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de banco de dados especificado no `authSource`. Para obter mais informações sobre a opção de conexão do `authSource` , consulte o guia deautenticação do .
`host[:port]`	Obrigatório. O host e o número da porta em que o MongoDB está sendo executado. Se você não incluir um número de porta, o driver usará a porta padrão, `27017`.
`/defaultauthdb`	Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação `username:password@` , mas não a opção `authSource` . Se você não incluir este componente, o cliente autenticará o usuário no banco de dados do `admin` .
`?<options>`	Opcional. Uma string da query que especifica opções específicas de conexão como `<name>=<value>` pares. Para obter uma descrição completa dessas opções, consulte o guia Especificar opções de URI de conexão .

Para obter mais informações sobre a criação de uma connection string, consulte connection strings na documentação do MongoDB Server .

Cliente Mongo

Para criar uma conexão com o MongoDB, passe um URI de conexão como uma string para o método que constrói um objeto MongoClient . No exemplo a seguir , o driver usa um URI de conexão de exemplo para se conectar a uma instância MongoDB na porta 27017 de localhost:

import com.mongodb.reactivestreams.client.MongoClients;
import com.mongodb.reactivestreams.client.MongoClient;
public class MongoConnection {
    public static void main(String[] args) {
        String uri = "mongodb://localhost:27017/";
        try (MongoClient client = MongoClients.create(uri)) {
            // use `client` here
        }
    }
}

Dica

Reutilizando seu cliente

Como cada instância MongoClient agrupa conexões com o banco de dados de dados, a maioria dos aplicativos exige somente uma única instância de MongoClient, mesmo em várias solicitações.

Documentação da API

Para saber mais sobre como criar uma instância do MongoClient no driver Java Reactive Streams, consulte a seguinte documentação da API:

Cliente Mongo

Voltar

Conecte

Escolha um destino de conexão