Conecte-se ao MongoDB

Visão geral

Esta página contém exemplos de código que mostram como usar o driver Kotlin Sync para conectar seu aplicação ao MongoDB especificando várias configurações.

Dica

Opções de conexão

Para saber mais sobre as opções de conexão nesta página, consulte o link fornecido em cada seção. Você também pode visualizar o guia Especificar opções de conexão para saber mais.

Para usar um exemplo de conexão desta página, copie o exemplo de código no aplicativo de exemplo ou em seu próprio aplicativo. Certifique-se de substituir todos os espaços reservados nos exemplos de código, como <hostname>, pelos valores relevantes para sua implantação do MongoDB.

Aplicativo de amostra

Você pode usar o seguinte aplicativo de exemplo para testar os exemplos de código nesta página. Para usar o aplicativo de amostra, execute as seguintes etapas:

Verifique se você tem o driver Kotlin Sync instalado em seu projeto Maven ou Gradle.
Copie o seguinte código e cole-o em um novo arquivo .kt .
Copie um exemplo de código desta página e cole-o nas linhas especificadas no arquivo.

1import com.mongodb.kotlin.client.MongoClient2import org.bson.Document3
4fun main() {5
6    // Start example code here7
8    // End example code here9
10    val database = mongoClient.getDatabase("admin")11
12    val command = Document("ping", 1)13    val commandResult = database.runCommand(command)14    println("Pinged your deployment. You successfully connected to MongoDB!")15}

Conexão

As seções a seguir descrevem como se conectar a diferentes destinos, como uma instância local do MongoDB ou uma instância hospedada na nuvem no Atlas.

Sistemas locais

O código a seguir mostra a string de conexão de conexão para se conectar a uma instância local do MongoDB:

val uri = "mongodb://localhost:27017/"val mongoClient = MongoClient.create(uri)

Atlas

O seguinte código mostra a string de conexão de conexão para conectar a uma implantação hospedada no Atlas:

val uri = "mongodb+srv://<db_username>:<db_password>@<hostname/port>/?<options>"val mongoClient = MongoClient.create(uri)

Conjunto de réplicas

O seguinte código mostra a string de conexão de conexão para conectar a um conjunto de réplica:

val uri = "mongodb://<replica set member>:<port>/?replicaSet=<replica set name>"val mongoClient = MongoClient.create(uri)

Segurança da camada de transporte (TLS)

As seções a seguir descrevem como se conectar ao MongoDB enquanto habilita o protocolo TLS. Para saber mais sobre como usar o TLS com o driver Kotlin Sync, consulte Habilitar TLS/SSL em uma conexão.

Habilitar TLS

As seguintes guias demonstram como habilitar o TLS em uma conexão:

val settings = MongoClientSettings.builder()    .applyConnectionString(ConnectionString("<connection string>"))    .applyToSslSettings { builder ->        builder.enabled(true)    }    .build()
val mongoClient = MongoClient.create(settings)

val uri = "mongodb+srv://<db_username>:<db_password>@<cluster-url>?tls=true"val mongoClient = MongoClient.create(uri)

Para saber mais sobre como habilitar o TLS, consulte Habilitar TLS no guia de configuração do TLS.

Desativar verificação de nome de host

As guias a seguir demonstram como desabilitar a verificação do nome do host ao se conectar usando o TLS:

val settings = MongoClientSettings.builder()    .applyConnectionString(ConnectionString("<connection string>"))    .applyToSslSettings { builder ->        builder.enabled(true)        builder.invalidHostNameAllowed(true)    }    .build()val mongoClient = MongoClient.create(settings);

val uri = "mongodb://<db_username>:<db_password>@<hostname>:<port>/?"tls=true&tlsAllowInvalidHostnames=true"val mongoClient = MongoClient.create(uri)

Seleção do Servidor

O seguinte código mostra uma string de conexão que especifica uma função de seleção de servidor :

val client = MongoClient.create("mongodb://<db_username>:<db_password>@<hostname>:<port>",                             server_selector=<selector function>)

Stable API

O seguinte código mostra como especificar as configurações da Stable API em uma instância do MongoClientSettings :

val serverApi = ServerApi.builder()    .version(ServerApiVersion.V1)    .build()
val uri = "<connection string>"
val settings = MongoClientSettings.builder()    .applyConnectionString(ConnectionString(uri))    .serverApi(serverApi)    .build()
val client = MongoClient.create(settings)

Para saber mais sobre a API estável, consulte Conectar-se à API estável.

Voltar

Começar

Criar um MongoClient