From 82b844c5cc1a982c3c49d1d537c80d608a6b928c Mon Sep 17 00:00:00 2001 From: Raimund Klein <770876+Chessray@users.noreply.github.com> Date: Sat, 15 Nov 2025 23:10:40 +0000 Subject: [PATCH 1/2] Spring Extensions 2.0.0 --- ...struct-spring-extensions-2-0-0-released.md | 60 + data/releases/spring-extensions.toml | 2 +- .../api/annotations/allclasses-index.html | 194 +- .../api/annotations/allclasses.html | 33 - .../api/annotations/allpackages-index.html | 158 +- .../api/annotations/constant-values.html | 192 +- .../api/annotations/deprecated-list.html | 144 - .../api/annotations/help-doc.html | 314 +- .../api/annotations/index-all.html | 267 +- .../api/annotations/index.html | 14 +- .../api/annotations/jquery-ui.overrides.css | 42 +- .../jquery/external/jquery/jquery.js | 10872 --------------- .../annotations/jquery/jquery-3.7.1.min.js | 2 - .../jquery/jszip-utils/dist/jszip-utils-ie.js | 56 - .../jszip-utils/dist/jszip-utils-ie.min.js | 10 - .../jquery/jszip-utils/dist/jszip-utils.js | 118 - .../jszip-utils/dist/jszip-utils.min.js | 10 - .../annotations/jquery/jszip/dist/jszip.js | 11370 ---------------- .../jquery/jszip/dist/jszip.min.js | 13 - .../annotations/legal/ADDITIONAL_LICENSE_INFO | 37 - .../api/annotations/legal/ASSEMBLY_EXCEPTION | 27 - .../api/annotations/legal/COPYRIGHT | 69 + .../api/annotations/legal/LICENSE | 465 +- .../api/annotations/legal/jquery.md | 50 +- .../api/annotations/legal/jszip.md | 653 - .../api/annotations/legal/pako.md | 45 - .../api/annotations/member-search-index.js | 2 +- .../api/annotations/member-search-index.zip | Bin 443 -> 0 bytes .../api/annotations/module-search-index.js | 1 + .../extensions/spring/AdapterMethodName.html | 268 +- .../spring/DelegatingConverter.html | 187 +- .../extensions/spring/ExternalConversion.html | 344 +- .../extensions/spring/SpringMapperConfig.html | 631 +- .../extensions/spring/package-summary.html | 210 +- .../extensions/spring/package-tree.html | 150 +- .../api/annotations/overview-tree.html | 152 +- .../api/annotations/package-search-index.js | 2 +- .../api/annotations/package-search-index.zip | Bin 247 -> 0 bytes .../script-dir/jquery-3.6.1.min.js | 2 + .../{jquery => script-dir}/jquery-ui.min.css | 0 .../{jquery => script-dir}/jquery-ui.min.js | 0 .../api/annotations/script.js | 225 +- .../api/annotations/search.js | 444 +- .../api/annotations/stylesheet.css | 780 +- .../api/annotations/tag-search-index.js | 1 + .../api/annotations/type-search-index.js | 2 +- .../api/annotations/type-search-index.zip | Bin 301 -> 0 bytes .../api/extensions/allclasses-index.html | 238 +- .../api/extensions/allclasses.html | 43 - .../api/extensions/allpackages-index.html | 158 +- .../api/extensions/constant-values.html | 298 +- .../api/extensions/deprecated-list.html | 144 - .../api/extensions/help-doc.html | 314 +- .../api/extensions/index-all.html | 457 +- .../api/extensions/index.html | 14 +- .../api/extensions/jquery-ui.overrides.css | 42 +- .../jquery/external/jquery/jquery.js | 10872 --------------- .../api/extensions/jquery/jquery-3.7.1.min.js | 2 - .../jquery/jszip-utils/dist/jszip-utils-ie.js | 56 - .../jszip-utils/dist/jszip-utils-ie.min.js | 10 - .../jquery/jszip-utils/dist/jszip-utils.js | 118 - .../jszip-utils/dist/jszip-utils.min.js | 10 - .../api/extensions/jquery/jszip/dist/jszip.js | 11370 ---------------- .../extensions/jquery/jszip/dist/jszip.min.js | 13 - .../extensions/legal/ADDITIONAL_LICENSE_INFO | 37 - .../api/extensions/legal/ASSEMBLY_EXCEPTION | 27 - .../api/extensions/legal/COPYRIGHT | 69 + .../api/extensions/legal/LICENSE | 465 +- .../api/extensions/legal/jquery.md | 50 +- .../api/extensions/legal/jszip.md | 653 - .../api/extensions/legal/pako.md | 45 - .../api/extensions/member-search-index.js | 2 +- .../api/extensions/member-search-index.zip | Bin 1544 -> 0 bytes .../api/extensions/module-search-index.js | 1 + .../converter/AdapterRelatedGenerator.html | 418 +- .../ConversionServiceAdapterDescriptor.html | 744 +- .../ConversionServiceAdapterGenerator.html | 408 +- .../converter/ConverterMapperProcessor.html | 576 +- ...terRegistrationConfigurationGenerator.html | 408 +- .../converter/ConverterScanGenerator.html | 433 +- .../converter/ConverterScansGenerator.html | 433 +- .../DelegatingConverterDescriptor.html | 413 +- .../DelegatingConverterGenerator.html | 391 +- .../spring/converter/FromToMapping.html | 505 +- .../spring/converter/Generator.html | 799 +- .../GeneratorInitializingProcessor.html | 467 +- .../spring/converter/ModelElementUtils.html | 291 +- .../spring/converter/TypeNameUtils.html | 337 +- .../spring/converter/package-summary.html | 254 +- .../spring/converter/package-tree.html | 172 +- .../api/extensions/overview-tree.html | 174 +- .../api/extensions/package-search-index.js | 2 +- .../api/extensions/package-search-index.zip | Bin 256 -> 0 bytes .../extensions/script-dir/jquery-3.6.1.min.js | 2 + .../{jquery => script-dir}/jquery-ui.min.css | 0 .../{jquery => script-dir}/jquery-ui.min.js | 0 .../api/extensions/script.js | 225 +- .../api/extensions/search.js | 444 +- .../api/extensions/stylesheet.css | 780 +- .../api/extensions/tag-search-index.js | 1 + .../api/extensions/type-search-index.js | 2 +- .../api/extensions/type-search-index.zip | Bin 402 -> 0 bytes .../api/test-extensions/allclasses-index.html | 166 +- .../api/test-extensions/allclasses.html | 31 - .../test-extensions/allpackages-index.html | 158 +- .../api/test-extensions/constant-values.html | 146 - .../api/test-extensions/deprecated-list.html | 144 - .../api/test-extensions/help-doc.html | 311 +- .../api/test-extensions/index-all.html | 239 +- .../api/test-extensions/index.html | 14 +- .../test-extensions/jquery-ui.overrides.css | 42 +- .../jquery/external/jquery/jquery.js | 10872 --------------- .../jquery/jquery-3.7.1.min.js | 2 - .../jquery/jszip-utils/dist/jszip-utils-ie.js | 56 - .../jszip-utils/dist/jszip-utils-ie.min.js | 10 - .../jquery/jszip-utils/dist/jszip-utils.js | 118 - .../jszip-utils/dist/jszip-utils.min.js | 10 - .../jquery/jszip/dist/jszip.js | 11370 ---------------- .../jquery/jszip/dist/jszip.min.js | 13 - .../legal/ADDITIONAL_LICENSE_INFO | 37 - .../test-extensions/legal/ASSEMBLY_EXCEPTION | 27 - .../api/test-extensions/legal/COPYRIGHT | 69 + .../api/test-extensions/legal/LICENSE | 465 +- .../api/test-extensions/legal/jquery.md | 50 +- .../api/test-extensions/legal/jszip.md | 653 - .../api/test-extensions/legal/pako.md | 45 - .../test-extensions/member-search-index.js | 2 +- .../test-extensions/member-search-index.zip | Bin 324 -> 0 bytes .../test-extensions/module-search-index.js | 1 + .../extensions/spring/test/ConverterScan.html | 540 +- .../spring/test/ConverterScans.html | 260 +- .../spring/test/package-summary.html | 182 +- .../extensions/spring/test/package-tree.html | 146 +- .../api/test-extensions/overview-tree.html | 148 +- .../test-extensions/package-search-index.js | 2 +- .../test-extensions/package-search-index.zip | Bin 251 -> 0 bytes .../script-dir/jquery-3.6.1.min.js | 2 + .../{jquery => script-dir}/jquery-ui.min.css | 0 .../{jquery => script-dir}/jquery-ui.min.js | 0 .../api/test-extensions/script.js | 225 +- .../api/test-extensions/search.js | 444 +- .../api/test-extensions/stylesheet.css | 780 +- .../api/test-extensions/tag-search-index.js | 1 + .../api/test-extensions/type-search-index.js | 2 +- .../api/test-extensions/type-search-index.zip | Bin 264 -> 0 bytes .../reference/html/index.html | 20 +- 146 files changed, 7127 insertions(+), 83481 deletions(-) create mode 100644 content/news/2025-11-15-mapstruct-spring-extensions-2-0-0-released.md delete mode 100644 static/documentation/spring-extensions/api/annotations/allclasses.html delete mode 100644 static/documentation/spring-extensions/api/annotations/deprecated-list.html delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/external/jquery/jquery.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jquery-3.7.1.min.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jszip-utils/dist/jszip-utils-ie.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jszip-utils/dist/jszip-utils-ie.min.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jszip-utils/dist/jszip-utils.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jszip-utils/dist/jszip-utils.min.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jszip/dist/jszip.js delete mode 100644 static/documentation/spring-extensions/api/annotations/jquery/jszip/dist/jszip.min.js delete mode 100644 static/documentation/spring-extensions/api/annotations/legal/ADDITIONAL_LICENSE_INFO delete mode 100644 static/documentation/spring-extensions/api/annotations/legal/ASSEMBLY_EXCEPTION create mode 100644 static/documentation/spring-extensions/api/annotations/legal/COPYRIGHT delete mode 100644 static/documentation/spring-extensions/api/annotations/legal/jszip.md delete mode 100644 static/documentation/spring-extensions/api/annotations/legal/pako.md delete mode 100644 static/documentation/spring-extensions/api/annotations/member-search-index.zip create mode 100644 static/documentation/spring-extensions/api/annotations/module-search-index.js delete mode 100644 static/documentation/spring-extensions/api/annotations/package-search-index.zip create mode 100644 static/documentation/spring-extensions/api/annotations/script-dir/jquery-3.6.1.min.js rename static/documentation/spring-extensions/api/annotations/{jquery => script-dir}/jquery-ui.min.css (100%) rename static/documentation/spring-extensions/api/annotations/{jquery => script-dir}/jquery-ui.min.js (100%) create mode 100644 static/documentation/spring-extensions/api/annotations/tag-search-index.js delete mode 100644 static/documentation/spring-extensions/api/annotations/type-search-index.zip delete mode 100644 static/documentation/spring-extensions/api/extensions/allclasses.html delete mode 100644 static/documentation/spring-extensions/api/extensions/deprecated-list.html delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/external/jquery/jquery.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jquery-3.7.1.min.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jszip-utils/dist/jszip-utils-ie.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jszip-utils/dist/jszip-utils-ie.min.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jszip-utils/dist/jszip-utils.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jszip-utils/dist/jszip-utils.min.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jszip/dist/jszip.js delete mode 100644 static/documentation/spring-extensions/api/extensions/jquery/jszip/dist/jszip.min.js delete mode 100644 static/documentation/spring-extensions/api/extensions/legal/ADDITIONAL_LICENSE_INFO delete mode 100644 static/documentation/spring-extensions/api/extensions/legal/ASSEMBLY_EXCEPTION create mode 100644 static/documentation/spring-extensions/api/extensions/legal/COPYRIGHT delete mode 100644 static/documentation/spring-extensions/api/extensions/legal/jszip.md delete mode 100644 static/documentation/spring-extensions/api/extensions/legal/pako.md delete mode 100644 static/documentation/spring-extensions/api/extensions/member-search-index.zip create mode 100644 static/documentation/spring-extensions/api/extensions/module-search-index.js delete mode 100644 static/documentation/spring-extensions/api/extensions/package-search-index.zip create mode 100644 static/documentation/spring-extensions/api/extensions/script-dir/jquery-3.6.1.min.js rename static/documentation/spring-extensions/api/extensions/{jquery => script-dir}/jquery-ui.min.css (100%) rename static/documentation/spring-extensions/api/extensions/{jquery => script-dir}/jquery-ui.min.js (100%) create mode 100644 static/documentation/spring-extensions/api/extensions/tag-search-index.js delete mode 100644 static/documentation/spring-extensions/api/extensions/type-search-index.zip delete mode 100644 static/documentation/spring-extensions/api/test-extensions/allclasses.html delete mode 100644 static/documentation/spring-extensions/api/test-extensions/constant-values.html delete mode 100644 static/documentation/spring-extensions/api/test-extensions/deprecated-list.html delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/external/jquery/jquery.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-3.7.1.min.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils-ie.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils-ie.min.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils.min.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip/dist/jszip.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip/dist/jszip.min.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/legal/ADDITIONAL_LICENSE_INFO delete mode 100644 static/documentation/spring-extensions/api/test-extensions/legal/ASSEMBLY_EXCEPTION create mode 100644 static/documentation/spring-extensions/api/test-extensions/legal/COPYRIGHT delete mode 100644 static/documentation/spring-extensions/api/test-extensions/legal/jszip.md delete mode 100644 static/documentation/spring-extensions/api/test-extensions/legal/pako.md delete mode 100644 static/documentation/spring-extensions/api/test-extensions/member-search-index.zip create mode 100644 static/documentation/spring-extensions/api/test-extensions/module-search-index.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/package-search-index.zip create mode 100644 static/documentation/spring-extensions/api/test-extensions/script-dir/jquery-3.6.1.min.js rename static/documentation/spring-extensions/api/test-extensions/{jquery => script-dir}/jquery-ui.min.css (100%) rename static/documentation/spring-extensions/api/test-extensions/{jquery => script-dir}/jquery-ui.min.js (100%) create mode 100644 static/documentation/spring-extensions/api/test-extensions/tag-search-index.js delete mode 100644 static/documentation/spring-extensions/api/test-extensions/type-search-index.zip diff --git a/content/news/2025-11-15-mapstruct-spring-extensions-2-0-0-released.md b/content/news/2025-11-15-mapstruct-spring-extensions-2-0-0-released.md new file mode 100644 index 000000000..70b5fc08c --- /dev/null +++ b/content/news/2025-11-15-mapstruct-spring-extensions-2-0-0-released.md @@ -0,0 +1,60 @@ +--- +title: "MapStruct Spring Extensions 1.1.3 released" +author: Raimund Klein +date: "2025-03-14" +tags: [ release, news ] +--- + +It is my pleasure to announce the next official release of MapStruct Spring Extensions. +What started out as a [StackOverflow question](https://stackoverflow.com/q/58081224/3361467) turned into its +own [(sub-)project](https://github.com/mapstruct/mapstruct-spring-extensions) 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](https://docs.spring.io/spring-framework/docs/current/reference/html/core.html#core-convert-ConversionService-API) +that in turn can be added to any Mapper's `uses` attribute. See +the [examples](https://github.com/mapstruct/mapstruct-spring-extensions/tree/master/examples) for details. + + + +### Thanks + +Thanks to [Sjaak Derksen](https://github.com/sjaakd) for suggesting this solution +and [Filip Hrisafov](https://github.com/filiphr) for opening the community project. +Also thanks +to [Jeff Schnitzer](https://github.com/stickfigure), [Jesse Bonzo](https://github.com/jbonzohln), [Cosimo Damiano Prete](https://github.com/cdprete), [Daniel Shiplett](https://github.com/danielshiplett), [Alexey](https://github.com/PRIESt512), [Olivier Boudet](https://github.com/olivierboudet), [John Kelly](https://github.com/postalservice14), [Myat Min](https://github.com/myatmin), [Hypercube Software](https://github.com/hypercube-software), [coding-guo](https://github.com/coding-guo), [freund17](https://github.com/freund17), [Joose Haverinen](https://github.com/joosehav), [pw-lehre](https://github.com/pw-lehre), [simonovdenis](https://github.com/simonovdenis), +and [George Noble](https://github.com/giorgioscia) for their suggestions and fixes in previous releases. +If you feel like there's something missing in MapStruct which could make the Spring experience any smoother, please get +involved! + +Also, if your favourite library or framework could use some tweaking with regard to MapStruct, contact us. + +Happy coding with MapStruct Spring Extensions! + +### Download + +You can fetch the release from Maven Central using the following GAV coordinates: + +* Annotation + JAR: [org.mapstruct.extensions.spring:mapstruct-spring-annotations:2.0.0](http://search.maven.org/#artifactdetails|org.mapstruct.extensions.spring|mapstruct-spring-annotations|2.0.0|jar) +* Annotation processor + JAR: [org.mapstruct.extensions.spring:mapstruct-spring-extensions:2.0.0](http://search.maven.org/#artifactdetails|org.mapstruct.extensions.spring|mapstruct-spring-extensions|2.0.0|jar) +* Test Extensions with Converter Scan + JAR: [org.mapstruct.extensions.spring:mapstruct-spring-extensions:2.0.0](http://search.maven.org/#artifactdetails|org.mapstruct.extensions.spring|mapstruct-spring-test-extensions|2.0.0|jar) + +Alternatively, you can get ZIP and TAR.GZ distribution bundles - containing all the JARs, documentation +etc. - [from GitHub](https://github.com/mapstruct/mapstruct-spring-extensions/releases/tag/v2.0.0). + +If you run into any trouble or would like to report a bug, feature request or similar, use the following channels to get +in touch: + +* Get help in our [Gitter room](https://gitter.im/mapstruct/mapstruct-users) or at + the [mapstruct-users](https://groups.google.com/forum/?fromgroups#!forum/mapstruct-users) group +* Report bugs and feature requests via + the [issue tracker](https://github.com/mapstruct/mapstruct-spring-extensions/issues) +* Follow [@GetMapStruct](https://twitter.com/GetMapStruct) on Twitter diff --git a/data/releases/spring-extensions.toml b/data/releases/spring-extensions.toml index fedc12dc5..d50f3b963 100644 --- a/data/releases/spring-extensions.toml +++ b/data/releases/spring-extensions.toml @@ -1,5 +1,5 @@ name = "Spring Extensions" versionRef = "spring-extensions" order = 450 -releaseDate = 2025-03-14 +releaseDate = 2025-11-15 spring = true diff --git a/static/documentation/spring-extensions/api/annotations/allclasses-index.html b/static/documentation/spring-extensions/api/annotations/allclasses-index.html index 25ceb54bc..09bbcfc97 100644 --- a/static/documentation/spring-extensions/api/annotations/allclasses-index.html +++ b/static/documentation/spring-extensions/api/annotations/allclasses-index.html @@ -1,182 +1,80 @@ -
- -