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 Kotlin a qual sistema do MongoDB se conectar.
Um objeto MongoClient , que cria a conexão com a implantação do MongoDB e permite que você execute operações nele.
Você também pode usar qualquer um desses componentes para personalizar a maneira como o driver Kotlin se comporta enquanto conectado ao MongoDB.
Este guia mostra como criar uma connection string e utilizar um objeto MongoClient para conectar ao MongoDB.
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:
Esta figura usa o formato demongodb cadeia de conexão padrão, para o protocolo. Você também pode usar o formato de conexão da listamongodb+srv de sementes de DNS,, se desejar mais flexibilidade de implantação e a capacidade de alterar os servidores em rotação sem reconfigurar os clientes.
Observação
Se a sua implantação estiver no MongoDB Atlas, consulte o guia de conexão do driver do Atlas e selecione Kotlin na lista suspensa de idioma para recuperar sua connection string.
A próxima parte do URI de conexão 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 do banco de dados de dados, e pass pela senha de usuário do banco de dados de dados. 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, definimos duas opções de conexão: maxPoolSize=20 w=majoritye. Para obter mais informações sobre as opções de conexão, consulte o guia Opções de conexão.
Cliente Mongo
Você pode se conectar e se comunicar com MongoDB usando a classe MongoClient.
Utilize o método MongoClient.create() para construir um MongoClient.
O código abaixo mostra como criar um MongoClient que se conecta a uma implantação local do MongoDB:
import com.mongodb.kotlin.client.coroutine.MongoClient val uri = "mongodb://localhost:27017/" val client = MongoClient.create(uri)
Importante
Reutilize seu cliente
Como cada MongoClient representa um repositório seguro de conexões com o banco de dados, a maioria dos aplicativos requer apenas uma única instância de um MongoClient, mesmo em vários threads. 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 MongoClient seu, consulte o guia de configurações do MongoClient.
Dica
Sempre chame MongoClient.close() para limpar recursos quando uma instância não for mais necessária.
Documentação da API
Para obter mais informações sobre os métodos e as classes mencionadas nesta seção, consulte a seguinte documentação da API: