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 |
|---|---|
| Obrigatório. Um prefixo que identifica o URI como uma string no formato de conexão padrão. |
| Opcional. Credenciais de autenticação. Se você incluir estes, o cliente autenticará o usuário no banco de banco de dados especificado no Para obter mais informações sobre a opção de conexão do |
| 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, |
| Opcional. O authentication database de autenticação a ser usado se a connection string incluir as credenciais de autenticação |
| Opcional. Uma string da query que especifica opções específicas de conexão como 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: