Immutables v1.0 Release Notes

  • ๐Ÿš€ Release with all of what was developed, including reengineering of template engine, project/module restructuring and annotation API changes

    ๐Ÿ”„ Changes

    • Immutable generation annotation now nested below umbrella annotation @org.immutables.value.Value which provided grouping and namespacing for the nested annotations.
      • @GenerateImmutable is now @Value.Immutable
      • @GenerateConstructorParameter is now @Value.Parameter
      • ... and so on, see website and API documentation for the details
    • ๐Ÿ‘€ See other umbrella annotations in org.immutables.value.* package: @Json, @Mongo, @Jackson
    • Main standalone artifact for the annotation processor is now org.immutables:value-standalone:1.0. There's is quick start module with transitive dependencies for integrations โ€” to not pick dependencies one by one โ€” org.immutables:quickstart:1.0
    • Most notable generated API changes
      • Added ImmutableValue.copyOf methods
      • Added array attributes
      • Added Builder.addAttribute(T...) overload for collection attributes
      • Removed ImmutableValue.Builder.copy methods