空安全

Kotlin 的关键特性之一是 空安全,它在编译时干净地处理 null 值。这使得应用程序更安全,因为它可以通过可空性声明和“有值或无值”语义的表达来避免使用包装器(例如 Optional)带来的成本。(Kotlin 允许对可空值使用函数式结构。请参阅此 Kotlin 空安全综合指南。)

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

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

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

对于 Kotlin 1.1+ 版本,默认行为与 -Xjsr305=warn 相同。需要使用 strict 值才能考虑 Spring Data API 的空安全。从 Spring API 推断出的 Kotlin 类型应该在了解 Spring API 可空性声明可能会在版本之间发生变化(即使是在次要版本之间),并且将来可能会添加更多检查的情况下使用。

泛型类型参数、可变参数和数组元素的可空性尚不受支持,但应该会在将来的版本中提供支持。