|
对于最新的稳定版本，请使用 Spring Boot 3.5.5！ |
Kotlin 支持
Spring Boot 通过利用其他 Spring 项目（例如 Spring Framework、Spring Data 和 Reactor）中的支持来提供 Kotlin 支持。 有关更多信息，请参阅 Spring Framework Kotlin 支持文档。
开始使用 Spring Boot 和 Kotlin 的最简单方法是遵循这个综合教程。
您可以使用 start.spring.io 创建新的 Kotlin 项目。
请随时加入 Kotlin Slack 的 #spring 频道或使用spring和kotlin标签，如果您需要支持。
要求
Spring Boot 至少需要 Kotlin 1.7.x，并通过依赖管理管理合适的 Kotlin 版本。
要使用 Kotlin，org.jetbrains.kotlin:kotlin-stdlib和org.jetbrains.kotlin:kotlin-reflect必须存在于类路径上。
这kotlin-stdlib变种kotlin-stdlib-jdk7和kotlin-stdlib-jdk8也可以使用。
由于 Kotlin 类默认是最终的，因此您可能希望配置 kotlin-spring 插件，以便自动打开带 Spring 注释的类，以便可以代理它们。
在 Kotlin 中序列化/反序列化 JSON 数据需要 Jackson 的 Kotlin 模块。 在类路径上找到它时会自动注册。 如果 Jackson 和 Kotlin 存在，但 Jackson Kotlin 模块不存在，则会记录一条警告消息。
| 如果有人在 start.spring.io 上引导 Kotlin 项目，则默认会提供这些依赖项和插件。 |
零安全
Kotlin 的主要功能之一是空安全。
它涉及null值，而不是将问题推迟到运行时并遇到NullPointerException.
这有助于消除常见的错误来源，而无需支付包装器的成本，例如Optional.
Kotlin 还允许使用具有可空值的函数式构造，如本 Kotlin 中空安全综合指南中所述。
尽管 Java 不允许在其类型系统中表达空安全性，但 Spring Framework、Spring Data 和 Reactor 现在通过工具友好的注释提供其 API 的空安全性。 默认情况下，Kotlin 中使用的 Java API 中的类型被识别为放宽空检查的平台类型。Kotlin 对 JSR 305 注解的支持与可空性注解相结合，为 Kotlin 中的相关 Spring API 提供了空安全性。
可以通过添加-Xjsr305compiler 标志，并带有以下选项：-Xjsr305={strict|warn|ignore}.
默认行为与-Xjsr305=warn.
这strictvalue 需要在从 Spring API 推断的 Kotlin 类型中考虑 null 安全性，但应该知道 Spring API 可空性声明即使在次要版本之间也可能发生变化，并且将来可能会添加更多检查）。
Kotlin API
运行应用程序
Spring Boot 提供了一种惯用的方式来运行应用程序runApplication<MyApplication>(*args)如以下示例所示：
import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
@SpringBootApplication
class MyApplication
fun main(args: Array<String>) {
runApplication<MyApplication>(*args)
}这是SpringApplication.run(MyApplication::class.java, *args).
它还允许自定义应用程序，如以下示例所示：
runApplication<MyApplication>(*args) {
setBannerMode(OFF)
}扩展
Kotlin 扩展提供了通过附加功能扩展现有类的能力。Spring Boot Kotlin API 利用这些扩展为现有 API 添加新的 Kotlin 特定便利。
TestRestTemplate扩展，类似于 Spring Framework 提供的扩展RestOperations在 Spring Framework 中，提供了。除其他外，扩展可以利用 Kotlin 具体化类型参数。
依赖关系管理
为了避免在类路径上混合不同版本的 Kotlin 依赖项，Spring Boot 导入了 Kotlin BOM。
使用 Maven，可以通过将kotlin.version提供属性和插件管理kotlin-maven-plugin.
使用 Gradle，Spring Boot 插件会自动对齐kotlin.version替换为 Kotlin 插件的版本。
Spring Boot 还通过导入 Kotlin 协程 BOM 来管理协程依赖项的版本。可以通过设置kotlin-coroutines.version财产。
org.jetbrains.kotlinx:kotlinx-coroutines-reactor如果一个引导一个 Kotlin 项目，并且至少有一个对 start.spring.io 的响应式依赖项，则默认情况下会提供依赖项。 |
@ConfigurationProperties
@ConfigurationProperties当与构造函数结合使用时，绑定支持具有不可变的数据类val属性，如以下示例所示：
@ConfigurationProperties("example.kotlin")
data class KotlinExampleProperties(
val name: String,
val description: String,
val myService: MyService) {
data class MyService(
val apiToken: String,
val uri: URI
)
}由于它们与 Java 互作性的限制，对值类的支持是有限的。 特别是，依赖值类的默认值将不适用于配置属性绑定。 在这种情况下，应改用数据类。
测试
虽然可以使用 JUnit 4 来测试 Kotlin 代码，但默认情况下提供 JUnit 5，建议使用。
JUnit 5 允许对测试类进行一次实例化，并重用于该类的所有测试。
这使得使用@BeforeAll和@AfterAll非静态方法的注释，非常适合 Kotlin。
要模拟 Kotlin 类，建议使用 MockK。
如果您需要MockK相当于 Mockito 特定的@MockitoBean和@MockitoSpyBean注释，您可以使用 SpringMockK 提供类似的@MockkBean和@SpykBean附注。
资源
例子
-
spring-boot-kotlin-demo：常规 Spring Boot + Spring Data JPA 项目
-
mixit：Spring Boot 2 + WebFlux + 响应式 Spring Data MongoDB
-
spring-kotlin-fullstack：WebFlux Kotlin 全栈示例，前端使用 Kotlin2js 而不是 JavaScript 或 TypeScript
-
spring-petclinic-kotlin：Spring PetClinic 示例应用程序的 Kotlin 版本
-
spring-kotlin-deepdive：从 Boot 1.0 + Java 到 Boot 2.0 + Kotlin 的分步迁移
-
spring-boot-coroutines-demo：协程示例项目