PackageTrack
Sign in Get early access

org.projectlombok:lombok-utils

1.18.12 #522 most downloaded on Maven Central rzwitserloot/lombok

What this package is like to depend on

Last release 7 years ago

no release in 18 months

Ships fairly regularly

a new release about every 3 months

Nearly every release is documented

notes for 35 of 35 stable releases

Nothing withdrawn

no release was ever pulled

15 years old

35 releases · first in 2011

0 releases in the last 12 months

see the full history below

Release timeline

35 releases · Dec 2011 to Feb 2020
2012 2014 2016 2018 2020 2022 2024 2026
Release Pre-release

Releases

latest 35
  1. 1.18.12 06 Feb 2020
    Release notes
    • PLATFORM: Support for JDK13 (including yield in switch expressions, as well as delombok having a nicer style for arrow-style switch blocks, and text blocks).
    • PLATFORM: Support for JDK14 (including pattern match instanceof expressions).
    • FEATURE: In lombok.config it is possible to import other config files, even from a .zip or .jar.
    • FEATURE: You can now configure a builder's 'setter' prefixes via @Builder(setterPrefix = "set") for example. We discourage doing this, but if some library you use requires them, have at it. Pull Request #2174, Issue #1805.
    • FEATURE: If you use @Builder's @Singular, a plural form is also generated, which has the effect of adding all elements in the passed collection. If you pass a null reference, this would result in a message-less NullPointerException. Now, it results in that exception but with a useful message attached (uses the same config as @NonNull), or alternatively via a parameter on @Singular, you can choose to ignore such a call (add nothing, return immediately); this can be useful when deserializing (e.g. Jackson JSON) and JPA/Hibernate code. Issue #2221. singular documentation.
    • FEATURE: Tired of being unable to use @javax.annotation.ParametersAreNonnullByDefault or @org.eclipse.jdt.annotation.NonNullByDefault because then the equals method that lombok generates isn't valid? Fret no more; lombok can now add nullity annotations where relevant. Set the flavour of nullity annotation you prefer in your lombok.config. Applies to the return value of toString, withX, chainable setX, static constructors, build, builder, etcetera, and the parameter of equals, canEqual, and the plural form of @Singular marked fields for builder classes. Issue #788
    • BUGFIX: If using the sonarlint plugin in eclipse for projects bound to sonarcloud, you now no longer get internal errors on sonarlint processing. Issue #2351
    • BUGFIX: lombok.experimental.Wither has been deprecated (it has been renamed to lombok.With). However, the intent is that lombok still handles the old annotation in case you haven't updated your lombok dep yet. However, only a star import on lombok.experimental.* worked; an explicit one would cause lombok to not generate any with method. Issue #2235
    • BUGFIX: Referring to an inner class inside the generics on a class marked with @SuperBuilder would cause the error wrong number of type arguments; required 3 Issue #2262; fixed by github user @Lekanich - thank you!
    • BUGFIX: Some of the code generated by @Builder did not include this. prefixes when accessing fields. While semantically it didn't matter, if you use the 'add this prefix for field accesses' save action in eclipse, the save action would break. Issue #2327
    • BUGFIX: When lombok copies javadoc from fields to relevant methods, it should generate an appropriate @return this line if lombok copies the javadoc to a generated setter that is chainable (returns itself). It didn't do that when generating the 'setters' in a @Builder. Lombok also didn't generate an appropriate @return item for @With methods. The javadoc has also been updated slightly (the this reference in the javadoc is now rendered in a code tag).Issue #2323
    • IMPROBABLE BREAKING CHANGE: Lombok now generates qualified types (so, Outer.Inner instead of just Inner) in most type signatures that it generates; this should avoid exotic scenarios where the types lombok puts in signatures end up referring to unintended other types, which can occur if your class implements an interface that itself defines a type with the same name as one defined in your source file. I told you it was exotic. Thanks to Hunter Anderson for doing some preliminary work on this change. Issue #2268
    • IMPROBABLE BREAKING CHANGE: Running java -jar lombok.jar config -v <files> no longer shows which files do not mention the specified keys. Use --non-mentioned or -n to show them anyway.
    Open source →
  2. 1.18.10 10 Sep 2019
    Release notes
    • PROMOTION: @Wither has been promoted to the main package, renamed to @With. Otherwise, no changes have been made to the annotation. The old experimental annotation will remain for a few versions as a deprecated annotation. If you had lombok.config configuration for this annotation, the configuration keys for this feature have been renamed.
    • FEATURE: You can now configure a custom logger framework using the new @CustomLog annotation in combination with the lombok.log.custom.declaration configuration key. See the log documentation for more information. Pullrequest #2086 with thanks to Adam Juraszek.
    • ENHANCEMENT: Thanks to Mark Haynes, the staticConstructor will now also be generated if a (private) constructor already exists. Issue #2100
    • ENHANCEMENT: val is now capable of decoding the type of convoluted expressions (particularly if the right hand side involves lambdas and conditional (ternary) expressions). Pull Request #2109 with thanks to Alexander Bulgakov.
    • ENHANCEMENT: You can now configure the generated builder class name via the config system, using key lombok.builder.className. See the Builder documentation and SuperBuilder documentation
    • ENHANCEMENT: If you mix up eclipse's non-null support, such as @NonNullByDefault, with lombok's @NonNull, you get a bunch of warnings about dead code that are inappropriate. These warnings are now suppressed, thanks to a contribution from Till Brychcy! Pull Request #2155
    • ENHANCEMENT: @NonNull can now also generate checks using jdk's Objects.requireNonNull or Guava's Preconditions.checkNotNull. Issue #1197
    • EXPERIMENT: Lombok is working together with checkerframework to enable detection of improper builder use (such as forgetting to set a mandatory property prior to calling build()). This experiment can be turned on by adding checkerframework = true to your lombok.config file.
    • BUGFIX: Using @JsonProperty or @JsonValue on a field in combination with @Setter or @Data would sometimes throw a ClassCastException during compilation. Issue #2156
    • BUGFIX: Delombok would turn something like List<byte[]>... in a method parameter to List<byte...>... Issue #2140
    • BUGFIX: Javac would generate the wrong equals and hashCode if a type-use annotation was put on an array type field Issue #2165
    • BUGFIX: Eclipse 2019-06 + JDK-12 compatibility + an @Singular builder entry would produce a cascade of error dialogs. Issue #2169
    • BUGFIX: Javac would throw a NullPointerException if the package-info.java did not contain a package declaration. Issue #2184
    • BUGFIX: Javac sets incorrect annotated type on constructor, getter and setter. Issue #2189
    • IMPROBABLE BREAKING CHANGE: Stricter validation of configuration keys dealing with identifiers and types (lombok.log.fieldName, lombok.fieldNameConstants.innerTypeName, lombok.copyableAnnotations).
    • IMPROBABLE BREAKING CHANGE: The fields generated inside builders for fields with defaults (with @Builder on a class with fields marked @Default) now have $value as the name; direct manipulation of these fields is not advised because there is an associated $set variable that also needs to be taken into account. Issue #2115
    Open source →
  3. 1.18.8 06 May 2019
    Release notes
    • FEATURE: You can now configure @FieldNameConstants to CONSTANT_CASE the generated constants, using a lombok.config option. See the FieldNameConstants documentation. Issue #2092.
    • FEATURE: You can now suppress generation of the builder method when using @Builder; usually because you're only interested in the toBuilder method. As a convenience we won't emit warnings about missing @Builder.Default annotations when you do this. Issue #2046
    • FEATURE: You can now change the access modifier of generated builder classes. Issue #2083.
    • FEATURE: When using @NonNull, or any other annotation that would result in a null-check, you can configure to generate an assert statement instead. Issue #2078.
    • FEATURE: Lombok now knows exactly how to treat @com.fasterxml.jackson.annotation.JsonProperty and will copy it to the right places for example when making builders. Issue #1961 Issue #1981
    • PLATFORM: A few lombok features (most notably delombok) failed on JDK12. Issue #2082
    • BUGFIX: var/val on methods that return an intersection type would now work in Eclipse. Issue #1986
    • BUGFIX: Fix for java6 regression if a field has javadoc. Issue #2066
    • BUGFIX: Delombok now delomboks java10's own var as var and not as the actual underlying type. Issue #2049
    • BUGFIX: If you use @Builder and manually write the build() method in your builder class, javac would error out instead of deferring to your implementation. Issue #2050 Issue #2061
    • BUGFIX: @SuperBuilder together with @Singular on non-lists would produce an erroneous emptyList call. Issue #2104.
    • IMPROBABLE BREAKING CHANGE: For fields and parameters marked non-null, if the method body starts with an assert statement to ensure the value isn't null, no code to throw an exception will be generated.
    • IMPROBABLE BREAKING CHANGE: When using ecj to compile java code with @Builder or @SuperBuilder in it, and a builder setter method was generated for a @NonNull-marked method, no explicit null check would be present. However, running javac on the exact same file would produce the null check. Now ecj also produces this null check. Issue #2120.
    • IMPROBABLE BREAKING CHANGE: We slightly changed the message of the exception lombok generates to handle @NonNull marked parameters. Issue #2122
    Open source →
  4. 1.18.6 12 Feb 2019
    Release notes
    • FEATURE: Javadoc on fields will now also be copied to the Builders' setters. Thanks for the contribution, Emil Lundberg. Issue #2008
    • FEATURE: The @FieldNameConstants feature now allows you to write the inner type by hand and add whatever you like to it; lombok will add the constants to this class. See the updated FieldNameConstants feature page.
    • FEATURE: There is now a lombok.config key to configure @ToString's call super behavior; it's just like @EqualsAndHashCode which has had it for a while now. Issue #1918
    • ENHANCEMENT: The toString generation of enums now contains the name of the enum constant. Issue #1916
    • PLATFORM: Due to changes to switch statements in JDK12, lombok wasn't working with the JDK12 preview. Issue #1888
    • BUGFIX: Using @Delegate in combination @NonNull would give an error in jdk8. Issue #1935
    • BUGFIX: Using the new @FieldNameConstants in eclipse would cause errors in the error log view, and error popups if save actions are turned on. Issue #2024
    • BUGFIX: Since version 1.18.4, the delombok ant task didn't work and errored with a NoClassDefFoundError. Issue #1932
    • BUGFIX: Combining both @Setter and @Wither on the same field, when that field also has javadoc with a --setter-- section or an @param tag, resulted in a race condition where the first handler to get to the field would take that part of the javadoc. This is a step along the way to fixing Issue #1033
    • BUGFIX: Compiling multi-module projects would fail on forcing new rounds. Issue #1723, Issue #1858, Issue #1946, Issue #2028
    Open source →
  5. 1.18.4 30 Oct 2018
    Release notes
    • PLATFORM: Support for Eclipse Photon. Issue #1831
    • PLATFORM: Angular IDE is now recognized by the installer Issue #1830
    • PLATFORM: Many improvements for lombok's JDK10/11 support.
    • BREAKING CHANGE: The @FieldNameConstants feature has been completely redesigned. Issue #1774 FieldNameConstants documentation
    • BREAKING CHANGE: Lombok will now always copy specific annotations around (from field to getter, from field to builder 'setter', etcetera): A specific curated list of known annotations where that is the right thing to do (generally, @NonNull style annotations from various libraries), as well as any annotations you explicitly list in the lombok.copyableAnnotations config key in your lombok.config file. Also, lombok is more consistent about copying these annotations. (Previous behaviour: Lombok used to copy any annotation whose simple name was NonNull, Nullable, or CheckForNull). Issue #1570 and Issue #1634
    • FEATURE: Lombok's @NonNull annotation can now be used on type usages (annotation on type usages has been introduced in JDK 8). @Builder's @Singular annotation now properly deals with annotations on the generics type on the collection: @Singular List<@NonNull String> names; now does the right thing.
    • FEATURE: You can now mix @SuperBuilder and toBuilder, and toBuilder no longer throws NullPointerException if a @Singular-marked collection field is null. Issue #1324
    • FEATURE: delombok now supports module paths via the --module-path option, and will automatically add lombok itself to the module path. This should make it possible to delombok your modularized projects. Issue #1848
    • FEATURE: You can pass @args.txt to delombok to read args from the text file; useful if you have really long classpaths you need to pass to delombok. Issue #1795
    • BUGFIX: @NoArgsConstructor(force=true) would try to initialize already initialized final fields in Eclipse. Issue #1829
    • BUGFIX: When using lombok to compile modularized (module-info.java-style) code, if the module name has dots in it, it wouldn't work. Issue #1808
    • BUGFIX: Errors about lombok not reading a module providing org.mapstruct.ap.spi when trying to use lombok in jigsaw-mode on JDK 11. Issue #1806
    • BUGFIX: Fix NetBeans compile on save. Issue #1770
    • BUGFIX: If you manually write your builder class so you can add a few methods of your own, and those methods refer to generated methods, you'd usually run into various bizarre error messages, but only on JDK9/10/11. This one is hard to describe, but we fixed it. Issue #1907
    Open source →
  6. 1.18.2 25 Jul 2018
    Release notes
    • BUGFIX: mapstruct + lombok in eclipse should hopefully work again. Issue #1359 and mapstruct issue #1159
    • BUGFIX: Equals and hashCode again exclude transient fields by default. Issue #1724
    • BUGFIX: Eclipse 'organize imports' feature (either explicitly, or if automatically triggered on saving via 'save actions') would remove the import for lombok.var. Issue #1783
    • BUGFIX: Lombok and gradle v4.9 didn't work together; that's been fixed. Issue #1716 and gradle-apt-plugin issue #87
    • FEATURE: You can now make builders for type hierarchies, using the new (experimental) @SuperBuilder annotation. Thanks for the contribution, Jan Rieke. @SuperBuilder documentation
    • FEATURE: @NoArgsConstructor, including forcing one with lombok.config: lombok.noArgsConstructor.extraPrivate=true now take any defaults set with @Builder.Default into account. Issue #1347
    Open source →
  7. 1.18.0 04 Jun 2018
    Release notes
    • BREAKING CHANGE: The in 1.16.22 introduced configuration key lombok.noArgsConstructor.extraPrivate is now false by default. Issue #1708
    • BUGFIX: Do not generate a private no-args constructor if that breaks the code. Issue #1703, Issue #1704, Issue #1712
    • BUGFIX: Using boolean parameters in lombok annotations would fail. Issue #1709
    • BUGFIX: Delombok would give an error message. Issue #1705
    • BUGFIX: Eclipse java10 var support didn't work if lombok was installed in your eclipse. Issue #1676
    • FEATURE: Google's Flogger (a.k.a. FluentLogger) is now available via @Flogger. Issue #1697
    • FEATURE: @FieldNameConstants has been extended to support prefixes and suffixes. By default, the generated constants are prefixed with FIELD_. Docs on @FieldNameConstants.
    Open source →
  8. 1.16.22 28 May 2018
    Release notes
    • FEATURE: Private no-args constructor for @Data and @Value to enable deserialization frameworks (like Jackson) to operate out-of-the-box. Use lombok.noArgsConstructor.extraPrivate = false to disable this behavior.
    • FEATURE: Methods can now be marked for inclusion in toString, equals, and hashCode generation. There is a new mechanism to mark which fields (and now, methods) are to be included or excluded for the generation of these methods: mark the relevant member with for example @ToString.Include or @EqualsAndHashCode.Exclude. ToString documentation EqualsAndHashCode documentation
    • FEATURE: @Getter and @Setter also allow onMethod and onParam when put on a type. Issue #1653
    • FEATURE: @FieldNameConstants is a new feature that generates string constants for your field names. Docs on @FieldNameConstants.
    • PLATFORM: Lombok can be compiled on JDK10, and should run on JDK10. Issue #1693
    • PLATFORM: lombok now counts as an incremental annotation processor for gradle. Should speed up your gradle builds considerably! Issue #1580
    • PLATFORM: Fix for using lombok together with JDK9+'s new module-info.java feature. Issue #985
    • BUGFIX: Solved some issues in eclipse that resulted in error 'A save participant caused problems'. Issue #879
    • BUGFIX: Netbeans on jdk9. Issue #1617
    • BUGFIX: Netbeans < 9. Issue #1555
    • PROMOTION: var has been promoted from experimental to the main package with no changes. The 'old' experimental one is still around but is deprecated, and is an alias for the new main package one. var documentation.
    • OLD-CRUFT: lombok.experimental.Builder and lombok.experimental.Value are deprecated remnants of when these features were still in experimental. They are now removed entirely. If your project is dependent on an older version of lombok which still has those; fret not, lombok still processes these annotations. It just no longer includes them in the jar.
    Open source →
  9. 1.16.20 08 Jan 2018
    Release notes
    • PLATFORM: Better support for jdk9 in the new IntelliJ, Netbeans and for Gradle.
    • BREAKING CHANGE: lombok config key lombok.addJavaxGeneratedAnnotation now defaults to false instead of true. Oracle broke this annotation with the release of JDK9, necessitating this breaking change.
    • BREAKING CHANGE: lombok config key lombok.anyConstructor.suppressConstructorProperties is now deprecated and defaults to true, that is, by default lombok no longer automatically generates @ConstructorProperties annotations. New config key lombok.anyConstructor.addConstructorProperties now exists; set it to true if you want the old behavior. Oracle more or less broke this annotation with the release of JDK9, necessitating this breaking change.
    • DEVELOPMENT: Compiling lombok on JDK1.9 is now possible.
    • BUGFIX: The generated hashCode would break the contract if callSuper=true,of={}. Issue #1505
    • BUGFIX: delombok no longer prints the synthetic outer-class parameter. Issue #1521
    • BUGFIX: @Builder.Default now also works when type parameters are present. Issue #1527
    • BUGFIX: @Builder now also works on method with a generified return type. Issue #1420
    • INSTALLER: By default, the lombok installer now inserts an absolute path in eclipse.ini and friends, instead of a relative path. If you want the old behavior, you can use java -jar -Dlombok.installer.fullpath=false lombok.jar.
    Open source →
  10. 1.16.18 04 Jul 2017
    Release notes
    • PLATFORM: JDK9 support much improved since v1.16.16; Issue #985
    • BUGFIX: Lombok now works with Bazel and Error Prone. Issue #1290
    • FEATURE: Lombok has a new website! A few very minor changes to the code to be more consistent with it have been added, mostly to the javadoc.
    Open source →
  11. 1.16.16 23 Mar 2017
    Release notes
    • FEATURE: @Builder.Default lets you configure default values for your fields when using @Builder. See the Builder feature page for more information. Issue #1201
    • PLATFORM: JDK9 now supported for compilation (delomboking with java9 not yet possible). Note, you'll have to do some command line wrangling. See Issue #985
    • BUGFIX: The onX feature (which lets you add annotations to generated methods) did not work if the annotation you added contained named parameters, and you are compiling with JDK8's javac. We can't fix this (it's a bug in javac), but we have provided an alternate, prettier way to do onX on javac8+. Issue #778 onX documentation
    • BUGFIX: @Data and @Value now respect the configuration for field access when generating equals, hashCode and toString. Issue #1329
    • BUGFIX: @Builder now marks generated builder 'setters' as @Deprecated if the source field is deprecated. Issue #1342
    • CHANGE: @ConstructorProperties will now also be generated for private and package private constructors. This is useful for Jackson Issue #1180
    Open source →
  12. 1.16.14 10 Feb 2017
    Release notes
    • FEATURE: Generated classes, methods and fields can now also annotated with @lombok.Generated Issue #1014
    • PLATFORM: Lombok can now be used together with other annotation processors that are looking for lombok-generated methods, but only if lombok is the first annotation processor executed. The most commonly used annotation processor affected by this change is MapStruct; we've worked with the mapstruct team specifically to allow any order. Other annotation processors might follow the framework we've built to make this possible; point the authors of any such processor to us and we'll get it sorted MapStruct issue #510 Lombok issue #973
    • PLATFORM: Eclipse: Refactor script 'rename field' when lombok has also generated getters and/or setters for this field is nicer now Issue #210
    • BUGFIX: Something you never encountered. Issue #1274
    • DEPRECATION: The configuration key lombok.addGeneratedAnnotation is now deprecated, use lombok.addJavaxGeneratedAnnotation instead.
    Open source →
  13. 1.16.12 05 Dec 2016
    Release notes
    • FEATURE: var is the mutable sister of val. For now experimental, and opt-in using ALLOW in the flagUsage configuration key. Thanks for the contribution, Bulgakov Alexander.
    • CHANGE: @Value and @FieldDefaults no longer touch static fields Issue #1254
    • BUGFIX: val in lambda expressions now work as expected Issue #911
    • BUGFIX: Getter(lazy=true) now emits an error message when used on a transient field Issue #1236
    • BUGFIX: Annotation Processors that use ecj internally (dagger) no longer give linkage errors Issue #1218
    • PLATFORM: Red Hat JBoss Developer Studio is now correctly identified by the installer Issue #1164
    • BUGFIX: delombok: for-loops with initializers that are not local variables would be generated incorrectly Issue #1076
    Open source →
  14. 1.16.10 15 Jul 2016
    Release notes
    • FEATURE: Added support for JBoss logger Issue #1103
    • ENHANCEMENT: Running javac -Xlint:all would generate a warning about unclaimed annotations Issue #1117
    • BUGFIX: Eclipse Mars would sometimes throw a NullPointerException when using @Delegate Issue #913
    • ENHANCEMENT: Add support for older maven-compiler-plugin Issue #1138
    Open source →
  15. 1.16.8 07 Mar 2016
    Release notes
    • PLATFORM: Starting jdk9 support: No more error message regarding pid
    • FEATURE: @Builder updates: It now generates clearFieldName() methods if @Singular is used. Issue #967.
    • FEATURE: @Builder updates: The annotation can now be put on instance methods. Issue #63.
    • FEATURE: @Builder updates: @Singular now supports guava's ImmutableTable Issue #937.
    • FEATURE: A lombok.config key can now be used to make your fields final and/or private... everywhere. We'll be monitoring the performance impact of this for a while. We'll touch every source file if you turn these on, and even if you don't, we have to call into the lombok config system for every file.
    • FEATURE: A lombok.config key can now be used to set the default behaviour of @EqualsAndHashCode when generating methods for a class that extends something in regards to calling the superclass implementations of equals and hashCode or not. Issue #965.
    • FEATURE: Putting @Wither on abstract classes now generates something slightly more useful: An abstract wither method. Issue #945.
    • BUGFIX: @Helper used to only be be legal in pretty specific places; now it works just about everywhere.
    • BUGFIX: lambdas with 1 argument that has an explicit type did not pretty print correctly. Issue #972.
    • BUGFIX: When using delombok, a source file with only @NonNull annotations on parameters as lombok feature would not get properly delomboked. Issue #950.
    • BUGFIX: @Delegate in javac would generate arrays instead of varargs parameters. Issue #932.
    • BUGFIX: @Value and @FieldDefaults no longer make uninitialized static fields final. Issue #928.
    • ENHANCEMENT: @Builder.ObtainVia now has @Retention(SOURCE) Issue #986.
    • ENHANCEMENT: Putting @NonNull on a parameter of an abstract method no longer generates a warning, to allow you to use this annotation to document intended behaviour Issue #807.
    Open source →
  16. 1.16.6 18 Aug 2015
    Release notes
    • FEATURE: @Helper can be placed on method-local inner classes to make all methods in the class accessible to the rest of the method. Full documentation.
    • FEATURE: @Builder(toBuilder = true) is now available. It produces an instance method that creates a new builder, initialized with all the values of that instance. For more, read the Feature page on Builder.
    • FEATURE: the hashCode() method generated by lombok via @EqualsAndHashCode, @Data, and @Value is now smarter about nulls; they are treated as if they hash to a magic prime instead of 0, which reduces hash collisions.
    • FEATURE: @NoArgsConstructor(force = true) can be used to create no args constructors even if final fields are present.
    • BUGFIX: Parameterized static methods with @Builder would produce compiler errors in javac. Issue #828.
    • BUGFIX: The new annotations-on-types feature introduced in JDK8 did not delombok correctly. Issue #855.
    • PERFORMANCE: the config system caused significant slowdowns in eclipse if the filesystem is very slow (network file system) or has a slow authentication system.
    • BUGFIX: Various quickfixes in Eclipse Mars were broken. Issue #861 Issue #866 Issue #870.
    Open source →
  17. 1.16.4 14 Apr 2015
    Release notes
    • BUGFIX: Lombok now works with Eclipse Mars.
    • BUGFIX: @UtilityClass could result in uninitialized static variables if compiled with ecj/eclipse. Issue #839
    • BUGFIX: This version of lombok has a refactored launcher (the one introduced in v1.16.0), which fixes various bugs related to errors in eclipse concerning loading classes, failure to find lombok classes, and errors on ClassLoaders. Probably impacts issues Issue #767 and Issue #826.
    Open source →
  18. 1.16.2 10 Feb 2015
    Release notes
    • FEATURE: The config key lombok.extern.findbugs.addSuppressFBWarnings can now be used to add findbugs suppress warnings annotations to all code lombok generates. This addresses feature request Issue #737.
    • FEATURE: New lombok annotation: @UtilityClass, for making utility classes (not instantiable, contains only static 'function' methods). See the feature documentation for more information.
    • BUGFIX: The ant delombok task was broken starting with v1.16.0. Note that the task def class has been changed; taskdef lombok.delombok.ant.Tasks$Delombok instead of the old lombok.delombok.ant.DelombokTask. Issue #810.
    • BUGFIX: val in javac would occasionally fail if used inside inner classes. This is (probably) fixed. Issue #729 and Issue #616.
    • BUGFIX: Starting with v1.16.0, lombok would fail to execute as an executable jar if it was in a path with spaces in it. Issue #812.
    • BUGFIX: v1.16.0 did not work in old eclipse versions (such as eclipse indigo). Issue #818.
    Open source →
  19. 1.16.0 26 Jan 2015
    Release notes
    • BUGFIX: @ExtensionMethod was broken in Eclipse using java 8. Issue #777, Issue #782
    • BUGFIX: delombok: Using exotic characters in your source files would overzealously backslash-u escape them. Now, all characters are printed unescaped, assuming your chosen encoding can support them. Otherwise, they are escaped. Issue #794
    • PROMOTION: @Builder has graduated from experimental to the main package with a few changes (addition of @Singular, removal of the fluent and chain options). The old one still exists and has been deprecated.
    • FEATURE: @Builder now supports adding the @Singular annotation to any field/parameter that represents a collection, which results in a method in the generated builder that takes in one element of that collection and adds it. Lombok takes care of generating the appropriate code to produce a compacted immutable version of the appropriate type. In this version, java.util collections and guava's ImmutableCollections are supported. See the feature documentation for more information.
    • FEATURE: Added a launcher to the lombok boot process which removes the need for -Xbootclasspath to be in your eclipse.ini file, and removes all non-public API and third party dependencies (such as ASM) from the lombok jar, thus removing them from your IDE's auto complete offerings in any project that uses lombok. For those debugging lombok, the launcher enables hot code replace which makes debugging a lot easier, as previously one was required to shut down the IDE, rebuild the jar, and relaunch. Add -Dshadow.override.lombok=/path/to/lombok/bin to the launch target for hot code replace.
    Open source →
  20. 1.14.8 15 Sep 2014
    Release notes
    • PERFORMANCE: The configuration system typically hit the filesystem twice per read configuration key instead of hardly ever. This is a continuation of Issue #717.
    Open source →
  21. 1.14.6 02 Sep 2014
    Release notes
    • BUGFIX: Usage of val would break starting with JDK8 release 1.8.0_20. Issue #766
    • BUGFIX: Depending on your eclipse project setup, releases v1.14.0 through v1.14.4 could noticably slow down your eclipse. Issue #717.
    Open source →
  22. 1.14.4 01 Jul 2014
    Release notes
    • BUGFIX: GWT produces errors in handlers on line 1 in any source files that use lombok; this has been fixed. Issue #734
    • BUGFIX-IN-PROGRESS: Many pathfinder issues in eclipse (see the bugfix in progress in v1.14.2) have now been fixed. Issue #717
    Open source →
  23. 1.14.2 10 Jun 2014
    Release notes
    • BUGFIX: syntax highlighting in eclipse will become weird and auto-complete may stop working amongst other eclipse features in v1.14.0 (regression from v1.12.6). Issue #723
    • FEATURE: Added @Tolerate; put this annotation on any method or constructor 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.
    • FEATURE: Added config key lombok.getter.noIsPrefix, which lets you disable use and generation of isFoo(), instead going with getFoo(), for {@code boolean} fields.
    • BUGFIX: Errors in the eclipse log with IndexOutOfBound: 2 in ASTConverter.convertType. Issue #721
    • BUGFIX-IN-PROGRESS: As yet unknown conditions in eclipse result in lots of IllegalArgumentException in the log with message "Path must include project and resource name". Also, 'invalid URL' or 'URI not absolute' errors can occur when using exotic file system abstractions such as Jazz. These bugs haven't been fixed, but instead of catastrophic failure, warning logs will be emitted instead. Issue #717
    • BUGFIX: mvn builds fail with a 'URI not absolute' exception. Issue #718
    Open source →
  24. 1.14.0 27 May 2014
    Release notes
    • FEATURE: You can now configure aspects of lombok project wide (or even workspace wide, or just for a single package) via the configuration system. You can configure many things; run java -jar lombok.jar config -gv for the complete list.
    • DEPRECATION: @Delegate has been moved to lombok.experimental.Delegate, and corner cases such as recursive delegation (delegating a type that itself has fields or methods annotated with @Delegate) are now error conditions. See the feature documentation for more information.
    • FEATURE: It is now possible to put annotations, such as @Nullable, on the one parameter of generated equals() methods by specifying the onParam= option on @EqualsAndHashCode, similar to how that feature already exists for @Setter. Issue #709
    • CHANGE: suppressConstructorProperties should now be configured via lombok configuration. Issue #694
    • CHANGE: The canEqual method generated by @EqualsAndHashCode, @Value and @Data is now protected instead of public. Issue #695
    • BUGFIX: Major work on improving support for JDK8, both for javac and eclipse.
    • BUGFIX: Deadlocks would occasionally occur in eclipse when using lazy getters Issue #625
    • BUGFIX: Usage of @SneakyThrows with a javac from JDK8 with -target 1.8 would result in a post compiler error. Issue #690
    • BUGFIX: Switching workspace on some versions of eclipse resulted in a 'duplicate field' error. Issue #701
    Open source →
  25. 1.12.6 06 Mar 2014
    Release notes
    • BUGFIX: Deadlocks would occasionally occur in eclipse during project builds, especially if using the gradle plugin. Issue #680
    • PLATFORM: Added support for Eclipse Luna. Issue #644
    • PLATFORM: Initial JDK8 support for eclipse's alpha support in kepler. Issue #632
    • FEATURE: The various @Log annotations now support the topic parameter, which sets the logger's name. The default remains the fully qualified type name of the class itself. Issue #667.
    • BUGFIX: Using lombok with IntelliJ and the IBM JDK would result in NPEs during initialization. Issue #683.
    • BUGFIX: Eclipse quickfix Surround with try/catch block didn't work inside @SneakyThrows annotated methods Issue #511.
    • BUGFIX: Eclipse refactoring Extract Local Variable didn't work inside @SneakyThrows annotated methods Issue #668.
    • BUGFIX: {Netbeans} @SneakyThrows would lead to unused import and break refactorings Issue #544.
    • BUGFIX: Eclipse Organize Imports would generate error: AST must not be null Issue #666.
    • BUGFIX: Copying javadoc to getters / setters / withers would copy non-relevant sections too. Issue #620.
    • ENHANCEMENT: Lombok used to ship with JNA. It added over 800k to the size of lombok.jar and could mess with usage of JNA in your local environment, especially in eclipse. Issue #682
    • DETAIL: {Delombok} Inside enum bodies the delombok formatter didn't respect the emptyLines directive Issue #664.
    • DETAIL: Use smaller primes (<127) for generating hashcodes Issue #660
    Open source →
  26. 1.12.4 15 Jan 2014
    Release notes
    • BUGFIX: v1.12.2's delombok turns all operator+assignments into just assignment. Fixed. Issue #633
    • BUGFIX: {Netbeans} v1.12.2 doesn't well with netbeans. Issue #626
    • ENHANCEMENT: Delombok now supports varied options for how it formats the resulting source files. This includes scanning the source for things like the preferred indent. Use option --format-help for more information. Issue #643
    • DETAIL: The primes lombok generates for use in generated hashCode() methods used to be direct copies from Effective Java. It turns out these particular primes are used so much, they tend to be a bit more collision-prone, so we switched them. Now, '277' is used instead of '31'. The primes for booleans have also been changed. Issue #660
    Open source →
  27. 1.12.2 10 Oct 2013
    Release notes
    • PLATFORM: Initial JDK8 support, without affecting existing support for JDK6 and 7. Issue #524. While lombok will now work on JDK8 / javac8, and netbeans 7.4 and up, lombok does not (yet) support new language features introduced with java8, such as lambda expressions. Support for these features will be added in a future version.
    • PLATFORM: Running javac on IBM J9 VM would cause NullPointerExceptions when compiling with lombok. These issues should be fixed. Issue #589.
    • CHANGE: [JDK8-related] The canonical way to write onMethod / onParameter / onConstructor annotation now uses a double underscore instead of a single underscore, so, now, the proper way to use this feature is @RequiredArgsConstructor(onConstructor=@__(@Inject)). The old way (single underscore) still works, but generates warnings on javac 8.
    • BUGFIX: Using @NonNull on an abstract method used to cause exceptions during compilation. Issue #594.
    • BUGFIX: Using @NonNull on methods that also have @SneakyThrows or @Synchronized caused arbitrary behaviour. Issue #623.
    • GERMANY: Major version bumped from 0 to 1, because allegedly this is important. Rest assured, this change is nevertheless backwards compatible.
    Open source →
  28. 0.12.0 15 Jul 2013
    Release notes
    • FEATURE: javadoc on fields will now be copied to generated getters / setters / withers. There are ways to specify separate javadoc for the field, the setter, and the getter, and @param and @return are handled appropriately. Addresses feature request Issue #132. @Getter and @Setter documentation. @Wither documentation.
    • CHANGE: The desugaring of @Getter(lazy=true) is now less object creation intensive. Documentation has been updated to reflect what the new desugaring looks like. @Getter(lazy=true) documentation.
    • PROMOTION: @Value has been promoted from experimental to the main package with no changes. The 'old' experimental one is still around but is deprecated, and is an alias for the new main package one. @Value documentation.
    • FEATURE: {Experimental} @Builder support. One of our earliest feature request issues, Issue #89, has finally been addressed. @Builder documentation.
    • FEATURE: @NonNull on a method or constructor parameter now generates a null-check statement at the start of your method. This nullcheck will throw a NullPointerException with the name of the parameter as the message. Issue #549
    • BUGFIX: Usage of Lombok.sneakyThrow() or @SneakyThrows would sometimes result in invalid classes (classes which fail with VerifyError). Issue #543
    • BUGFIX: Using val in try-with-resources did not work for javac. Issue #555
    • BUGFIX: When using @Data, warnings are not generated if certain aspects are not generated because you wrote explicit versions of them. However, this gets confusing with equals / hashCode / canEqual, as nothing is generated if any one of those methods is present. Now, if one of equals or hashCode is present but not the other one (or canEqual is present but equals and/or hashCode is missing), a warning is emitted to explain that lombok will not generate any of the equals / hashCode methods, and that you should either write them all yourself or remove them all. Issue #548
    • BUGFIX: Possibly fixed a race condition in patcher Issue #566.
    Open source →
  29. 0.11.8 23 Apr 2013
    Release notes
    • FEATURE: Major performance improvements in eclipse by profiling the project clean process.
    • CHANGE: {Experimental} The experimental @Value feature no longer implies the also experimental @Wither. If you like your @Value classes to make withers, add @Wither to the class right next to @Value.
    • FEATURE: {Experimental} Reintroduced onMethod, onConstructor and onParam to @Getter, @Setter, @Wither, and @XArgsConstructor. These parameters allow you to add annotations to the methods/constructors that lombok will generate. This is a workaround feature: The stability of the feature on future versions of javac is not guaranteed, and if a better way to implement this feature is found, this feature's current incarnation will be removed without a reasonable period of deprecation. Documentation on the onX feature
    • FEATURE: Added support for Log4j v2.0 via @Log4j2 Issue #505
    • ENHANCEMENT: The Lombok installer can now find and install lombok into JBoss Developer Studio. The installer will now also look for eclipse and eclipse variants in your home directory. Issue #507
    • BUGFIX: @ExtensionMethods no longer causes VerifyError exceptions when running eclipse-compiled code if extension methods are called on expressions which are method calls whose return type is a type variable. For example, someList.get(i).extensionMethod() would fail that way. Issue #509
    • BUGFIX: java 7's try-with-resources statement did not delombok correctly. Issue #532
    Open source →
  30. 0.11.6 29 Oct 2012
    Release notes
    • FEATURE: Lombok can be disabled entirely for any given compile run by using JVM switch -Dlombok.disable. This might be useful for code style checkers and such.
    • FEATURE: Added support for Slf4j extended logger Issue #494
    • BUGFIX: {Delombok} Running delombok has been causing VerifyError errors when used with javac 1.7 since 0.11.0. Issue #495
    • BUGFIX: A conflict between lombok and certain eclipse plugins would result in NullPointerExceptions in the log when using @Delegate.
    • BUGFIX: NullPointerException in lombok.&#8203;javac.&#8203;handlers.&#8203;JavacHandlerUtil.&#8203;upToTypeNode&#8203;(JavacHandlerUtil.java:978) when compiling with @ExtensionMethod in javac and generated constructors are involved. Issue #496
    • BUGFIX: @Deprecated on a field that gets a generated setter in eclipse would result in IllegalArgumentException, which you wouldn't see unless you have the error log open. If you have save actions defined, you'd get a popup box with the exception. Now fixed. Issue #481
    Open source →
  31. 0.11.4 13 Aug 2012
    Release notes
    • FEATURE: {Experimental} @Value, @Wither and @FieldDefaults are now available. These are a lot like @Data but geared towards immutable classes. Documentation on @Value, Documentation on @Wither and Documentation on @FieldDefaults.
    • BUGFIX: Eclipse would throw an OOME if using @ExtensionMethod. Issue #463
    • BUGFIX: {Netbeans} @Cleanup and @Synchronized cause far fewer issues in the netbeans editor. Issue #466
    • BUGFIX: {Installer} Erroneous messages about the installer complaining about needing root access when installing or removing lombok from eclipse installs has been fixed. The installer edge of this problem was actually already fixed in v0.11.2. Issue #436
    • BUGFIX: @ExtensionMethod had all sorts of issues in javac. Issue #472
    • BUGFIX: Generating static constructors with javac when you have fields with generics, i.e. Class<T>, caused errors. Issue #469
    • BUGFIX: Minor @ExtensionMethod issues in eclipse, such as the ability to call extension methods on a super reference which is now no longer possible. Issue #479
    Open source →
  32. 0.11.2 02 Jul 2012
    Release notes
    • FEATURE: {Experimental} @ExtensionMethod is now available to add extensions to any type in the form of static methods that take as first parameter an object of that type. Documentation on @ExtensionMethod
    • FEATURE: ONGOING: Fix for using lombok together with gwt-designer.
    • ENHANCEMENT: Small performance enhancements in equals and hashCode. Issue #439
    • BUGFIX: Eclipse would display an error message regarding an invalid super constructor in the wrong location. Issue #409
    • BUGFIX: Eclipse refactor script 'rename method arguments' should work more often with lombok-affected methods.
    • BUGFIX: Using val in an enhanced for loop did not work if the iterable was a raw type.
    • BUGFIX: Using @Getter(lazy=true) when the data type is boolean, int, array, or some other type that requires special treatment for hashCode/equals, now works properly with @Data, @EqualsHashCode and @ToString. Issue #449
    • BUGFIX: SneakyThrows in constructor should not wrap this/super call in try-block Issue #454
    • BUGFIX: Setting breakpoints on code above the first generated method was not possible. Issue #450
    Open source →
  33. 0.11.0 26 Mar 2012
    Release notes
    • FEATURE: {Experimental} 'fluent' getters and setters (using just fieldName as methodname instead of getFieldName), setters that return this instead of void, and support for fields with prefixes is introduced with this lombok version. Also, the number of parameters of any existing methods with the same name that lombok would generate are now taken into account; previously if you had any method named setX regardless of how many parameters it has, lombok would avoid generating a setX method. Now lombok generates the method if all present setX methods have a number of parameters other than 1. documentation.
    • FEATURE: The combination of @Delegate and @Getter or @Data will now delegate to the result of a generated getter. Issue #401
    • FEATURE: Developing android apps on eclipse with lombok is now possible by running java -jar lombok.jar publicApi and including the generated jar in your project. Documentation on using lombok for android development.
    • BUGFIX: In NetBeans the generated default constructor would still be generated even if Lombok also generated constructors. Issue #399
    • BUGFIX: Some classes that contain @SneakyThrows would not compile (throw ClassFormatError). Issue #412
    • BUGFIX: delombok: When @Delegate would generate a method with type parameters of the type T extends package.Class, a dot would be prepended to the type name. Issue #414
    • BUGFIX: @Getter and @Setter now generate deprecated methods for deprecated fields. Fixes Issue #415
    • BUGFIX: @Delegate would not generate @Deprecated on methods marked deprecated in javadoc. Fixes Issue #421
    • BUGFIX: Using val with a type like Outer<TypeArgs>.Inner now works. Issue #416
    • BUGFIX: @Getter(lazy=true) where the variable type is a primitive and the initializing expression is of a different primitive type that would type coerce implicitly, i.e. ints can be assigned to longs without a cast, didn't work before. Issue #418
    • BUGFIX: val is no longer legal inside basic for loops (the old kind, not the foreach kind). These variables should rarely be final, and in practice it wasn't possible to delombok this code properly. Issue #419
    • BUGFIX: PrettyCommentsPrinter now prints default clause of annotation methods. Fixes Issue #423
    Open source →
  34. 0.10.8 19 Jan 2012
    Release notes
    • FEATURE: @Delegate can now be used on a no-argument method, which works similarly to adding it to fields. See documentation.
    • BUGFIX: Eclipse refactoring Extract Interface was broken when using lombok annotation to generate methods. Issue #159
    • BUGFIX: Eclipse action Sort Members was broken when using lombok annotations to generate methods or fields. Issue #338
    • BUGFIX: Eclipse action Refactor/Rename on an inner type was broken when using lombok annotations. Issue #389
    • BUGFIX: 0.10.6 causes ClassNotFoundErrors when using ecj (and thus, play framework, gwt, etc). Issue #393
    • BUGFIX: Eclipse parsing was broken when using lombok annotations with parentheses. Issue #398
    • ENHANCEMENT: Lombok now adds a line to the Eclipse About dialog about itself.
    Open source →
  35. 0.10.6 19 Dec 2011
    Release notes
    • PERFORMANCE: Performance issues (memory leaks) when using lombok in netbeans, introduced in 0.10, have been fixed. Issue #315
    • BUGFIX: Eclipse quickfix "Add unimplemented methods" would sometimes insert the new method stubs in strange places, especially if @Data was present. Issue #124
    • BUGFIX: Eclipse quickfix "Assign parameter to new field" would insert it outside the class body if @Data was present. Issue #295
    • BUGFIX: Renaming a @Data-annotated class in eclipse using Alt+Shift+R no longer mangles the data annotation. Issue #359
    • BUGFIX: Using save action 'Use this qualifier for field accesses, only if necessary' did not work together with @Data in certain cases. Issue #374
    • BUGFIX: Organize imports, either run manually or as save action, would throw an exception. Issue #381
    • BUGFIX: Extracted constants would be placed outside the class body when a logging annotation was present. Issue #388
    Open source →

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive