News on MapStruct

Native Optional support, improved Kotlin Support, and much more: MapStruct 1.7.0.Beta1 is out

Sun, 01 Feb 2026 00:00:00 +0000

It’s my pleasure to announce the first Beta release of MapStruct 1.7.

The new release comes with a lot of new functionality, e.g.:

Native Optional support
Improved Kotlin support
Support for Java 21 Sequenced Collections
Support for ignoring multiple target properties at once

MapStruct Spring Extensions 2.0.0 released

Sat, 15 Nov 2025 00:00:00 +0000

It is my pleasure to announce the next official release of MapStruct Spring Extensions. What started out as a StackOverflow question turned into its own (sub-)project within the MapStruct organization.

Changes in this release:

The minimum requirements for applying these extensions are now Java 17 and Spring 6.
Exclusive use of jakarta.annotation.PostConstruct instead of having a default option of the legacy javax.annotation.PostConstruct.

Including the annotations and extensions defined in this project will generate a class acting as bridge between MapStruct’s conventions and Spring' s ConversionService API that in turn can be added to any Mapper’s uses attribute. See the examples for details.

MapStruct Spring Extensions 1.1.3 released

Fri, 14 Mar 2025 00:00:00 +0000

Changes in this release:

The change introduced in the previous release which stored TypeDescriptors as fields in the generated Adapter class caused rare issues with certain generic type definitions. Jesse Bonzo has thankfully provided a fix for this.
The modified converter scan led to errors when used with multiple SpringMapperConfigs in the same project, because it would generate several configurations with identical bean names. Thanks to simonovdenis, we have now got an option to configure the name for the generated configuration as well.

MapStruct 1.6.3 bug fix released

Sat, 09 Nov 2024 00:00:00 +0000

It is my pleasure to announce the 1.6.3 bug fix release of MapStruct. This release includes 3 bug fixes. You may wonder where the Blog Post for 1.6.2 is. There was no blog post as we released it immediately after 1.6.1 due to a regression in the 1.6.1 release, when using Java records. With this release we support the use of the Java 19 LinkedHashSet and LinkedHashMap factory methods. Redundant if condition in Java record mapping with RETURN_DEFAULT strategy (#3747) Stackoverflow with Immutables custom builder (#3370) Unused import of java.

MapStruct 1.6.1 bug fix released

Sun, 15 Sep 2024 00:00:00 +0000

It is my pleasure to announce the 1.6.1 bug fix release of MapStruct. This release includes 1 enhancement and 8 bug fixes, including some regressions introduced in 1.6.0.

With this release we support the use of the Java 19 LinkedHashSet and LinkedHashMap factory methods.

MapStruct Spring Extensions 1.1.2 released

Sat, 31 Aug 2024 00:00:00 +0000

Changes in this release:

TypeDescriptors will now be kept as fields in generated ConversionServiceAdapters which can speed up the conversion process. Thanks to Jesse Bonzo for this contribution.
The generated ConverterScan so far used the legacy @PostConstruct annotation from the deprecated javax.annotation package underneath. Thanks to Jeff Schnitzer’s contribution, the generator now checks for the availability of the “new” jakarta.annotation.PostConstruct annotation and will prefer this if it’s available. For reasons of backwards compatibility, javax.annotation.PostConstruct is the fallback.

MapStruct 1.6.0 is out

Mon, 12 Aug 2024 00:00:00 +0000

I am very happy to announce the final release of MapStruct 1.6! This is our 6th major release since November 2015.

As you can see with this release we decided to remove the .Final and only use the version (1.6.0). We’ll keep doing this for final releases.

Besides bug fixes, the 1.6 release brings some new exciting features:

Access to target / source property names in conditional and mapping methods
Conditional mapping for source parameters
Passing annotations to generated code
Add javadoc to generated code
New built-in conversions

MapStruct 1.6.0.RC1 is out

Sat, 20 Jul 2024 00:00:00 +0000

I am very happy to announce the first (and last) release candidate of MapStruct 1.6. We are looking into release the final version of 1.6 in the next two weeks.

This release provides mostly bug fixes since 1.6.0.Beta2.

This release contains 2 breaking changes, have a look at them when upgrading

Conditional mapping for source parameters and much more: MapStruct 1.6.0.Beta2 is out

Sat, 11 May 2024 00:00:00 +0000

It’s my pleasure to announce the second Beta release of MapStruct 1.6.

The new release comes with some new functionality, e.g.:

Conditional mapping for source parameters
Support to access source property name in condition methods via an annotation

This release is also our first release that has been fully automated using the great JReleaser. This would hopefully mean that we can realase more often, as the burden of manual release has been reduced.

We’d like to thank our new supporters:

And of course thanks to our previous supporters:

If you’d like to join this list and donate to the project MapStruct is accepting donations through Open Collective or GitHub.

MapStruct Spring Extensions 1.1.1 released

Thu, 04 Jan 2024 00:00:00 +0000

Changes in this release:

This release is functionally identical to 1.1.0. The only modification worthwhile mentioning is a fix to the dependencies for the newly introduced test-extensions module which now won’t rely on outdated Spring versions anymore. Thanks to George Noble for pointing out this oversight which led to some organizations rejecting the library due to a security vulnerability in the respective Spring versions.

Support for accessing property names, passing annotations to generated code, sponsoring MapStruct and much more: MapStruct 1.6.0.Beta1 is out

Sat, 04 Nov 2023 00:00:00 +0000

It’s my pleasure to announce the first Beta release of MapStruct 1.6.

The new release comes with a lot of new functionality, e.g.:

Access to target / source property names in conditional and mapping methods
Passing annotations to generated code
Add javadoc to generated code
New built-in conversions

With this release we are also happy to announce that MapStruct has started accepting donations through Open Collective or GitHub. We’d like to thank to everyone that has already started in supporting us:

MapStruct Spring Extensions 1.1.0 released

Mon, 25 Sep 2023 00:00:00 +0000

Changes in this release:

New module test-extensions which contains a @ConverterScan annotation that greatly simplifies the writing of integration tests. Thanks to Joose Haverinen for the suggestion.
New annotation @AdapterMethodName which allows a developer to override the default name for generated adapter methods. Thanks to pw-lehre for the inspiration.
New annotation @DelegatingConverter that will generate a converter calling the one whose method is annotated with this. The intended use is in conjunction with MapStruct Core’s @InheritInverseConfiguration. Thanks again to pw-lehre for the idea.

MapStruct Spring Extensions 1.0.2 released

Tue, 08 Aug 2023 00:00:00 +0000

Changes in this release:

Spring Extensions will now honour the mapstruct.suppressGeneratorTimestamp processor option. Thanks to freund17 for pointing out this omission.

We’re functionally complete. There are currently no plans for further features, although we will keep an eye on compatibility with future MapStruct and Spring releases as well as community requests.

Including the annotations and extensions defined in this project will generate a class acting as bridge between MapStruct’s conventions and Spring’s ConversionService API that in turn can be added to any Mapper’s uses attribute. See the examples for details.

MapStruct 1.5.5.Final bug fix released

Sun, 23 Apr 2023 00:00:00 +0000

It is my pleasure to announce the 1.5.5.Final bug fix release of MapStruct. This release includes support for Jakarta XML Binding , 1 bug fixes and a documentation improvements.

MapStruct Spring Extensions 1.0.1 released

Sun, 23 Apr 2023 00:00:00 +0000

Changes in this release:

Collection type mappings ignored the generic element type. This was no functional problem as such, but it prevented generating an adapter class for several collection type mappings within the same scope. Thanks to Hypercube Software and coding-guo for pointing this out.

We’re now functionally complete. There are currently no plans for further features, although we will keep an eye on compatibility with future MapStruct and Spring releases.

MapStruct 1.5.4.Final bug fix released

Thu, 13 Apr 2023 00:00:00 +0000

It is my pleasure to announce the 1.5.4.Final bug fix release of MapStruct. This release includes support for Jakarta CDI , 5 bug fixes and a documentation improvement.

MapStruct Spring Extensions 1.0.0 released

Thu, 09 Feb 2023 00:00:00 +0000

Changes in this release:

It is not necessary anymore to explicitly declare the convert method in the mapper interface if it doesn’t require any Mapstruct core annotations like @Mapping. Thanks to Myat Min for pointing out this oversight.

We’re now functionally complete. There are currently no plans for further features, although we will keep an eye on compatibility with future MapStruct and Spring releases.

MapStruct 1.5.3.Final bug fix released

Fri, 07 Oct 2022 00:00:00 +0000

It is my pleasure to announce the 1.5.3.Final bug fix release of MapStruct. This release includes 18 bug fixes and 7 documentation improvements.

The most notable fixes are around the handling of nested imports and generics handling

MapStruct 1.5.2.Final bug fix released

Sat, 18 Jun 2022 00:00:00 +0000

It is my pleasure to announce the 1.5.2.Final bug fix release of MapStruct. You might ask yourself, where is 1.5.1. We released that version on 5th of June 2022, 3 days after the 1.5.0.Final release. It had a fix for a bug that was reported by our good friends from JHipster.

This release includes 1 enhancements and 2 bug fixes.

With this release we started supporting Text blocks for all the expressions.

MapStruct Spring Extensions 0.1.2 released

Thu, 09 Jun 2022 00:00:00 +0000

Changes in this release:

Mark the Processor as incremental for Gradle Build. Thanks to Olivier Boudet) for raising the original issue.
Make sure the @Generated annotation is being imported from the correct package for the build environment. This now follows the same logic as the MapStruct Core. Thanks to John Kelly for pointing out this omission.
In line with MapStruct Core 1.5, we have upgraded the build environment to JDK 11.

MapStruct 1.5.0.Final is out

Fri, 03 Jun 2022 00:00:00 +0000

I am very happy to announce the final release of MapStruct 1.5! This is our 5th major release since November 2015.

Besides bug fixes, the 1.5 release brings some new exicting features:

Support for mapping from Map<String, ???> to a bean
Conditional mapping
Support for subclass mapping
Support for Jakarta dependency injection

MapStruct 1.5.0.RC1 is out

Sun, 20 Mar 2022 00:00:00 +0000

I am very happy to announce the first release candidate of MapStruct 1.5!

This release provides mostly bug fixes and other smaller improvements since 1.5.0.Beta2.

Support for Jakarta dependency injection
Allow @InheritInverseConfiguration with @SubclassMapping(s)
Various small bug fixes and documentation clarifications

MapStruct Spring Extensions 0.1.1 released

Mon, 07 Feb 2022 00:00:00 +0000

This release fixes a bug related to dealing with array types as mapping sources or targets.

Support for subclass mapping, various enhancements and much more: MapStruct 1.5.0.Beta2 is out

Sun, 12 Dec 2021 00:00:00 +0000

It’s my pleasure to announce the second Beta release of MapStruct 1.5.

The new release comes with new functionality and some bug fixes, e.g.:

Support for subclass mapping
NullValueMappingStrategy for maps / collections
New built-in conversions
Generate imports only for Top level types

Support for mapping from Map to bean, conditional mapping and much more: MapStruct 1.5.0.Beta1 is out

Sun, 18 Jul 2021 00:00:00 +0000

It’s my pleasure to announce the first Beta release of MapStruct 1.5.

The new release comes with a lot of new functionality, e.g.:

Support for mapping from Map<String, ???> to a bean
Conditional mapping
Mapping Iterable<?> object to an object
New built-in conversions
Value mapping enhancements

MapStruct Spring Extensions 0.1.0 released

Sat, 03 Jul 2021 00:00:00 +0000

This release adds the possibility to provide “external” conversions to the generated ConversionServiceAdapter. These could be Spring builtin ones or provided in some runtime dependency. See the reference guide for details.

MapStruct Spring Extensions 0.0.3 released

Tue, 25 May 2021 00:00:00 +0000

It is my pleasure to announce the third official release of MapStruct Spring Extensions. What started out as a StackOverflow question turned into its own (sub-)project within the MapStruct organization.

This third release fixes a circular dependency issue which occurred in non-trivial mapper hierarchies and would lead to mappers being hidden from the ConversionService. Kudos go to Daniel Shiplett and Alexey for their help in chasing down the cause and resolving the issue.

MapStruct Spring Extensions 0.0.2 released

Mon, 15 Feb 2021 00:00:00 +0000

It is my pleasure to announce the second official release of MapStruct Spring Extensions. What started out as a StackOverflow question over a year ago has turned into its own (sub-)project within the MapStruct organization.

This second release allows specifying a defined name for the generated ConversionServiceAdapter bean. Kudos go to David Hamilton for this contribution. Additionally, you will now find a reference guide on the main MapStruct homepage.

MapStruct 1.4.2.Final bug fix released

Sun, 31 Jan 2021 00:00:00 +0000

It is my pleasure to announce the 1.4.2.Final bug fix release of MapStruct.

This release includes 2 enhancements, 10 bug fixes, and some documentation fixes.

The most notable enhancement is the relaxing of the strictness for Mapping#qualifiedByName and Mapping#qualifier for collection mappings.

MapStruct Spring Extensions 0.0.1 released

Thu, 03 Dec 2020 00:00:00 +0000

It is my pleasure to announce the first official release of MapStruct Spring Extensions. What started out as a StackOverflow question over a year ago has turned into its own (sub-)project within the MapStruct organization.

This first release solves the issue described in the question linked above: How can we use MapStruct mappers defined as Spring Converters in a Spring-idiomatic way when building a hierarchy of them? Including the annotations and extensions defined in this project will generate a class acting as bridge between MapStruct’s conventions and Spring’s ConversionService API that in turn can be added to any Mapper’s uses attribute. See the examples for details.

MapStruct 1.4.1.Final bug fix released

Sun, 11 Oct 2020 00:00:00 +0000

It is my pleasure to announce the 1.4.1.Final bug fix release of MapStruct. Even though we did 3 Beta and 1 CR release we still managed to introduce some regressions.

This release includes 6 bug fixes.

The most notable fix is the support for the IntelliJ incremental annotation processing.

MapStruct 1.4.0.Final is out

Sun, 27 Sep 2020 00:00:00 +0000

Long overdue it is our pleasure to announce the final version MapStruct 1.4. This is our 4th release since november 2015.

Besides bug fixes, the 1.4 release brings some new exciting features:

Making use of constructor arguments when instantiating mapping targets
Support Gradle incremental annotation processing feature
Map nested bean properties to current target
Support value mapping between String and Enum
Support @Mapping in meta annotations
User control over mapping features (direct, method, conversion, 2step)
Support mapping from / to Java 14 records (preview feature)
New EnumTransformationStrategy and EnumNamingStrategy SPIs
Improve performance for 2 step mapping methods

MapStruct 1.4.0.CR1 released

Sun, 30 Aug 2020 00:00:00 +0000

I’m very happy to announce the first candidate release of MapStruct 1.4!

The CR1 release mostly provides bug fixes and other smaller improvements since the Beta 3, So what did we tackle in 1.4.0.RC1

Support for using a custom exception for an unexpected value mapping
Fix various bugs with generics and constructor mapping
Various small enhancements around error messages

MapStruct 1.4.0.Beta3 is out

Sun, 19 Jul 2020 00:00:00 +0000

Today we release a new beta version of MapStruct 1.4.0. We are very happy to have received good feedback from our users. However, it is like always when writing software bugs are made and are there to be solved. So what did we tackle in 1.4.0.Beta3

Improve selection of mapping constructor
Improve error messages for 2 step mapping methods
Fix various bugs and regressions in relation to 2 step mappings

MapStruct 1.4.0.Beta2 is out

Sun, 05 Jul 2020 00:00:00 +0000

Improve performance for 2 step mapping methods
Having 2 step mapping methods, based on a generic -in between- type. For example: source (String) -> Embeded mapStringToEmbeded(String s) -> List toSingleElementList( T e ) -> target (List)
Improved error messages for qualifiers

Support for constructors, Gradle incremental compilation and much more: MapStruct 1.4.0.Beta1 is out

Mon, 01 Jun 2020 00:00:00 +0000

It’ my pleasure to announce the first Beta release of MapStruct 1.4.

The new release comes with a whole lot of new functionality, e.g.:

Making use of constructor arguments when instantiating mapping targets
Support Gradle incremental annotation processing feature
Map nested bean properties to current target
Support value mapping between String and Enum
Support @Mapping in meta annotations
User control over mapping features (direct, method, conversion, 2step)
Support mapping from / to Java 14 records (preview feature)
New EnumTransformationStrategy and EnumNamingStrategy SPIs

Announcing Gem Tools

Mon, 03 Feb 2020 00:00:00 +0000

Lately, we have been busy working on the release of MapStruct 1.4, adding new features and trying to simplify our codebase so we can maintain it easier and add features faster.

From the start of the project we have been using a utility tool Hickory for generating Prisms (partial reflection access to annotations) during compilation time. Basically, we’ve been using an annotation processor to generate access to the MapStruct annotations, this allows us to access the MapStruct annotation in a type-safe way, without requiring the annotation JAR to be on the processor path. This is a really old project and the only release on Maven Central is from March 2010.

Thus we needed something newer and created our own utility. Say hi to Gem Tools.

MapStruct and Quarkus - a match made in heaven?

Fri, 06 Dec 2019 00:00:00 +0000

This year is nearly over, but it was started with something new that came up in the Java world: Quarkus. You may already have heard about it, if not, don’t worry, I will quickly summarize what it is.

Additionally to this post you can also find a working example in our examples repository.

MapStruct 1.3.1.Final bug fix released

Sun, 29 Sep 2019 00:00:00 +0000

It is my pleasure to announce the 1.3.1.Final bug fix release of MapStruct. Since the Final release of MapStruct 1.3.0.Final we have received amazing feedback from the community.

This release includes 3 enhancements, 12 bug fixes and 7 documentation improvements.

The enhancements include:

Ability to disable builders on method level via Builder#disableBuilder
Stricter matching for lifecycle methods / non-unique parameters

MapStruct 1.3.0.Final is out in the wild

Sun, 10 Feb 2019 00:00:00 +0000

Long overdue it is our pleasure to announce the final version MapStruct 1.3. This is our 3rd release since november 2015.

Besides bug fixes, the 1.3 release brings some new exciting features:

Mapping (immutable) objects using builders
Enhanced and more flexible update method (@MappingTarget) handling
Constructor injection for Annotation Based component models
Source policy for unmapped source properties (unmappedSourcePolicy)
Support for defaultExpression
Limit mapping only to explicitly defined mappings
Performance improvement of constant / defaultValue primitive to String mappings
Warnings for precision loss

Java 8 as a baseline, null value property mappings improved builders support and much more: MapStruct 1.3.0.Beta2 is out

Mon, 12 Nov 2018 00:00:00 +0000

It’s my pleasure to announce the second Beta release of MapStruct 1.3.

With the new Release we have finally made the switch to Java 8 as a baseline.

There are a whole lot of new enhancements as well, e.g.:

New NullValuePropertyMappingStrategy for controlling how properties are for update methods
Warnings for precision loss
Caching and reusing javax.xml.datatype.DatatypeFactory
Recursive source presence tracking
Improvements in the builders support

Support for builders, mapper constructor injection and much more: MapStruct 1.3.0.Beta1 is out

Sun, 15 Jul 2018 00:00:00 +0000

It’ my pleasure to announce the first Beta release of MapStruct 1.3.

The new release comes with a whole lot of new functionality, e.g.:

Mapping of (immutable) objects using builders
Constructor injection for Annotation Based component models
unmappedSourcePolicy support
Support for defaultExpression
Limit mapping only to explicitly defined mappings
Performance improvement of constant / defaultValue primitive to String mappings

Filip Hrisafov Taking Over as MapStruct Project Lead

Sun, 18 Mar 2018 00:00:00 +0000

It’s with great happiness and excitement that I’m announcing that Filip Hrisafov is taking over the role of MapStruct’s project lead!

Really that’s just manifesting the status quo of the last couple of months, during which Filip already was acting in that role effectively. As I’ve been able to contribute less and less time towards MapStruct over the last year, it was about time to pass on the baton to a new lead, with many fresh ideas and a great level of enthusiasm.

Filip joined the team in 2016, sending in a patch for improving our test suite. Since then, he became an invaluable member of the MapStruct community. He implemented several new features and stepped up to help with reviewing pull requests, providing help to new contributors, answering related questions on StackOverflow and even doing the last few releases of the project.

Having had the pleasure of working with Filip over the last years, I’m convinced that going forward he’s the perfect person for leading the project.

MapStruct 1.2.0.Final is out

Wed, 18 Oct 2017 00:00:00 +0000

I’m very happy to announce the final version MapStruct 1.2!

After less than a year from the 1.1.0.Final release, 3 Beta and 2 CR releases, MapStruct 1.2.0.Final is finally out :).

Besides bug fixes, the 1.2 release brings some new interesting features:

MapStruct can be used with Lombok out of the box
Java 8 Stream support
Mappings based on public fields
Automatic creation of nested mapping methods
Mapping methods can take “pass-through” context parameters, addressing different use cases like
Passing a locale, timezone or similar to custom mapping methods
Keeping track of processed nodes in circular object graphs
Target bean factory methods can access a mapping’s source parameter(s)
Nested target mappings have been reworked from the ground up
Java 9 Compatibility

MapStruct support for IntelliJ IDEA

Tue, 19 Sep 2017 00:00:00 +0000

I am very happy to announce the first version of the MapStruct IntelliJ IDEA plugin. Now we have official support for 2 IDEs, Eclipse being the first IDE for which we had support from earlier (plugin here).

With the power of IntelliJ you now get completions in @Mapping and @ValueMapping annotations (also for nested mappings ;)). Apart from that you also get support for: finding usages of methods directly within annotations, going to declarations from annotations, highlighting support within annotations and refactoring support.

MapStruct 1.2.0.CR2 released

Mon, 28 Aug 2017 00:00:00 +0000

I’m very happy to announce the second candidate release of MapStruct 1.2!

The CR2 release mostly provides bug fixes and other smaller improvements since the CR1, e.g. related to the handling of mappingInheritanceStrategy (issue #1255). Further fixes concern the handling nested target properties (#1269).

MapStruct 1.2.0.CR1 released

Tue, 25 Jul 2017 00:00:00 +0000

I’m very happy to announce the first candidate release of MapStruct 1.2!

The CR1 release mostly provides bug fixes and other smaller improvements since the Beta 3, e.g. related to the handling of the @ObjectFactory annotation (issues #1131 and #1242). Further fixes concern the handling of imports in the generated code (#1227, #543) and the error reporting in case of incorrect mapper definitions (#1150, #1185).

MapStruct 1.2.0.Beta3 is out

Fri, 02 Jun 2017 00:00:00 +0000

The summer is nearly there, and so is MapStruct 1.2. Today it’s my pleasure to announce another release on our way to the Final: MapStruct 1.2 Beta 3!

This release continues to improve and stabilize the new feature of automatically creating sub-mapping methods. By default, no sub-mapping methods are generated for any types of the JDK (as those are typically no bean types which one would like to step into in the course of mapping). If more fine-grained control is needed, there is an SPI now which lets you define for which types sub-mapping methods should be created. Eventually, you also can turn off automatic sub-mappings completely if you prefer to have full control by explicitly defining all required bean mapping methods.

Besides that, several bugs were fixed:

The generated mappers were missing import statements in some cases (#1215, #1164)
Field mappings didn’t work for nested target properties (#1155)
Accessing a non-existent nested target property wasn’t handled gracefully (#1153)

MapStruct 1.2.0.Beta2 released

Thu, 16 Mar 2017 00:00:00 +0000

Just shy of a month after the first Beta release of MapStruct 1.2, the team is happy to announce the second Beta, fixing a couple of bugs that sneaked in with the many new features offered by the new 1.2 release line.

We fixed 16 issues, most of them reported by users. The most infamous bugs reported and fixed are:

Some type conversions stopped working under some circumstances due to an odd JDK behaviour that we didn’t run into previously.
Unmapped target properties in name based mappings resulted in an error instead of being reported as configured with unmappedTargetPolicy.
A StackOverflowError was thrown while automatically generating methods in a type structure with circles.
@Context parameters didn’t play along with nested property mappings.

Plus, the newly introduced automapping feature now also creates Enum mapping methods.

Support for Lombok, direct field access and much more: MapStruct 1.2.0.Beta1 is out

Mon, 20 Feb 2017 00:00:00 +0000

It’ my pleasure to announce the first Beta release of MapStruct 1.2.

The new release comes with a whole lot of new functionality, e.g.:

MapStruct can now be used together with Project Lombok
Support for Java 8 streams
Mappings based on public fields (i.e. you can write DTOs without getters and setters)
Automatic creation of sub-mapping methods
Mapping methods can take “pass-through” context parameters, addressing different use cases like
Passing a locale, timezone or similar to custom mapping methods
Keeping track of processed nodes in circular object graphs
Target bean factory methods can access a mapping’s source parameter(s)

New Year, new Website!

Mon, 02 Jan 2017 00:00:00 +0000

The MapStruct team wishes a Happy New Year to all our users out there!

To start the new year fresh, we’ve given some love to our website. While its looks only slightly changed, its inner workings have been overhauled from ground up. It’s driven by Hugo now, a static website generator written in Go which is very popular these days.

MapStruct 1.1.0.Final seen in the wild!

Tue, 22 Nov 2016 00:00:00 +0000

I’m more than thrilled to report that MapStruct 1.1 Final has been spotted in the wild! We grew that puppy for almost one year since the announcement of MapStruct 1.0, so it was about time to let it go and put a final release into your hands.

Besides a plethora of bug fixes the 1.1 release adds many new features which should be very welcome to users of MapStruct 1.0:

Nested target properties
@ValueMapping annotation for enum mappings
@Named annotation for simple string based mapping qualifiers
Support for custom hasXyz() methods to check the presence of source properties instead of null checks
Extended support of java.text.NumberFormat for Number types to String mapping
OSGi support
New built-in conversions around date/time type

MapStruct 1.1.0.CR2 is out

Tue, 08 Nov 2016 00:00:00 +0000

It’s my pleasure to announce the second candidate release of MapStruct 1.1!

This release fixes several bugs discovered in the first CR but also adds some new built-in conversions around date/time types (e.g. from/to the java.sql.* types and between java.time.LocalDate and java.util.Date). Normally, we wouldn’t add new functionality during the CR phase, but as these conversions have been contributed by community members (kudos to you!), we thought it’d be nice to put them into a release as soon as possible.

MapStruct 1.1.0.CR1 released

Wed, 07 Sep 2016 00:00:00 +0000

MapStruct 1.1.0.CR1 consolodates the functionality introduced in the preceeding MapStruct 1.1.0 Beta releases. A number of bugs were solved:

Automatic generation of an iterable mapping methods where the property selection is based on a qualfier.
Collection source getter null check to avoid NullPointExceptions.
Missing imports for generic types in collections in generated methods.
Removing redundant code from generated code when using nested source properties.
Optimisation when using enum constant (using an enum constant instead of a String conversion).
Fixing order for dependsOn.
Fixing an issue introduced 1.1.0.Beta2 that causes problems for the @MappingTarget in combination with @InheritInverseConfiguration

MapStruct 1.1.0.Beta2 released

Fri, 22 Jul 2016 00:00:00 +0000

It has been a while since the latest release of MapStruct. Via our mailing list, issue list and other channels we have received valuable feedback. We have tried to incorporate some of that feedback into a number of new features.

MapStruct 1.1.0.Beta2 introduces a number of popular requested features, like source presence check and nested target properties.

MapStruct 1.1.0.Beta1 released

Wed, 16 Mar 2016 00:00:00 +0000

It has been four months since the release of the first final version of MapStruct. We’ve received a lot of great feedback and noticed a substantial increase of interest in the project. A couple of bugs were reported that we intend to fix with MapStruct 1.1 while also working on new features.

Today we release MapStruct 1.1.0.Beta1, containing fixes for most of the user-reported bugs. But we’ve also added some improvements and prepared for new features:

The new annotation @ValueMapping is introduced to be used for enum mappings. Previously, you would have used @Mapping for this, but we found a separate annotation makes things more clear and puts us in a better position for some upcoming features. The usage of @Mapping for enum mappings now triggers a deprecation warning and asks you to use @ValueMapping instead.
The new annotation @Named is a predefined @Qualifier that can be used when creating a custom qualifier annotation seems too inconvenient.
Handling of types with generically typed properties has been improved, so that you can now declare something like SearchResult<VesselDto> vesselSearchResultToDto(SearchResult<Vessel> vessel).
The preferred way of configuring the annotation processor in Maven projects has been updated to leverage the latest maven-compiler-plugin version’s annotationProcessorPaths option, which makes the configuration a bit more smooth. Check the updated documentation.

Reference Guide brushed up and converted to AsciiDoc

Sun, 14 Feb 2016 00:00:00 +0000

While we pride ourselves on providing a comprehensive and detailed documentation, the MapStruct reference guide grew out of form a bit over time. To name just one issue, readability wasn’t great on smaller screen sizes. All that’s history now, the reference guide has been converted into the AsciiDoc format, which makes the documentation much easier to maintain and allows for several publishing options using the fantastic AsciiDoctor tool. The guide is provided in two formats now: HTML and as PDF.

MapStruct 1.0 Final released

Wed, 25 Nov 2015 00:00:00 +0000

It’s with great pleasure and excitement that I announce the final release of MapStruct 1.0! MapStruct is a source code generator for efficient, type-safe mappings between Java bean types, based on annotated interface definitions. It works in your command line builds (e.g. via Maven or Gradle) as well as your favourite IDE. The advantages of this approach are manifold: Great performance: Plain method invocations only, no use of reflection Compile-time type safety: Only objects and attributes actually mapping to each other can be mapped, no accidental mapping of an order entity into a customer DTO etc.

MapStruct 1.0.0.CR2 released

Thu, 27 Aug 2015 00:00:00 +0000

It is my pleasure to announce the second candidate release of MapStruct 1.0! With this release, we’re fixing several bugs that showed up after our first candidate release. But we also received some great new feature contributions from the community that we wanted to include in our 1.0 release, so we decided to build this second candidate release before calling it a final. Highlights of this release are: Configure package and class name for the generated mapper implementations.

MapStruct 1.0.0.CR1 has landed

Thu, 11 Jun 2015 00:00:00 +0000

I am very happy to announce the first candidate release of MapStruct 1.0! As we are approach MapStruct 1.0, this release is primarily focused on ironing out remaining glitches and fixing bugs. But there are also some new features: A new SPI for discovering property accessors not adhering to the JavaBeans convention The decorator feature can now also be used with Spring Support for before- and after-mapping lifecycle hooks The complete list of 24 closed issues can be found in the change log.

Array mappings, configuration inheritance: MapStruct 1.0.0.Beta4 released

Thu, 05 Mar 2015 00:00:00 +0000

The MapStruct community proudly announces the release of MapStruct 1.0.0.Beta4! The new release provides support for mapping arrays of Java beans, re-use of mapping configurations via a brand-new inheritance mechanism and ordered setter invocations on the target side. We also fixed quite a few bugs. You can find the complete list of 48 issues in the change log. When upgrading from a previous Beta release, please check out the migration notes for changes which may affect existing applications.

MapStruct 1.0.0.Beta3 is out with nested properties, qualifiers and more

Sun, 30 Nov 2014 00:00:00 +0000

I’m delighted to announce the release of MapStruct 1.0.0.Beta3. This version brings the long awaited support for mapping nested source properties, built-in mappings for Java 8 date/time types, fine-grained selection of mapping methods via qualifiers and much more. You can find the complete list of a whopping 46 closed issues here. Note that existing applications using MapStruct need to adapt to some changes we had to do in order to iron out some glitches from the previous beta releases.

Support for Java 8, JodaTime and more: MapStruct 1.0.0.Beta2 released

Wed, 02 Jul 2014 00:00:00 +0000

It’s my great pleasure to announce the release of MapStruct 1.0.0.Beta2. Amongst the new features is initial support for Java 8, built-in mappings for the types of the Joda-Time date and time API, flexible mapping customization via inline Java expressions and much more. Distribution bundles (ZIP, TAR.GZ) are available on SourceForge. Alternatively, you can obtain the dependencies from Maven Central. The GAV coordinates are: org.mapstruct:mapstruct:1.0.0.Beta2 for the annotation JAR, to be used with Java <= 7 org.

MapStruct 1.0.0.Beta1 is out with JAXB support, custom factories, decorators and more

Wed, 05 Mar 2014 00:00:00 +0000

The MapStruct team is very happy to announce the release of MapStruct 1.0.0.Beta1. One core part of the new release is comprehensive support for mapping JAXB types with JAXBElement and XmlGregorianCalendar attributes. It’s possible now to plug in custom factories for creating objects, which also supports the JAXB use case as we’ll see in a minute. Further new features are the support for creating mappers from abstract classes (instead of interfaces) and decorators for customizing the behavior of mapping methods.

MapStruct 1.0.0.Alpha2 has landed!

Thu, 28 Nov 2013 00:00:00 +0000

It is my great pleasure to announce the release of MapStruct 1.0.0.Alpha2. This took us a bit longer than expected, but the new release offers quite a few exciting new features we hope you’ll enjoy. The JARs have already been synched to Maven Central. The coordinates are: org.mapstruct:mapstruct:1.0.0.Alpha2 for the annotation JAR and org.mapstruct:mapstruct-processor:1.0.0.Alpha2 for the annotation processor. Alternatively you can get a distribution bundle from SourceForge. Beside several new mapping features (e.

Using MapStruct with Gradle

Mon, 08 Jul 2013 00:00:00 +0000

Update Feb. 26, 2017: Since writing this post, usage of annotation processors with Gradle got much easier and the set-up described in the following isn’t required anymore. The example project on GitHub has been updated accordingly. You work with Gradle to build your application and would like to make use of MapStruct to generate mappings between different representations of your model? Then read on to learn how to make MapStruct work with the Groovy based build tool.

Announcing MapStruct

Mon, 03 Jun 2013 00:00:00 +0000

It is my pleasure to announce the first release of the MapStruct project! MapStruct is a code generator which simplifies the implementation of mappings between Java bean types by generating mapping code at compile time, following a convention-over-configuration approach. The problem In multi-layered applications there is often the need to map between objects from diffent models. Examples include the conversion from JPA entities into data transfer or view objects and the mapping between the internal model of an application and external-facing representations such as the types of a web service facade.

mapstruct.org has landed!

Wed, 22 May 2013 00:00:00 +0000

MapStruct has now its own web site, mapstruct.org!