119 Improvement: Customize class name and bean name for ConverterRegistrationConfiguration

Added documentation
Fixed generated import element to have simple name instead of full name(uncovered by unit test)

Author: denis-simonov-ge

docs/src/docs/asciidoc/chapter-3-mapper-as-converter.asciidoc

@@ -170,6 +170,70 @@ public class ConversionServiceAdapterIntegrationTest {
 ----
 ====
 
+[[converterRegistrationConfigurationClassName]]
+=== Modifying the name for the generated converter registration configuration class
+
+By default, the converter registration configuration class will have name `ConverterRegistrationConfiguration`.
+If you wish to change this, you can do so by setting the property `converterRegistrationConfigurationClassName`:
+
+====
+[source,java,linenums]
+[subs="verbatim,attributes"]
+----
+@MapperConfig(componentModel = "spring")
+@SpringMapperConfig(
+        converterRegistrationConfigurationClassName = "MyConfiguration",
+        generateConverterScan = true)
+public interface MapstructConfig {}
+----
+====
+
+This changes the generated class name to be the property's value:
+
+====
+[source,java,linenums]
+[subs="verbatim,attributes"]
+----
+@Configuration
+class MyConfiguration {
+  private final ConfigurableConversionService conversionService;
+
+  private final List<Converter<?, ?>> converters;
+
+  MyConfiguration(
+      @Qualifier("conversionService") final ConfigurableConversionService conversionService,
+      final List<Converter<?, ?>> converters) {
+    this.conversionService = conversionService;
+    this.converters = converters;
+  }
+
+  @PostConstruct
+  void registerConverters() {
+    converters.forEach(conversionService::addConverter);
+  }
+}
+----
+====
+
+Also this changes reference to converter registration configuration class from generated ConverterScan class:
+
+====
+[source,java,linenums]
+[subs="verbatim,attributes"]
+----
+@ComponentScan
+@Target(TYPE)
+@Import(MyConfiguration.class)
+@Documented
+@Retention(RUNTIME)
+@Repeatable(ConverterScans.class)
+public @interface ConverterScan {
+  ...
+}
+----
+====
+
+
 [[adapterMethodName]]
 === Modifying the name for the generated adapter method
 

examples/custom-conversion-service-bean/src/main/java/org/mapstruct/extensions/spring/example/custombean/MapperSpringConfig.java

@@ -4,6 +4,6 @@
 import org.mapstruct.extensions.spring.SpringMapperConfig;
 
 @MapperConfig(componentModel = "spring", uses = ConversionServiceAdapter.class)
-@SpringMapperConfig(conversionServiceBeanName = "myConversionService")
+@SpringMapperConfig(conversionServiceBeanName = "myConversionService", generateConverterScan = true)
 public interface MapperSpringConfig {
 }

extensions/src/main/java/org/mapstruct/extensions/spring/converter/ConversionServiceAdapterDescriptor.java

@@ -69,6 +69,10 @@ public ConversionServiceAdapterDescriptor configurationClassName(
     return this;
   }
 
+  public String getConfigurationClassName() {
+    return configurationClassName;
+  }
+
   public boolean isGenerateConverterScan() {
     return generateConverterScan;
   }

extensions/src/main/java/org/mapstruct/extensions/spring/converter/ConverterScanGenerator.java

@@ -41,7 +41,7 @@ protected TypeSpec createMainTypeSpec(final ConversionServiceAdapterDescriptor d
         TypeSpec.annotationBuilder(descriptor.getConverterScanClassName()).addModifiers(PUBLIC);
     final var importAnnotationSpec =
             AnnotationSpec.builder(IMPORT_CLASS_NAME)
-                    .addMember("value", "$L", descriptor.getConverterRegistrationConfigurationClassName() + ".class")
+                    .addMember("value", "$L", descriptor.getConfigurationClassName() + ".class")
                     .build();
     Optional.ofNullable(buildGeneratedAnnotationSpec())
         .ifPresent(converterScanClassTypeSpecBuilder::addAnnotation);