aboutsummaryrefslogtreecommitdiff
path: root/website
diff options
context:
space:
mode:
authorReinier Zwitserloot <r.zwitserloot@projectlombok.org>2021-03-23 05:08:19 +0100
committerReinier Zwitserloot <r.zwitserloot@projectlombok.org>2021-03-23 05:19:24 +0100
commitcc98adac012d0d18c70628eb5e6f1646ce574e8a (patch)
tree92e77d3437d7d0ba2b55576cc87fedbb0e04dec1 /website
parent2eabd8485df6fb01e05cf7bcf797d922b9d4e012 (diff)
downloadlombok-cc98adac012d0d18c70628eb5e6f1646ce574e8a.tar.gz
lombok-cc98adac012d0d18c70628eb5e6f1646ce574e8a.tar.bz2
lombok-cc98adac012d0d18c70628eb5e6f1646ce574e8a.zip
[records] [javac] Putting `@NonNull` on a 'field' of a record now affects the compact constructors, generating one if need be.
Diffstat (limited to 'website')
-rw-r--r--website/templates/features/NonNull.html6
1 files changed, 3 insertions, 3 deletions
diff --git a/website/templates/features/NonNull.html b/website/templates/features/NonNull.html
index 67cc262c..57aa62fe 100644
--- a/website/templates/features/NonNull.html
+++ b/website/templates/features/NonNull.html
@@ -7,11 +7,11 @@
<@f.overview>
<p>
- You can use <code>@NonNull</code> on the parameter of a method or constructor to have lombok generate a null-check statement for you.
+ You can use <code>@NonNull</code> on a record component, or a parameter of a method or constructor. This will cause to lombok generate a null-check statement for you.
</p><p>
- Lombok has always treated various annotations generally named <code>@NonNull</code> on a field as a signal to generate a null-check if lombok generates an entire method or constructor for you, via for example <a href="/features/Data"><code>@Data</code></a>. Now, however, using lombok's own <code>@lombok.NonNull</code> on a parameter results in the insertion of just the null-check statement inside your own method or constructor.
+ Lombok has always treated various annotations generally named <code>@NonNull</code> on a field as a signal to generate a null-check if lombok generates an entire method or constructor for you, via for example <a href="/features/Data"><code>@Data</code></a>. However, using lombok's own <code>@lombok.NonNull</code> on a parameter or record component results in the insertion of the null-check at the top of that method.
</p><p>
- The null-check looks like <code>if (param == null) throw new NullPointerException("param is marked @NonNull but is null");</code> and will be inserted at the very top of your method. For constructors, the null-check will be inserted immediately following any explicit <code>this()</code> or <code>super()</code> calls.
+ The null-check looks like <code>if (param == null) throw new NullPointerException("param is marked @NonNull but is null");</code> and will be inserted at the very top of your method. For constructors, the null-check will be inserted immediately following any explicit <code>this()</code> or <code>super()</code> calls. For record components, the null-check will be inserted in the 'compact constructor' (the one that has no argument list at all), which will be generated if you have no constructor. If you have written out the record constructor in long form (with parameters matching your components exactly), then nothing happens - you'd have to annotate the parameters of this long-form constructor instead.
</p><p>
If a null-check is already present at the top, no additional null-check will be generated.
</p>