Menu Docs
Página inicial do Docs
/
Idiomas
/
Java
/
Driver de fluxos reativos do Java
/
Conecte-se ao MongoDB

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:

Voltar

Conecte-se ao MongoDB

Próximo

Escolha um destino de conexão