下载并安装
本指南演示了如何使用 Gradle 或 Maven 创建项目并添加Kotlin Sync驾驶员依赖项。
创建Kotlin项目
首先,确保您的系统已安装 Kotlin 并在 JDK 1.8或更高版本上运行。
我们建议您使用 IntelliJ IDEA 或 Eclipse IDE 等集成开发环境配置 Gradle 或 Maven,以构建和运行项目。
提示
如果您未使用 IDE,请参阅创建新的 Gradle 版本指南或构建 Maven 指南,详细了解如何设置项目。
有关Kotlin入门和创建第一个项目的更多信息,请参阅 Kotlin/ Java虚拟机(JVM)入门 在Kotlin语言文档中。
添加驱动程序物料清单
在 IDE 中,创建新的Maven或Gradle项目。将MongoDB Java虚拟机(JVM)工件的物料清单 (BOM) 添加到项目中以组织依赖项版本。 BOM 确保您保持一致且兼容的依赖项版本,例如Kotlin Sync驾驶员和核心驾驶员程序库之间的依赖项版本,从而简化依赖项管理。使用 BOM 避免版本冲突并简化升级。
从以下 Maven 和 Gradle 标签页中进行选择,查看为每个依赖项管理器添加 BOM 的说明:
将以下代码添加到 pom.xml
文件的 dependencyManagement
列表中:
<dependencyManagement> <dependencies> <dependency> <groupId>org.mongodb</groupId> <artifactId>mongodb-driver-bom</artifactId> <version>5.4.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>
将以下代码添加到 build.gradle.kts
文件的依赖项列表中:
dependencies { implementation(platform("org.mongodb:mongodb-driver-bom:5.4.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序列化。
完成这些步骤后,您就拥有了一个新的项目目录并安装了驱动程序依赖项。
注意
如果您在该步骤中遇到问题,请在 MongoDB Community 论坛中寻求帮助,或使用本页右侧或右下角的 Rate this page 标签页提交反馈。