From bb89010d3dccb5ae74d974ddbfe3997fb8f8d847 Mon Sep 17 00:00:00 2001 From: Raimund Klein <770876+Chessray@users.noreply.github.com> Date: Mon, 25 Sep 2023 14:41:57 +0100 Subject: [PATCH] Spring Extensions 1.1.0 documentation and news item (#145) --- content/documentation/reference-guide.md | 4 +- ...struct-spring-extensions-1-1-0-released.md | 61 + .../api/annotations/allclasses-index.html | 19 +- .../api/annotations/allclasses.html | 4 +- .../api/annotations/allpackages-index.html | 4 +- .../api/annotations/constant-values.html | 4 +- .../api/annotations/deprecated-list.html | 4 +- .../api/annotations/help-doc.html | 4 +- .../api/annotations/index-all.html | 51 +- .../api/annotations/index.html | 4 +- .../api/annotations/member-search-index.js | 2 +- .../api/annotations/member-search-index.zip | Bin 329 -> 366 bytes .../extensions/spring/AdapterMethodName.html | 246 + .../spring/DelegatingConverter.html | 185 + .../extensions/spring/ExternalConversion.html | 50 +- .../extensions/spring/SpringMapperConfig.html | 35 +- .../extensions/spring/package-summary.html | 17 +- .../extensions/spring/package-tree.html | 6 +- .../api/annotations/overview-tree.html | 6 +- .../api/annotations/package-search-index.zip | Bin 247 -> 247 bytes .../api/annotations/type-search-index.js | 2 +- .../api/annotations/type-search-index.zip | Bin 275 -> 301 bytes .../api/extensions/element-list | 1 - .../api/extensions/index-all.html | 252 - .../api/extensions/member-search-index.js | 1 - .../api/extensions/member-search-index.zip | Bin 658 -> 0 bytes .../converter/ConverterMapperProcessor.html | 84 +- .../converter/ConverterScanGenerator.html | 364 + .../converter/ConverterScansGenerator.html | 364 + .../DelegatingConverterGenerator.html | 332 + ...pterDescriptor.html => FromToMapping.html} | 106 +- .../spring/converter/ModelElementUtils.html | 263 + ...apterGenerator.html => TypeNameUtils.html} | 100 +- .../spring/converter/package-summary.html | 52 +- .../spring/converter/package-tree.html | 24 +- .../api/extensions/package-search-index.zip | Bin 256 -> 0 bytes .../api/extensions/type-search-index.js | 1 - .../api/extensions/type-search-index.zip | Bin 295 -> 0 bytes .../allclasses-index.html | 18 +- .../allclasses.html | 7 +- .../allpackages-index.html | 10 +- .../constant-values.html | 53 +- .../deprecated-list.html | 8 +- .../api/test-extensions/element-list | 1 + .../help-doc.html | 8 +- .../api/test-extensions/index-all.html | 228 + .../index.html | 12 +- .../jquery/external/jquery/jquery.js | 10598 ++++++++++++++ .../images/ui-bg_glass_55_fbf9ee_1x400.png | Bin 0 -> 335 bytes .../images/ui-bg_glass_65_dadada_1x400.png | Bin 0 -> 262 bytes .../images/ui-bg_glass_75_dadada_1x400.png | Bin 0 -> 262 bytes .../images/ui-bg_glass_75_e6e6e6_1x400.png | Bin 0 -> 262 bytes .../images/ui-bg_glass_95_fef1ec_1x400.png | Bin 0 -> 332 bytes .../ui-bg_highlight-soft_75_cccccc_1x100.png | Bin 0 -> 280 bytes .../jquery/images/ui-icons_222222_256x240.png | Bin 0 -> 6922 bytes .../jquery/images/ui-icons_2e83ff_256x240.png | Bin 0 -> 4549 bytes .../jquery/images/ui-icons_454545_256x240.png | Bin 0 -> 6992 bytes .../jquery/images/ui-icons_888888_256x240.png | Bin 0 -> 6999 bytes .../jquery/images/ui-icons_cd0a0a_256x240.png | Bin 0 -> 4549 bytes .../test-extensions/jquery/jquery-3.4.1.js | 10598 ++++++++++++++ .../api/test-extensions/jquery/jquery-ui.css | 582 + .../api/test-extensions/jquery/jquery-ui.js | 2659 ++++ .../test-extensions/jquery/jquery-ui.min.css | 7 + .../test-extensions/jquery/jquery-ui.min.js | 6 + .../jquery/jquery-ui.structure.css | 156 + .../jquery/jquery-ui.structure.min.css | 5 + .../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 | 11367 ++++++++++++++++ .../jquery/jszip/dist/jszip.min.js | 12 + .../test-extensions/member-search-index.js | 1 + .../test-extensions/member-search-index.zip | Bin 0 -> 324 bytes .../extensions/spring/test/ConverterScan.html | 472 + .../spring/test/ConverterScans.html | 238 + .../spring/test/package-summary.html | 165 + .../extensions/spring/test/package-tree.html | 151 + .../overview-tree.html | 21 +- .../package-search-index.js | 2 +- .../test-extensions/package-search-index.zip | Bin 0 -> 251 bytes .../resources/glass.png | Bin .../resources/x.png | Bin .../{extensions => test-extensions}/script.js | 0 .../{extensions => test-extensions}/search.js | 0 .../stylesheet.css | 0 .../api/test-extensions/type-search-index.js | 1 + .../api/test-extensions/type-search-index.zip | Bin 0 -> 264 bytes .../reference/html/index.html | 2176 +-- 89 files changed, 41012 insertions(+), 1396 deletions(-) create mode 100644 content/news/2023-09-25-mapstruct-spring-extensions-1-1-0-released.md create mode 100644 static/documentation/spring-extensions/api/annotations/org/mapstruct/extensions/spring/AdapterMethodName.html create mode 100644 static/documentation/spring-extensions/api/annotations/org/mapstruct/extensions/spring/DelegatingConverter.html delete mode 100644 static/documentation/spring-extensions/api/extensions/element-list delete mode 100644 static/documentation/spring-extensions/api/extensions/index-all.html delete mode 100644 static/documentation/spring-extensions/api/extensions/member-search-index.js delete mode 100644 static/documentation/spring-extensions/api/extensions/member-search-index.zip create mode 100644 static/documentation/spring-extensions/api/extensions/org/mapstruct/extensions/spring/converter/ConverterScanGenerator.html create mode 100644 static/documentation/spring-extensions/api/extensions/org/mapstruct/extensions/spring/converter/ConverterScansGenerator.html create mode 100644 static/documentation/spring-extensions/api/extensions/org/mapstruct/extensions/spring/converter/DelegatingConverterGenerator.html rename static/documentation/spring-extensions/api/extensions/org/mapstruct/extensions/spring/converter/{ConversionServiceAdapterDescriptor.html => FromToMapping.html} (65%) create mode 100644 static/documentation/spring-extensions/api/extensions/org/mapstruct/extensions/spring/converter/ModelElementUtils.html rename static/documentation/spring-extensions/api/extensions/org/mapstruct/extensions/spring/converter/{ConversionServiceAdapterGenerator.html => TypeNameUtils.html} (66%) delete mode 100644 static/documentation/spring-extensions/api/extensions/package-search-index.zip delete mode 100644 static/documentation/spring-extensions/api/extensions/type-search-index.js delete mode 100644 static/documentation/spring-extensions/api/extensions/type-search-index.zip rename static/documentation/spring-extensions/api/{extensions => test-extensions}/allclasses-index.html (79%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/allclasses.html (59%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/allpackages-index.html (91%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/constant-values.html (61%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/deprecated-list.html (92%) create mode 100644 static/documentation/spring-extensions/api/test-extensions/element-list rename static/documentation/spring-extensions/api/{extensions => test-extensions}/help-doc.html (96%) create mode 100644 static/documentation/spring-extensions/api/test-extensions/index-all.html rename static/documentation/spring-extensions/api/{extensions => test-extensions}/index.html (52%) create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/external/jquery/jquery.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-bg_glass_55_fbf9ee_1x400.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-bg_glass_65_dadada_1x400.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-bg_glass_75_dadada_1x400.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-bg_glass_75_e6e6e6_1x400.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-bg_glass_95_fef1ec_1x400.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-bg_highlight-soft_75_cccccc_1x100.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-icons_222222_256x240.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-icons_2e83ff_256x240.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-icons_454545_256x240.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-icons_888888_256x240.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/images/ui-icons_cd0a0a_256x240.png create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-3.4.1.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-ui.css create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-ui.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-ui.min.css create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-ui.min.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-ui.structure.css create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jquery-ui.structure.min.css create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils-ie.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils-ie.min.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip-utils/dist/jszip-utils.min.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip/dist/jszip.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/jquery/jszip/dist/jszip.min.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/member-search-index.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/member-search-index.zip create mode 100644 static/documentation/spring-extensions/api/test-extensions/org/mapstruct/extensions/spring/test/ConverterScan.html create mode 100644 static/documentation/spring-extensions/api/test-extensions/org/mapstruct/extensions/spring/test/ConverterScans.html create mode 100644 static/documentation/spring-extensions/api/test-extensions/org/mapstruct/extensions/spring/test/package-summary.html create mode 100644 static/documentation/spring-extensions/api/test-extensions/org/mapstruct/extensions/spring/test/package-tree.html rename static/documentation/spring-extensions/api/{extensions => test-extensions}/overview-tree.html (75%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/package-search-index.js (51%) create mode 100644 static/documentation/spring-extensions/api/test-extensions/package-search-index.zip rename static/documentation/spring-extensions/api/{extensions => test-extensions}/resources/glass.png (100%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/resources/x.png (100%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/script.js (100%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/search.js (100%) rename static/documentation/spring-extensions/api/{extensions => test-extensions}/stylesheet.css (100%) create mode 100644 static/documentation/spring-extensions/api/test-extensions/type-search-index.js create mode 100644 static/documentation/spring-extensions/api/test-extensions/type-search-index.zip diff --git a/content/documentation/reference-guide.md b/content/documentation/reference-guide.md index 823fd3d35..8eccc5601 100644 --- a/content/documentation/reference-guide.md +++ b/content/documentation/reference-guide.md @@ -16,10 +16,10 @@ parent = "Documentation" * API documentation: [JavaDoc](/documentation/stable/api/) * [Migration notes](https://github.com/mapstruct/mapstruct/releases/tag/1.5.5.Final) -**Spring Extensions** (August 8th 2023; latest milestone release) +**Spring Extensions** (September 25th 2023; latest milestone release) * Reference guide: [HTML](/documentation/spring-extensions/reference/html/) -* API documentation: [Annotations JavaDoc](/documentation/spring-extensions/api/annotations/) | [Extensions JavaDoc](/documentation/spring-extensions/api/extensions/) +* API documentation: [Annotations JavaDoc](/documentation/spring-extensions/api/annotations/) | [Extensions JavaDoc](/documentation/spring-extensions/api/extensions/) | [Test Extensions JavaDoc](/documentation/spring-extensions/api/test-extensions/) **1.4.2.Final** (January 31st 2021) diff --git a/content/news/2023-09-25-mapstruct-spring-extensions-1-1-0-released.md b/content/news/2023-09-25-mapstruct-spring-extensions-1-1-0-released.md new file mode 100644 index 000000000..874a8c659 --- /dev/null +++ b/content/news/2023-09-25-mapstruct-spring-extensions-1-1-0-released.md @@ -0,0 +1,61 @@ +--- +title: "MapStruct Spring Extensions 1.1.0 released" +author: Raimund Klein +date: "2023-09-25" +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: + +- New module `test-extensions` which contains a `@ConverterScan` annotation that greatly simplifies the writing of integration tests. Thanks to [Joose Haverinen](https://github.com/joosehav) for the suggestion. +- New annotation `@AdapterMethodName` which allows a developer to override the default name for generated adapter methods. Thanks to [pw-lehre](https://github.com/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](https://github.com/pw-lehre) for the idea. + +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 [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) +and [freund17](https://github.com/freund17) 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:1.1.0](http://search.maven.org/#artifactdetails|org.mapstruct.extensions.spring|mapstruct-spring-annotations|1.1.0|jar) +* Annotation processor + JAR: [org.mapstruct.extensions.spring:mapstruct-spring-extensions:1.1.0](http://search.maven.org/#artifactdetails|org.mapstruct.extensions.spring|mapstruct-spring-extensions|1.1.0|jar) +* Test Extensions with Converter Scan + JAR: [org.mapstruct.extensions.spring:mapstruct-spring-extensions:1.1.0](http://search.maven.org/#artifactdetails|org.mapstruct.extensions.spring|mapstruct-spring-test-extensions|1.1.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/v1.1.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/static/documentation/spring-extensions/api/annotations/allclasses-index.html b/static/documentation/spring-extensions/api/annotations/allclasses-index.html index 81b188ae6..38f8da531 100644 --- a/static/documentation/spring-extensions/api/annotations/allclasses-index.html +++ b/static/documentation/spring-extensions/api/annotations/allclasses-index.html @@ -3,7 +3,7 @@ -All Classes (annotations 1.0.2 API) +All Classes (annotations 1.1.0 API) @@ -20,7 +20,7 @@