aboutsummaryrefslogtreecommitdiff
path: root/website
diff options
context:
space:
mode:
Diffstat (limited to 'website')
-rw-r--r--website/templates/features/experimental/Tolerate.html34
-rw-r--r--website/templates/features/experimental/index.html6
-rw-r--r--website/usageExamples/experimental/Tolerate_post.jpage8
-rw-r--r--website/usageExamples/experimental/Tolerate_pre.jpage11
4 files changed, 58 insertions, 1 deletions
diff --git a/website/templates/features/experimental/Tolerate.html b/website/templates/features/experimental/Tolerate.html
new file mode 100644
index 00000000..09610069
--- /dev/null
+++ b/website/templates/features/experimental/Tolerate.html
@@ -0,0 +1,34 @@
+<#import "../_features.html" as f>
+
+ <@f.scaffold title="@Tolerate" logline="Skip, jump, and forget! Skip a method or constructor.">
+ <@f.history>
+ <p>
+ <code>@Tolerate</code> was introduced as feature in lombok v1.14.2<br />
+ </p>
+ </@f.history>
+
+ <@f.experimental>
+ <ul>
+ <li>
+ Not used that much.
+ </li>
+ <li>
+ Difficult to support for edge cases, such as recursive delegation.
+ </li>
+ </ul>
+ </@f.experimental>
+
+ <@f.overview>
+ <p>
+ Any method or constructor can be annotated with <code>@Tolerate</code> and lombok will skip it when
+ considering whether or not to generate a method or constructor. This is useful if the types of the
+ parameters of your method do not clash with what lombok would generate.
+ </p>
+ <p>
+ Put on any method or constructor to make lombok pretend it doesn't exist,i.e., to generate a method
+ which would otherwise be skipped due to possible conflicts.
+ </p>
+ </@f.overview>
+
+ <@f.snippets name="experimental/Tolerate" />
+ </@f.scaffold> \ No newline at end of file
diff --git a/website/templates/features/experimental/index.html b/website/templates/features/experimental/index.html
index 960f4b1a..9ed3f546 100644
--- a/website/templates/features/experimental/index.html
+++ b/website/templates/features/experimental/index.html
@@ -9,7 +9,7 @@
</div>
<div class="row">
The <a href="/api/">Lombok javadoc</a> is available, but we advise these pages.
-
+
<p>
Experimental features are available in your normal lombok installation, but are not as robustly supported as lombok's main features. In particular, experimental features:
<ul>
@@ -67,6 +67,10 @@
<@main.feature title="@SuperBuilder" href="SuperBuilder">
Bob now knows his ancestors: Builders with fields from superclasses, too.
</@main.feature>
+
+ <@main.feature title="@Tolerate" href="Tolerate">
+ Skip, jump, and forget! Skip a method or constructor.
+ </@main.feature>
</div>
<@f.confKeys>
diff --git a/website/usageExamples/experimental/Tolerate_post.jpage b/website/usageExamples/experimental/Tolerate_post.jpage
new file mode 100644
index 00000000..57f29e1b
--- /dev/null
+++ b/website/usageExamples/experimental/Tolerate_post.jpage
@@ -0,0 +1,8 @@
+public class TolerateExample {
+ @Setter
+ private Date date;
+
+ public void setDateFromString(String date) {
+ this.date = Date.valueOf(date);
+ }
+}
diff --git a/website/usageExamples/experimental/Tolerate_pre.jpage b/website/usageExamples/experimental/Tolerate_pre.jpage
new file mode 100644
index 00000000..5723df5c
--- /dev/null
+++ b/website/usageExamples/experimental/Tolerate_pre.jpage
@@ -0,0 +1,11 @@
+import lombok.experimental.Tolerate;
+
+public class TolerateExample {
+ @Setter
+ private Date date;
+
+ @Tolerate
+ public void setDate(String date) {
+ this.date = Date.valueOf(date);
+ }
+}