Kotlin 支持

Kotlin 是一种静态类型语言,面向 JVM(及其他平台),能够编写简洁优雅的代码,同时与现有的 Java 库实现互作性。spring-doc.cadn.net.cn

Spring Boot 通过利用其他 Spring 项目(如 Spring Framework、Spring Data 和 Reactor)的支持,提供 Kotlin 的支持。 更多信息请参见 Spring Framework Kotlin 支持文档spring-doc.cadn.net.cn

开始使用 Spring Boot 和 Kotlin 最简单的方法是跟随这个全面的教程。 你可以用 start.spring.io 创建新的Kotlin项目。 欢迎加入Kotlin Slack的 #spring 频道,或者通过SpringKotlin如果需要支持,可以去Stack Overflow上的标签。spring-doc.cadn.net.cn

要求

Spring Boot 至少需要 Kotlin 2.2.x,并通过依赖管理管理合适的 Kotlin 版本。 用Kotlin的话来说,org.jetbrains.kotlin:kotlin-stdliborg.jetbrains.kotlin:kotlin-reflect必须存在于类路径上。spring-doc.cadn.net.cn

Kotlin 2.2.x 引入了将注释传播到参数、字段和属性的新默认规则。为了避免相关警告并使用可能成为 Kotlin 默认行为的版本,建议配置-Xannotation-default-target=param-property编译器标志。spring-doc.cadn.net.cn

由于 Kotlin 类默认是最终的,你可能需要配置 kotlin-spring 插件,以便自动打开带有 Spring 注释的类,以便它们被代理。spring-doc.cadn.net.cn

Jackson 的 Kotlin 模块是 Kotlin 中序列化/反序列化 JSON 数据的必备。 当它在类路径上被发现时会自动注册。 如果 Jackson 和 Kotlin 在场,但 Jackson Kotlin 模块不在,会记录警告消息。spring-doc.cadn.net.cn

如果在 start.spring.io 上启动Kotlin项目,这些依赖和插件是默认提供的。

零安全

Kotlin的一个关键特征是零安全。 它涉及在编译时取值,而不是将问题推迟到运行时,遇到NullPointerException. 这有助于消除常见的虫源,而无需支付包装费,比如自选. Kotlin还允许使用具有可空值的函数构造,详见这份关于Kotlin空安全综合指南的描述。spring-doc.cadn.net.cn

虽然 Java 不允许在类型系统中表达空安全,但大多数 Spring 项目 通过 JSpecify 注释提供空安全spring-doc.cadn.net.cn

自 Kotlin 2.1 起,Kotlin 严格处理来自org.jspecify.注释包。spring-doc.cadn.net.cn

Kotlin API

runApplication

Spring Boot 提供了一种惯用的方式来运行应用程序,使用runApplication<MyApplication>(*args)如下例所示:spring-doc.cadn.net.cn

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). 它还允许对应用程序进行定制,如下示例所示:spring-doc.cadn.net.cn

runApplication<MyApplication>(*args) {
	setBannerMode(OFF)
}

扩展

Kotlin 扩展提供了扩展现有类并附加功能的能力。Spring Boot Kotlin API 利用这些扩展为现有 API 添加了新的 Kotlin 专用便利功能。spring-doc.cadn.net.cn

测试休息模板类似于 Spring Framework 为 提供的扩展休息运营在 Spring Framework 中,提供了这些。其中之一就是这些扩展使得利用 Kotlin 的实体类型参数成为可能。spring-doc.cadn.net.cn

依赖管理

为了避免在类路径上混合不同版本的 Kotlin 依赖,Spring Boot 导入了 Kotlin 的物料清单。spring-doc.cadn.net.cn

使用 Maven,Kotlin 版本可以通过设置kotlin.version(kotlin.version)提供属性和插件管理Kotlin-Maven-插件. 使用 Gradle 时,Spring Boot 插件会自动对齐kotlin.version(kotlin.version)与 Kotlin 插件版本一起。spring-doc.cadn.net.cn

Spring Boot 还通过导入 Kotlin 协程的物料清单来管理协程的依赖版本。该版本可以通过设置kotlin-coroutines.version(kotlin-coroutines.version)财产。spring-doc.cadn.net.cn

org.jetbrains.kotlinx:kotlinx-coroutines-reactor如果启动一个至少有一个响应式依赖于 start.spring.io 的 Kotlin 项目,默认会提供依赖。

@ConfigurationProperties

@ConfigurationProperties构造函数结合使用时,绑定支持具有不可变的数据类瓦尔如下例所示的性质:spring-doc.cadn.net.cn

@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 互作性有限,对值类的支持有限。特别是,依赖值类的默认值无法配合配置属性绑定。在这种情况下,应使用数据类。spring-doc.cadn.net.cn

使用注释处理器生成您自己的元数据舰长应该配置其中Spring Boot配置处理器Dependency。 请注意,由于 Kapt 模型的限制,某些功能(如检测默认值或弃用项)无法正常工作。

测试

虽然可以使用 JUnit 4 测试 Kotlin 代码,但 JUnit 6 是默认提供的,且推荐使用。JUnit 6 允许测试类实例化一次,并可重复用于该类的所有测试。这使得@BeforeAll@AfterAll非静态方法的注释,这与Kotlin很合适。spring-doc.cadn.net.cn

推荐模拟Kotlin类,使用MockK。如果你需要MockK相当于Mockito专用的@MockitoBean@MockitoSpyBean你可以使用SpringMockK,它提供了类似的功能@MockkBean@SpykBean附注。spring-doc.cadn.net.cn