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 和陣列元素的可空性尚不支援,但應該在即將釋出的版本中提供。