Browse Source

Polishing

pull/31632/head
Sam Brannen 2 years ago
parent
commit
8c9481d4c4
  1. 7
      spring-core/src/main/java/org/springframework/lang/NonNull.java
  2. 6
      spring-core/src/main/java/org/springframework/lang/NonNullApi.java
  3. 6
      spring-core/src/main/java/org/springframework/lang/NonNullFields.java
  4. 11
      spring-core/src/main/java/org/springframework/lang/Nullable.java

7
spring-core/src/main/java/org/springframework/lang/NonNull.java

@ -1,5 +1,5 @@ @@ -1,5 +1,5 @@
/*
* Copyright 2002-2019 the original author or authors.
* Copyright 2002-2023 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@ -31,8 +31,9 @@ import javax.annotation.meta.TypeQualifierNickname; @@ -31,8 +31,9 @@ import javax.annotation.meta.TypeQualifierNickname;
* <p>Leverages JSR-305 meta-annotations to indicate nullability in Java to common
* tools with JSR-305 support and used by Kotlin to infer nullability of Spring API.
*
* <p>Should be used at parameter, return value, and field level. Method overrides should
* repeat parent {@code @NonNull} annotations unless they behave differently.
* <p>Should be used at the parameter, return value, and field level. Method
* overrides should repeat parent {@code @NonNull} annotations unless they behave
* differently.
*
* <p>Use {@code @NonNullApi} (scope = parameters + return values) and/or {@code @NonNullFields}
* (scope = fields) to set the default behavior to non-nullable in order to avoid annotating

6
spring-core/src/main/java/org/springframework/lang/NonNullApi.java

@ -1,5 +1,5 @@ @@ -1,5 +1,5 @@
/*
* Copyright 2002-2017 the original author or authors.
* Copyright 2002-2023 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@ -32,8 +32,8 @@ import javax.annotation.meta.TypeQualifierDefault; @@ -32,8 +32,8 @@ import javax.annotation.meta.TypeQualifierDefault;
* <p>Leverages JSR-305 meta-annotations to indicate nullability in Java to common
* tools with JSR-305 support and used by Kotlin to infer nullability of Spring API.
*
* <p>Should be used at package level in association with {@link Nullable}
* annotations at parameter and return value level.
* <p>Should be used at the package level in association with {@link Nullable}
* annotations at the parameter and return value level.
*
* @author Sebastien Deleuze
* @author Juergen Hoeller

6
spring-core/src/main/java/org/springframework/lang/NonNullFields.java

@ -1,5 +1,5 @@ @@ -1,5 +1,5 @@
/*
* Copyright 2002-2019 the original author or authors.
* Copyright 2002-2023 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@ -32,8 +32,8 @@ import javax.annotation.meta.TypeQualifierDefault; @@ -32,8 +32,8 @@ import javax.annotation.meta.TypeQualifierDefault;
* <p>Leverages JSR-305 meta-annotations to indicate nullability in Java to common
* tools with JSR-305 support and used by Kotlin to infer nullability of Spring API.
*
* <p>Should be used at package level in association with {@link Nullable}
* annotations at field level.
* <p>Should be used at the package level in association with {@link Nullable}
* annotations at the field level.
*
* @author Sebastien Deleuze
* @since 5.0

11
spring-core/src/main/java/org/springframework/lang/Nullable.java

@ -1,5 +1,5 @@ @@ -1,5 +1,5 @@
/*
* Copyright 2002-2019 the original author or authors.
* Copyright 2002-2023 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
@ -27,14 +27,15 @@ import javax.annotation.meta.TypeQualifierNickname; @@ -27,14 +27,15 @@ import javax.annotation.meta.TypeQualifierNickname;
import javax.annotation.meta.When;
/**
* A common Spring annotation to declare that annotated elements can be {@code null} under
* some circumstance.
* A common Spring annotation to declare that annotated elements can be {@code null}
* under certain circumstances.
*
* <p>Leverages JSR-305 meta-annotations to indicate nullability in Java to common
* tools with JSR-305 support and used by Kotlin to infer nullability of Spring API.
*
* <p>Should be used at parameter, return value, and field level. Methods override should
* repeat parent {@code @Nullable} annotations unless they behave differently.
* <p>Should be used at the parameter, return value, and field level. Method
* overrides should repeat parent {@code @Nullable} annotations unless they behave
* differently.
*
* <p>Can be used in association with {@code @NonNullApi} or {@code @NonNullFields} to
* override the default non-nullable semantic to nullable.

Loading…
Cancel
Save