null 安全

Spring REST Docs は、API の null 可能性を宣言するために JSpecify (英語) アノテーションが付与されています。JSpecify について詳しくは、ユーザーガイド (英語) を参照してください。

API の null 可能性を宣言する主な目的は、実行時に NullPointerException がスローされるのを防ぐことです。これは、Java と Kotlin の両方で利用可能なビルド時チェックによって実現されます。Java でこれらのチェックを実行するには、NullAway [GitHub] (英語) などのツール、または IntelliJ IDEA などの JSpecify アノテーションをサポートする IDE が必要です。これらのチェックは Kotlin で自動的に利用可能になり、JSpecify アノテーションを Kotlin の null 安全性に変換します。

Spring での null 安全性の詳細については、Spring Framework リファレンスドキュメントを参照してください。