Null 安全

Kotlin 的关键特性之一是 null 安全,它在编译时干净地处理 null 值。这通过可空性声明和“值或无值”语义的表达,使应用程序更安全,而无需付出包装器的代价,例如 Optional。(Kotlin 允许对可空值使用函数式构造。请参阅这篇Kotlin null 安全的综合指南。)

虽然 Java 不允许你在其类型系统中表达 null 安全,但 Spring Data API 使用在 org.springframework.lang 包中声明的 JSR-305 工具友好的注解进行注解。默认情况下,Kotlin 中使用的 Java API 的类型被识别为平台类型,对于平台类型,null 检查会放松。Kotlin 对 JSR-305 注解的支持和 Spring 可空性注解为 Kotlin 开发人员提供了整个 Spring Data API 的 null 安全性,其优势是在编译时处理 null 相关问题。

请参阅 Repository 方法的 Null 处理 以了解 null 安全如何应用于 Spring Data Repositories。

你可以通过添加 -Xjsr305 编译器标志以及以下选项来配置 JSR-305 检查:-Xjsr305={strict|warn|ignore}

对于 Kotlin 1.1+ 版本,默认行为与 -Xjsr305=warn 相同。需要 strict 值才能考虑 Spring Data API 的 null 安全性。从 Spring API 推断出的 Kotlin 类型应该在使用时知道 Spring API 的可空性声明可能会演变,即使在次要版本之间也是如此,并且将来可能会添加更多检查。

尚不支持泛型类型参数、varargs 和数组元素的可空性,但应在即将发布的版本中提供。