Null 安全

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

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

请参阅 仓库方法的 Null 处理,了解 Null 安全如何应用于 Spring Data 仓库。

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

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

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