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如果需要支持,可以去Stack Overflow上的标签。
要求
Spring Boot 至少需要 Kotlin 2.2.x,并通过依赖管理管理合适的 Kotlin 版本。
用Kotlin的话来说,org.jetbrains.kotlin:kotlin-stdlib和org.jetbrains.kotlin:kotlin-reflect必须存在于类路径上。
Kotlin 2.2.x 引入了将注释传播到参数、字段和属性的新默认规则。为了避免相关警告并使用可能成为 Kotlin 默认行为的版本,建议配置-Xannotation-default-target=param-property编译器标志。
由于 Kotlin 类默认是最终的,你可能需要配置 kotlin-spring 插件,以便自动打开带有 Spring 注释的类,以便它们被代理。
Jackson 的 Kotlin 模块是 Kotlin 中序列化/反序列化 JSON 数据的必备。 当它在类路径上被发现时会自动注册。 如果 Jackson 和 Kotlin 在场,但 Jackson Kotlin 模块不在,会记录警告消息。
| 如果在 start.spring.io 上启动Kotlin项目,这些依赖和插件是默认提供的。 |
零安全
Kotlin的一个关键特征是零安全。
它涉及零在编译时取值,而不是将问题推迟到运行时,遇到NullPointerException.
这有助于消除常见的虫源,而无需支付包装费,比如自选.
Kotlin还允许使用具有可空值的函数构造,详见这份关于Kotlin空安全综合指南的描述。
自 Kotlin 2.1 起,Kotlin 严格处理来自org.jspecify.注释包。
Kotlin API
runApplication
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 的物料清单。
使用 Maven,Kotlin 版本可以通过设置kotlin.version(kotlin.version)提供属性和插件管理Kotlin-Maven-插件. 使用 Gradle 时,Spring Boot 插件会自动对齐kotlin.version(kotlin.version)与 Kotlin 插件版本一起。
Spring Boot 还通过导入 Kotlin 协程的物料清单来管理协程的依赖版本。该版本可以通过设置kotlin-coroutines.version(kotlin-coroutines.version)财产。
org.jetbrains.kotlinx:kotlinx-coroutines-reactor如果启动一个至少有一个响应式依赖于 start.spring.io 的 Kotlin 项目,默认会提供依赖。 |
@ConfigurationProperties
@ConfigurationProperties与构造函数结合使用时,绑定支持具有不可变的数据类瓦尔如下例所示的性质:
@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 6 是默认提供的,且推荐使用。JUnit 6 允许测试类实例化一次,并可重复用于该类的所有测试。这使得@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 + Reactive 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:协程示例项目