Overview
要连接到 MongoDB 部署,您需要满足两个条件:
A 连接 URI,也称为连接字符串,它告诉Kotlin驱动程序要连接到哪个MongoDB 部署。
一个MongoClient对象,用于创建与 MongoDB 部署的连接并允许您对其执行操作。
您还可以使用这些组件来自定义Kotlin驱动程序在连接到MongoDB时的行为方式。
本指南向您介绍如何创建连接string并使用 MongoClient 对象连接到MongoDB 。
连接 URI
连接 URI提供驱动程序用于连接到 MongoDB 部署的指令集。该指令集指示驱动程序应如何连接到 MongoDB,以及在连接时应如何运行。下图解释了示例连接 URI 的各个部分:

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.
注意
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.
如果您使用基于密码的身份验证机制,则连接 URI 的下一部分将包含您的凭证。 将user的值替换为数据库用户名,并将pass的值替换为数据库用户的密码。 如果您的身份验证机制不需要凭证,请忽略连接 URI 的这一部分。
连接 URI 的下一部分指定主机名或 IP 地址,后跟 MongoDB 实例的端口。在示例中,sample.host 代表主机名,27017 是端口号。替换这些值以参考您的 MongoDB 实例。
连接 URI 的最后一部分包含作为参数的连接选项。在示例中,我们设立了两个连接选项:maxPoolSize=20 和 w=majority。有关连接选项的更多信息,请参阅 连接选项指南。
MongoClient
您可以使用 MongoClient 类连接到MongoDB并与之通信。
使用 MongoClient.create() 方法构造 MongoClient。
以下代码展示了如何创建连接到本地MongoDB 部署的MongoClient:
import com.mongodb.kotlin.client.coroutine.MongoClient val uri = "mongodb://localhost:27017/" val client = MongoClient.create(uri)
重要
客户端重用
由于每个 MongoClient 代表一个具有线程安全性的数据库连接池,因此大多数应用程序只需要一个 MongoClient实例,甚至跨多个线程也是如此。所有资源使用限制(例如最大连接数)应用于单个 MongoClient 实例。
要学习;了解可用于控制 MongoClient 行为的不同设置,请参阅 MongoClient 设置指南。
提示
当不再需要实例时,始终调用 MongoClient.close() 清理资源。
API 文档
有关本节中提到的方法和类的详情,请参阅以下 API 文档: