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 @@