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 implantação 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 string de conexão e usar um objeto MongoClient para se 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:
This figure uses the Standard Connection String Format, mongodb for the protocol. You can also use the DNS Seed List Connection Format, mongodb+srv, if you want more flexibility of deployment and the ability to change the servers in rotation without reconfiguring clients.
Observação
If your deployment is on MongoDB Atlas, see the Atlas driver connection guide and select Kotlin from the language dropdown to retrieve your 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 e w=majority. 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 aprender mais sobre as diferentes configurações que você pode utilizar para controlar o comportamento do seu MongoClient, 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: