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

该图使用 标准连接字符串格式,mongodb 表示协议。如果您希望部署更加灵活,并且能力轮流更改服务器而无需重新配置客户端,则还可以使用 DNS 种子列表连接格式mongodb+srv 。
注意
如果您的部署是在MongoDB Atlas上,请参阅Atlas驱动程序连接指南,并从语言下拉列表中选择 Kotlin 以检索连接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 文档: