From 0375f1a9e8f606588d4e136fc718a6876ff0ae4f Mon Sep 17 00:00:00 2001 From: Thomas Klambauer Date: Tue, 17 Jul 2018 13:35:34 +0200 Subject: lombok config broken: version must be string otherwise gradle compile will fail. --- website/templates/setup/gradle.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'website') diff --git a/website/templates/setup/gradle.html b/website/templates/setup/gradle.html index 7cb4af0d..41d90dcc 100644 --- a/website/templates/setup/gradle.html +++ b/website/templates/setup/gradle.html @@ -15,7 +15,7 @@

Note, to tell the gradle-lombok plugin to use the latest version of lombok, you need to explicitly tell it about the latest version number and the SHA-256. For our current latest version, put this in your build.gradle file:

 lombok {
-	version = ${version} 
+	version = '${version}'
 	sha256 = ""
 }

-- cgit From e964f5eec6015564d561ad45dc29964b4fc4481e Mon Sep 17 00:00:00 2001 From: Reinier Zwitserloot Date: Sun, 29 Jul 2018 16:47:39 +0200 Subject: [website] ’Install’ -> ‘How to use’ MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- website/templates/_scaffold.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'website') diff --git a/website/templates/_scaffold.html b/website/templates/_scaffold.html index 7acfb6b6..65b2fb7f 100644 --- a/website/templates/_scaffold.html +++ b/website/templates/_scaffold.html @@ -111,7 +111,7 @@ ga('send', 'pageview');
  • - Install + How to use Install
      <#list setupTargets as cat, tgtList> -- cgit From 0038b48eeacac0389980902e65b4976dd5605c69 Mon Sep 17 00:00:00 2001 From: Reinier Zwitserloot Date: Sun, 29 Jul 2018 17:17:22 +0200 Subject: docs for the redesigned FieldNameConstants. --- .../features/experimental/FieldNameConstants.html | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) (limited to 'website') diff --git a/website/templates/features/experimental/FieldNameConstants.html b/website/templates/features/experimental/FieldNameConstants.html index c5e57195..a6fac99d 100644 --- a/website/templates/features/experimental/FieldNameConstants.html +++ b/website/templates/features/experimental/FieldNameConstants.html @@ -4,6 +4,8 @@ <@f.history>

      @FieldNameConstants was introduced as experimental feature in lombok v1.16.22. +

      + @FieldNameConstants was redesigned in lombok v1.18.4.

      @@ -18,11 +20,11 @@ <@f.overview>

      - The @FieldNameConstants annotation generates string constants (fields marked public static final, of type java.lang.String) containing the field's name, as a string. This is useful for various marshalling and serialization frameworks. The constant field by default is named FIELD_NAME_OF_FIELD, where NAME_OF_FIELD is the same name as the field it represents, except with all uppercase letters, with underscores in front of the uppercase letters in the original field. The prefix (and suffix) is configurable on the @FieldNameConstants annotation. + The @FieldNameConstants annotation generates an inner type which contains 1 constant for each field in your class; either string constants (fields marked public static final, of type java.lang.String) or if you prefer, an enum type with 1 value for each field. @FieldNameConstants is useful for various marshalling and serialization frameworks. The constant field (whether enum value or string constant) always has the exact same name as the field, capitalization and all.

      - The public access modifier can be changed via the parameter level = AccessLevel.PACKAGE for example. You can force a field to be skipped by supplying level = AccessLevel.NONE. + The generated inner type is by default called Fields and is public. You can modify this via @FieldNameConstants(innerTypeName = "FieldNames", access = AccessLevel.PACKAGE) for example. The default inner type name can also be modified via configuration key lombok.fieldNameConstants.innerTypeName. The generated fields are always public.

      - Can be applied to classes (in which case every field gets a constant), or to an individual field. + Must be applied to classes (or enums, though you'd rarely want to do that). By default includes all non-transient, non-static fields. You can use @FieldNameConstants.Include in fields + @FieldNameConstants(onlyExplicitlyIncluded = true), or @FieldNameConstants.Exclude for more fine-grained control.

      @@ -34,21 +36,19 @@
      Lombok will flag any usage of @FieldDefaults as a warning or error if configured.
      - lombok.fieldNameConstants.prefix = a string (default: 'PREFIX_') -
      - Lombok will generate the name for each fieldconstant by constant-casing the field name and then prefixing this string to the result. -
      - lombok.fieldNameConstants.suffix = a string (default: '' - the blank string) + lombok.fieldNameConstants.innerTypeName = a string (default: 'Fields')
      - Lombok will generate the name for each fieldconstant by constant-casing the field name and then suffixing this string to the result. + The name of the inner type generated by lombok can be controlled with this configuration key.
      <@f.smallPrint>

      - Like other lombok handlers that touch fields, any field whose name starts with a dollar ($) symbol is skipped entirely. Such a field will not be modified at all. Static fields are also skipped. + From lombok v1.16.22 to lombok v1.18.2, this feature generated constants inside the type directly; the name of these fields would for example turn field exampleFieldName into public static final String FIELD_EXAMPLE_FIELD_NAME = "exampleFieldName";. The prefix and suffix (here, FIELD_, and the empty string) were configurable. Starting with lombok v1.18.4 this feature has been redesigned into generating an inner type as described above. +

      + Any parameters of lombok annotations that take strings need to be supplied actual string literals; you cannot have references to constants like those generated by @FieldNameConstants. If you'd like to use @FieldNameConstants to for example fill in the of and/or exclude parameters of @ToString and similar lombok annotations, use the @ToString.Include / @ToString.Exclude etc system instead; these are described at the feature pages for those features.

      - The annotation can itself be used to set prefix/suffix. If you do so, it overrides the lombok.fieldNameConstants.prefix/suffix config key. Example: @FieldNameConstants(prefix = ""): This would generate for field helloWorld a constant named HELLO_WORLD instead of the default FIELD_HELLO_WORLD. + Like other lombok handlers that touch fields, any field whose name starts with a dollar ($) symbol is skipped entirely. Such a field will not be modified at all. Static fields are also skipped.

      -- cgit From 6b84e38152be3bfe5bc06bb6061ddc95d78f65e8 Mon Sep 17 00:00:00 2001 From: Reinier Zwitserloot Date: Thu, 2 Aug 2018 15:20:06 +0200 Subject: make access on the website to for example Builder/ also work --- website/extra/htaccess | 54 +++++++++++++++++++++++++------------------------- 1 file changed, 27 insertions(+), 27 deletions(-) (limited to 'website') diff --git a/website/extra/htaccess b/website/extra/htaccess index 2d5b6b2a..f2abad2d 100644 --- a/website/extra/htaccess +++ b/website/extra/htaccess @@ -4,62 +4,62 @@ RewriteRule ^$ /main.html [L,END] RewriteRule ^(index|home)(\.html)?$ / [NC,R=301] RewriteRule ^setup/overview$ /setup/main.html [L,END] -RewriteRule ^setup/main(\.html)?$ /setup/overview [NC,R=301] -RewriteRule ^setup/index(\.html)?$ /setup/overview [NC,R=301] -RewriteRule ^setup(/(overview)?)?$ /setup/overview [NC,R=301] +RewriteRule ^setup/main(\.html)?/?$ /setup/overview [NC,R=301] +RewriteRule ^setup/index(\.html)?/?$ /setup/overview [NC,R=301] +RewriteRule ^setup(/(overview/?)?)?$ /setup/overview [NC,R=301] RewriteRule ^changelog$ /changelog.html [L,END] -RewriteRule ^changelog(\.html)?$ /changelog [NC,R=301] +RewriteRule ^changelog(\.html)?/?$ /changelog [NC,R=301] RewriteRule ^credits$ /credits.html [L,END] -RewriteRule ^credits(\.html)?$ /credits [NC,R=301] +RewriteRule ^credits(\.html)?/?$ /credits [NC,R=301] RewriteRule ^download$ /download.html [L,END] -RewriteRule ^download(\.html)?$ /download [NC,R=301] +RewriteRule ^download(\.html)?/?$ /download [NC,R=301] RewriteRule ^download-edge$ /download-edge.html [L,END] -RewriteRule ^download-edge(\.html)?$ /download-edge [NC,R=301] +RewriteRule ^download-edge(\.html)?/?$ /download-edge [NC,R=301] RewriteRule ^all-versions$ /all-versions.html [L,END] -RewriteRule ^all-versions(\.html)?$ /all-versions [NC,R=301] +RewriteRule ^all-versions(\.html)?/?$ /all-versions [NC,R=301] RewriteRule ^all-versions$ /all-versions.html [L,END] -RewriteRule ^all-versions(\.html)?$ /all-versions [NC,R=301] +RewriteRule ^all-versions(\.html)?/?$ /all-versions [NC,R=301] RewriteRule ^disable-checked-exceptions$ /disable-checked-exceptions.html [L,END] -RewriteRule ^disable-checked-exceptions(\.html)?$ /disable-checked-exceptions [NC,R=301] +RewriteRule ^disable-checked-exceptions(\.html)?/?$ /disable-checked-exceptions [NC,R=301] RewriteRule ^supporters$ /supporters.html [L,END] -RewriteRule ^supporters(.html)?$ /supporters [NC,R=301] +RewriteRule ^supporters(.html)?/?$ /supporters [NC,R=301] RewriteRule ^order-license-info$ /order-license-info.html [L,END] -RewriteRule ^order-?license-?info(.html)?$ /order-license-info [NC,R=301] +RewriteRule ^order-?license-?info(.html)?/?$ /order-license-info [NC,R=301] RewriteRule ^order-license$ /order-license.html [L,END] -RewriteRule ^order-?license(.html)?$ /order-license [NC,R=301] +RewriteRule ^order-?license(.html)?/?$ /order-license [NC,R=301] RewriteRule ^contributing/index$ /contributing/index.html [L,END] -RewriteRule ^contributing(\.html)?$ /contributing/index [NC,R=301] -RewriteRule ^contributing/index(\.html)?$ /contributing/index [NC,R=301] +RewriteRule ^contributing(\.html)?/?$ /contributing/index [NC,R=301] +RewriteRule ^contributing/index(\.html)?/?$ /contributing/index [NC,R=301] RewriteRule ^contributing/contributing$ /contributing/contributing.html [L,END] -RewriteRule ^contributing/contributing(\.html)?$ /contributing/contributing [NC,R=301] +RewriteRule ^contributing/contributing(\.html)?/?$ /contributing/contributing [NC,R=301] RewriteRule ^contributing/lombok-execution-path$ /contributing/lombok-execution-path.html [L,END] -RewriteRule ^contributing/lombok-execution-path(\.html)?$ /contributing/lombok-execution-path [NC,R=301] +RewriteRule ^contributing/lombok-execution-path(\.html)?/?$ /contributing/lombok-execution-path [NC,R=301] <#list setupPages as pg> RewriteRule ^setup/${pg?no_esc}$ /setup/${pg?no_esc}.html [L,END] -RewriteRule ^setup/${pg?no_esc}(\.html)?$ /setup/${pg?no_esc} [NC,R=301] +RewriteRule ^setup/${pg?no_esc}(\.html)?/?$ /setup/${pg?no_esc} [NC,R=301] RewriteRule ^features/all$ /features/index.html [L,END] -RewriteRule ^features(/all)?$ /features/all [NC,R=301] -RewriteRule ^features/index(\.html)?$ /features/all [NC,R=301] +RewriteRule ^features(/all)?/?$ /features/all [NC,R=301] +RewriteRule ^features/index(\.html)?/?$ /features/all [NC,R=301] <#list featurePages as pg> RewriteRule ^features/${pg?no_esc}$ /features/${pg?no_esc}.html [L,END] -RewriteRule ^features/${pg?no_esc}(\.html)?$ /features/${pg?no_esc} [NC,R=301] +RewriteRule ^features/${pg?no_esc}(\.html)?/?$ /features/${pg?no_esc} [NC,R=301] -RewriteRule ^features/experimental/Builder(\.html)?$ /features/Builder [NC,R=301] -RewriteRule ^features/experimental/Value(\.html)?$ /features/Value [NC,R=301] -RewriteRule ^features/experimental/var(\.html)?$ /features/var [NC,R=301] +RewriteRule ^features/experimental/Builder(\.html)?/?$ /features/Builder [NC,R=301] +RewriteRule ^features/experimental/Value(\.html)?/?$ /features/Value [NC,R=301] +RewriteRule ^features/experimental/var(\.html)?/?$ /features/var [NC,R=301] RewriteRule ^features/experimental/all$ /features/experimental/index.html [L,END] -RewriteRule ^features/experimental(/all)?$ /features/experimental/all [NC,R=301] -RewriteRule ^features/experimental/index(\.html)?$ /features/experimental/all [NC,R=301] +RewriteRule ^features/experimental(/all)?/?$ /features/experimental/all [NC,R=301] +RewriteRule ^features/experimental/index(\.html)?/?$ /features/experimental/all [NC,R=301] <#list experimentalPages as pg> RewriteRule ^features/experimental/${pg?no_esc}$ /features/experimental/${pg?no_esc}.html [L,END] -RewriteRule ^features/experimental/${pg?no_esc}(\.html)?$ /features/experimental/${pg?no_esc} [NC,R=301] +RewriteRule ^features/experimental/${pg?no_esc}(\.html)?/?$ /features/experimental/${pg?no_esc} [NC,R=301] -- cgit From c21adf7f47ed0077c53547a36041b1dba45bdcb8 Mon Sep 17 00:00:00 2001 From: Reinier Zwitserloot Date: Thu, 2 Aug 2018 15:44:40 +0200 Subject: [website] added some ugly docs on how to interop jackson and builder. We need to make this prettier later and add the magic for how to interop Singular with Jackson later. --- website/templates/features/Builder.html | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) (limited to 'website') diff --git a/website/templates/features/Builder.html b/website/templates/features/Builder.html index 4693d222..bc03749e 100644 --- a/website/templates/features/Builder.html +++ b/website/templates/features/Builder.html @@ -129,6 +129,27 @@

      + <@f.featureSection> +

      With Jackson

      +

      + You can customize parts of your builder, for example adding another method to the builder class, or annotating a method in the builder class, by making the builder class yourself. Lombok will generate everything that you do not manually add, and put it into this builder class. For example, if you are trying to configure jackson to use a specific subtype for a collection, you can write something like:

      +@Value @Builder
+@JsonDeserialize(builder = JacksonExample.JacksonExampleBuilder.class)
+public class JacksonExample {
+	@Singular private List<Foo> foos;
+	
+	@JsonPOJOBuilder(withPrefix = "")
+	public static class JacksonExampleBuilder implements JacksonExampleBuilderMeta {
+	}
+	
+	private interface JacksonExampleBuilderMeta {
+		@JsonDeserialize(contentAs = FooImpl.class) JacksonExampleBuilder foos(List<? extends Foo> foos)
+	}
+}
+
      +

      + + <@f.snippets name="Builder" /> <@f.confKeys> -- cgit From 2b0cd53d55d882fbc49d5f736c845353098eb34e Mon Sep 17 00:00:00 2001 From: Joachim Vandersmissen Date: Wed, 8 Aug 2018 16:43:09 +0200 Subject: java.util.logging.Logger does not have an error method. --- website/usageExamples/LogExample_post.jpage | 2 +- website/usageExamples/LogExample_pre.jpage | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) (limited to 'website') diff --git a/website/usageExamples/LogExample_post.jpage b/website/usageExamples/LogExample_post.jpage index eab3b046..78c0fdd9 100644 --- a/website/usageExamples/LogExample_post.jpage +++ b/website/usageExamples/LogExample_post.jpage @@ -2,7 +2,7 @@ public class LogExample { private static final java.util.logging.Logger log = java.util.logging.Logger.getLogger(LogExample.class.getName()); public static void main(String... args) { - log.error("Something's wrong here"); + log.severe("Something's wrong here"); } } diff --git a/website/usageExamples/LogExample_pre.jpage b/website/usageExamples/LogExample_pre.jpage index ba27dd27..9fa1e91c 100644 --- a/website/usageExamples/LogExample_pre.jpage +++ b/website/usageExamples/LogExample_pre.jpage @@ -5,7 +5,7 @@ import lombok.extern.slf4j.Slf4j; public class LogExample { public static void main(String... args) { - log.error("Something's wrong here"); + log.severe("Something's wrong here"); } } -- cgit From 52ffd6e1e7c7728f039d6a7121ddb7f48e07b08c Mon Sep 17 00:00:00 2001 From: Roel Spilker Date: Mon, 20 Aug 2018 22:58:35 +0200 Subject: added jitpack release to edge page --- website/templates/_download-edge.html | 3 +++ 1 file changed, 3 insertions(+) (limited to 'website') diff --git a/website/templates/_download-edge.html b/website/templates/_download-edge.html index e7eb856c..93d25db6 100644 --- a/website/templates/_download-edge.html +++ b/website/templates/_download-edge.html @@ -9,6 +9,9 @@ ${changelogEdge?no_esc}

      Download edge release now!

      +

      + You can use the edge release also from your build tool using the JitPack repository. +

      Cutting edge a bit too gutsy for you? You can grab the stable release instead. -- cgit From 42c96d92fd5a9b362eba0ceb75c35da906de130f Mon Sep 17 00:00:00 2001 From: Roel Spilker Date: Tue, 21 Aug 2018 00:01:06 +0200 Subject: remove jitpack documentation, since it's not working yet. --- website/templates/_download-edge.html | 3 --- 1 file changed, 3 deletions(-) (limited to 'website') diff --git a/website/templates/_download-edge.html b/website/templates/_download-edge.html index 93d25db6..e7eb856c 100644 --- a/website/templates/_download-edge.html +++ b/website/templates/_download-edge.html @@ -9,9 +9,6 @@ ${changelogEdge?no_esc}

      Download edge release now!

      -

      - You can use the edge release also from your build tool using the JitPack repository. -

      Cutting edge a bit too gutsy for you? You can grab the stable release instead. -- cgit