MapStruct

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 ... [More] 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... [Less]

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 ... [More] 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. Please check out the change log for the complete list of closed issues. Also take a look at the migration notes as... [Less]

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 ... [More] 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 The list of closed issues can be found in the change... [Less]

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. ... [More] MapStruct 1.1.0.Beta2 introduces a number of popular requested features, like source presence check and nested target properties. Today we release MapStruct 1.1.0.Beta2, containing fixes for most of the user-reported bugs: Mapping of nested target properties. Support of using hasXYZ presence checker methods instead of null checks on the source side of bean mappings. The presence checker naming convention can be overidden by providing a... [Less]

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 ... [More] 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... [Less]

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 ... [More] 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. The actual contents is largely unchanged, but we moved some sections around in order to reduce the number of chapters to a... [Less]

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 ... [More] 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. Self-contained code: no runtime dependencies Early validation and fast... [Less]

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 ... [More] 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. Define default values for target properties in case the source property is null. The decorator feature now fully works with Spring and JSR 330 and the... [Less]

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 ... [More] 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. A big thank you to everyone contributing to this release: Sjaak Derksen, Andreas Gudian, Christian Schuster, Paul Strugnell and Remko Plantenga! Download To fetch MapStruct... [Less]

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 ... [More] 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. One thing I’m especially excited about is the new MapStruct Eclipse plug-in which will give you an even better experience when using MapStruct within... [Less]