开始使用Kotlin Sync驱动程序

创建Kotlin项目

首先，确保您的系统已安装 Kotlin 并在 JDK 1.8或更高版本上运行。

我们建议您使用 IntelliJ IDEA 或 Eclipse IDE 等集成开发环境配置 Gradle 或 Maven，以构建和运行项目。

有关Kotlin入门和创建第一个项目的更多信息，请参阅 Kotlin/ Java虚拟机（JVM）入门 在Kotlin语言文档中。

添加驱动程序物料清单

在 IDE 中，创建新的Maven或Gradle项目。将MongoDB Java虚拟机（JVM）工件的物料清单 (BOM) 添加到项目中以组织依赖项版本。 BOM 确保您保持一致且兼容的依赖项版本，例如Kotlin Sync驾驶员和核心驾驶员程序库之间的依赖项版本，从而简化依赖项管理。使用 BOM 避免版本冲突并简化升级。

从以下 Maven 和 Gradle 标签页中进行选择，查看为每个依赖项管理器添加 BOM 的说明：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>5.5.0</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

dependencies {
    implementation(platform("org.mongodb:mongodb-driver-bom:5.5.0"))
}

要查看 BOM 管理的依赖项列表，请参阅 Maven 存储库网站上的mongodb-driver-bom 依赖项列表。

添加 MongoDB 作为依赖项

如果使用 Gradle管理软件包，请将以下条目添加到build.gradle.kts依赖项列表中：

dependencies {
    implementation("org.mongodb:mongodb-driver-kotlin-sync")
}

如果使用 Maven管理软件包，请将以下条目添加到pom.xml依赖项列表中：

<dependencies>
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-kotlin-sync</artifactId>
    </dependency>
</dependencies>

由于您安装了 BOM，因此可以省略Kotlin Sync驾驶员依赖项条目中的版本。您在 BOM 中指定的版本决定了要安装的依赖项版本。

配置依赖项后，运行依赖项管理器并在 IDE 中刷新项目，确保它们可用于您的项目。

添加序列化库依赖项

要使驱动程序能够在 Kotlin 对象和 BSON（MongoDB 中文档的数据格式）之间进行转换，您还必须将以下一个或两个序列化包添加到您的应用程序中：

• bson-kotlinx （推荐）

• bson-kotlin

如果使用 Gradle 管理您的包，请将以下条目之一添加到您的 build.gradle.kts 依赖项列表中：

implementation("org.mongodb:bson-kotlinx")
// OR
implementation("org.mongodb:bson-kotlin")

如果使用 Maven 管理您的包，请将以下条目之一添加到您的 pom.xml 依赖项列表中：

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlinx</artifactId>
</dependency>
<!--OR-->
<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>bson-kotlin</artifactId>
</dependency>

配置依赖项后，运行依赖项管理器并在 IDE 中刷新项目，确保它们可用于您的项目。

要学习；了解有关这些包的详情，请参阅 Kotlin序列化。

在 Atlas 上创建免费 MongoDB 部署

请按照 Atlas 入门指南中的步骤，设置新的 Atlas 账户并将示例数据加载到新的免费套餐 MongoDB 部署中。

保存凭证

创建数据库用户后，请将用户的用户名和密码保存到安全位置，以便在后续步骤中使用。

查找 MongoDB Atlas 连接字符串

要检索您在上一步中创建的部署的连接字符串，日志登录您的Atlas帐户，导航到Database 部分，然后单击新部署的Connect 按钮。

进入Connect your application部分，然后从Driver选择菜单中选择Kotlin 。

选择Password (SCRAM)身份验证机制。

取消选择 Include full driver code example 选项以仅查看连接string 。

复制连接字符串

单击连接字符串右侧的按钮以将其复制到剪贴板，如以下屏幕截图所示：

更新占位符

将此连接字符串粘贴到您首选文本编辑器中的文件中，并将<username>和<password>占位符替换为数据库用户的用户名和密码。

将此文件保存到安全位置，以便在下一步中使用。

创建应用程序文件

在项目中创建一个名为DemoDataClassExample.kt的文件。

将以下示例代码复制到该文件中，并将 <connection URI string> 占位符的值替换为您在上一步中保存的MongoDB Atlas连接string 。

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.MongoClient
// Create data class to represent a MongoDB document
data class Movie(val title: String, val year: Int, val directors: List<String>)
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection URI string>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Movie>("movies")
    // Find a document with the specified title
    val doc = collection.find(eq(Movie::title.name, "Before Sunrise")).firstOrNull()
    if (doc != null) {
        // Print the matching document
        println(doc)
    } else {
        println("No matching documents found.")
    }
}

运行应用程序

运行应用程序时，它会打印与查询匹配的电影文档的详细信息，如以下输出所示：

Movie(title=Before Sunrise, year=1995, directors=[Richard Linklater])

如果未看到任何输出或收到错误，请检查应用程序中是否包含正确的连接字符串。另外，确认您已成功将示例数据集加载到 MongoDB Atlas 集群中。

完成此步骤后，您就拥有一个正常运行的应用程序，它使用Kotlin Sync驾驶员连接到MongoDB 集群、对示例数据运行查询并打印结果。

使用文档类对数据进行建模（替代方案）

前面的步骤演示了如何使用Kotlin数据类对示例集合运行查询以检索数据。 本节介绍如何使用 文档 类以在MongoDB中存储和检索数据。

在名为DemoDocumentExample.kt的文件中，粘贴以下示例代码，对MongoDB Atlas中的示例数据集运行查询。 将 <connection URI string> 占位符的值替换为MongoDB Atlas连接string ：

import com.mongodb.client.model.Filters.eq
import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection URI string>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    val collection = database.getCollection<Document>("movies")
    // Find a document with the specified title
    val doc = collection.find(eq("title", "Before Sunrise")).firstOrNull()
    if (doc != null) {
        // Print the matching document
        println(doc)
    } else {
        println("No matching documents found.")
    }
}

运行应用程序时，它会打印与查询匹配的电影文档的详细信息，如以下输出所示：

Document{{_id=..., plot=A young man and woman ..., genres=[Drama, Romance], ...}}

如果未看到任何输出或收到错误，请检查应用程序中是否包含正确的连接字符串。另外，确认您已成功将示例数据集加载到 MongoDB Atlas 集群中。