root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 8 Packages Projects Releases Wiki Activity

Merge branch '6.0.x'

This commit is contained in:
Sébastien Deleuze 2023-06-12 16:01:35 +02:00
parent 6501176081 80af7bedef
commit 446b90172b
1 changed files with 6 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
framework-docs/modules/ROOT/pages/core/null-safety.adoc
View File

@ -2,7 +2,7 @@
= Null-safety = Null-safety
Although Java does not let you express null-safety with its type system, the Spring Framework Although Java does not let you express null-safety with its type system, the Spring Framework
now provides the following annotations in the `org.springframework.lang` package to let you provides the following annotations in the `org.springframework.lang` package to let you
declare nullability of APIs and fields: declare nullability of APIs and fields:
* {api-spring-framework}/lang/Nullable.html[`@Nullable`]: Annotation to indicate that a * {api-spring-framework}/lang/Nullable.html[`@Nullable`]: Annotation to indicate that a
@ -17,11 +17,10 @@ level that declares non-null as the default semantics for fields.
The Spring Framework itself leverages these annotations, but they can also be used in any The Spring Framework itself leverages these annotations, but they can also be used in any
Spring-based Java project to declare null-safe APIs and optionally null-safe fields. Spring-based Java project to declare null-safe APIs and optionally null-safe fields.
Generic type arguments, varargs and array elements nullability are not supported yet but Generic type arguments, varargs and array elements nullability are not supported yet.
should be in an upcoming release, see https://jira.spring.io/browse/SPR-15942[SPR-15942] Nullability declarations are expected to be fine-tuned between Spring Framework releases,
for up-to-date information. Nullability declarations are expected to be fine-tuned between including minor ones. Nullability of types used inside method bodies is outside the
Spring Framework releases, including minor ones. Nullability of types used inside method scope of this feature.
bodies is outside of the scope of this feature.
NOTE: Other common libraries such as Reactor and Spring Data provide null-safe APIs that NOTE: Other common libraries such as Reactor and Spring Data provide null-safe APIs that
use a similar nullability arrangement, delivering a consistent overall experience for use a similar nullability arrangement, delivering a consistent overall experience for
@ -38,7 +37,7 @@ these annotations can be used by an IDE (such as IDEA or Eclipse) to provide use
warnings related to null-safety in order to avoid `NullPointerException` at runtime. warnings related to null-safety in order to avoid `NullPointerException` at runtime.
They are also used to make Spring API null-safe in Kotlin projects, since Kotlin natively They are also used to make Spring API null-safe in Kotlin projects, since Kotlin natively
supports https://kotlinlang.org/docs/reference/null-safety.html[null-safety]. More details supports https://kotlinlang.org/docs/null-safety.html[null-safety]. More details
are available in the xref:languages/kotlin/null-safety.adoc[Kotlin support documentation]. are available in the xref:languages/kotlin/null-safety.adoc[Kotlin support documentation].