MapperConfig (mapstruct-plus 1.4.8 API)

```
@Target(value=TYPE)
 @Retention(value=RUNTIME)
public @interface MapperConfig
```
在一个类或者接口上添加该注释，作为自动生成 Mapper 的配置类。在一个模块中，只能有一个有该注释的类。 Marks a class or interface as configuration source. There can be only one annotated type in each compiled module.

Author:

linpl

Optional Element Summary

Optional Elements
Modifier and Type	Optional Element and Description
`String`	`adapterClassName` 默认类名为：ConvertMapperAdapter
`String`	`adapterPackage` 默认包名为：io.github.linpeilie
`String`	`autoConfigPackage` MapStructPlus 所生成的配置类(AutoMapperConfig/AutoMapMapperConfig)包路径默认包路径为 io.github.linpeilie
`String`	`autoMapMapperConfigClassName` MapStructPlus 所生成的配置 Map 与对象转换的配置类名默认类名为 AutoMapMapperConfig
`String`	`autoMapperConfigClassName` MapStructPlus 所生成的配置类转换的配置类名默认类名为 AutoMapperConfig
`org.mapstruct.Builder`	`builder` 构造者模式配置，由于 mapstruct 和 lombok 和 builder 一起使用时，会丢失父类属性，这里默认改为关闭
`org.mapstruct.CollectionMappingStrategy`	`collectionMappingStrategy` The strategy to be applied when propagating the value of collection-typed properties.
`String`	`mapAdapterClassName` 默认类名为：MapConvertMapperAdapter
`String`	`mapperPackage` 所生成的 Mapper 接口的包
`Class<? extends Annotation>`	`mappingControl` Allows detailed control over the mapping process.
`org.mapstruct.NullValueCheckStrategy`	`nullValueCheckStrategy` Determines when to include a null check on the source property value of a bean mapping.
`org.mapstruct.NullValueMappingStrategy`	`nullValueIterableMappingStrategy` The strategy to be applied when `null` is passed as source argument value to an `IterableMapping`.
`org.mapstruct.NullValueMappingStrategy`	`nullValueMapMappingStrategy` The strategy to be applied when `null` is passed as source argument value to a `MapMapping`.
`org.mapstruct.NullValueMappingStrategy`	`nullValueMappingStrategy` 空对象的映射策略，默认返回 `null`
`org.mapstruct.NullValuePropertyMappingStrategy`	`nullValuePropertyMappingStrategy` 当属性值为 `null` 时应对的策略，默认设置为 `null`
`boolean`	`suppressTimestampInGenerated` Flag indicating whether the addition of a time stamp in the `@Generated` annotation should be suppressed.
`org.mapstruct.ReportingPolicy`	`typeConversionPolicy` How lossy (narrowing) conversion, for instance: long to integer should be reported.
`Class<? extends Exception>`	`unexpectedValueMappingException` Exception that should be thrown by the generated code if no mapping matches for enums.
`org.mapstruct.ReportingPolicy`	`unmappedSourcePolicy` 当来源类中没有对应属性时的策略，默认忽略
`org.mapstruct.ReportingPolicy`	`unmappedTargetPolicy` 当目标类中没有对应属性时的策略，默认忽略

- Element Detail
  - mapperPackage
```
public abstract String mapperPackage
```
    所生成的 Mapper 接口的包
    
    Returns:
    
    Mapper 接口自动生成后的包名，如果为空，则默认生成在要转换的类同包下
    
    Default:
    
    ""
- - unmappedSourcePolicy
```
public abstract org.mapstruct.ReportingPolicy unmappedSourcePolicy
```
    当来源类中没有对应属性时的策略，默认忽略
    
    Returns:
    
    ReportingPolicy
    
    Default:
    
    org.mapstruct.ReportingPolicy.IGNORE
- - unmappedTargetPolicy
```
public abstract org.mapstruct.ReportingPolicy unmappedTargetPolicy
```
    当目标类中没有对应属性时的策略，默认忽略
    
    Returns:
    
    ReportingPolicy
    
    Default:
    
    org.mapstruct.ReportingPolicy.IGNORE
- - typeConversionPolicy
```
public abstract org.mapstruct.ReportingPolicy typeConversionPolicy
```
    How lossy (narrowing) conversion, for instance: long to integer should be reported.
    
    Returns:
    
    The reporting policy for type conversion.
    
    Since:
    
    1.4.2
    
    Default:
    
    org.mapstruct.ReportingPolicy.IGNORE
- - collectionMappingStrategy
```
public abstract org.mapstruct.CollectionMappingStrategy collectionMappingStrategy
```
    The strategy to be applied when propagating the value of collection-typed properties. By default, only JavaBeans accessor methods (setters or getters) will be used, but it is also possible to invoke a corresponding adder method for each element of the source collection (e.g. orderDto.addOrderLine()).
    
    Returns:
    
    The strategy applied when propagating the value of collection-typed properties.
    
    Since:
    
    1.4.2
    
    Default:
    
    org.mapstruct.CollectionMappingStrategy.ACCESSOR_ONLY
- - nullValueMappingStrategy
```
public abstract org.mapstruct.NullValueMappingStrategy nullValueMappingStrategy
```
    空对象的映射策略，默认返回 null
    
    Returns:
    
    NullValueMappingStrategy
    
    Default:
    
    org.mapstruct.NullValueMappingStrategy.RETURN_NULL
- - nullValueIterableMappingStrategy
```
public abstract org.mapstruct.NullValueMappingStrategy nullValueIterableMappingStrategy
```
    The strategy to be applied when null is passed as source argument value to an IterableMapping. If no strategy is configured, the strategy given via nullValueMappingStrategy() will be applied, using NullValueMappingStrategy.RETURN_NULL by default.
    
    Returns:
    
    The strategy to be applied when null is passed as source value to an IterableMapping.
    
    Since:
    
    1.4.2
    
    Default:
    
    org.mapstruct.NullValueMappingStrategy.RETURN_NULL
- - nullValueMapMappingStrategy
```
public abstract org.mapstruct.NullValueMappingStrategy nullValueMapMappingStrategy
```
    The strategy to be applied when null is passed as source argument value to a MapMapping. If no strategy is configured, the strategy given via nullValueMappingStrategy() will be applied, using NullValueMappingStrategy.RETURN_NULL by default.
    
    Returns:
    
    The strategy to be applied when null is passed as source value to a MapMapping.
    
    Since:
    
    1.4.2
    
    Default:
    
    org.mapstruct.NullValueMappingStrategy.RETURN_NULL
- - nullValuePropertyMappingStrategy
```
public abstract org.mapstruct.NullValuePropertyMappingStrategy nullValuePropertyMappingStrategy
```
    当属性值为 null 时应对的策略，默认设置为 null
    
    Returns:
    
    NullValuePropertyMappingStrategy
    
    Default:
    
    org.mapstruct.NullValuePropertyMappingStrategy.SET_TO_NULL
- - nullValueCheckStrategy
```
public abstract org.mapstruct.NullValueCheckStrategy nullValueCheckStrategy
```
    Determines when to include a null check on the source property value of a bean mapping. Can be overridden by the one on Mapper, BeanMapping or Mapping.
    
    Returns:
    
    strategy how to do null checking
    
    Since:
    
    1.4.2
    
    Default:
    
    org.mapstruct.NullValueCheckStrategy.ON_IMPLICIT_CONVERSION
- - mappingControl
```
public abstract Class<? extends Annotation> mappingControl
```
    Allows detailed control over the mapping process.
    
    Returns:
    
    the mapping control
    
    Since:
    
    1.4.2
    
    See Also:
    
    DeepClone, NoComplexMapping, MappingControl
    
    Default:
    
    org.mapstruct.control.MappingControl.class
- - unexpectedValueMappingException
```
public abstract Class<? extends Exception> unexpectedValueMappingException
```
    Exception that should be thrown by the generated code if no mapping matches for enums. If no exception is configured, IllegalArgumentException will be used by default.
    Note:
    - The defined exception should at least have a constructor with a String parameter.
    - If the defined exception is a checked exception then the enum mapping methods should have that exception in the throws clause.
    Returns:
    
    the exception that should be used in the generated code
    
    Since:
    
    1.4.2
    
    Default:
    
    java.lang.IllegalArgumentException.class
- - suppressTimestampInGenerated
```
public abstract boolean suppressTimestampInGenerated
```
    Flag indicating whether the addition of a time stamp in the @Generated annotation should be suppressed. i.e. not be added. The method overrides the flag set through an annotation processor option.
    
    Returns:
    
    whether the addition of a timestamp should be suppressed
    
    Since:
    
    1.4.2
    
    Default:
    
    false
- - builder
```
public abstract org.mapstruct.Builder builder
```
    构造者模式配置，由于 mapstruct 和 lombok 和 builder 一起使用时，会丢失父类属性，这里默认改为关闭
    
    Returns:
    
    Builder
    
    Default:
    
    @org.mapstruct.Builder(disableBuilder=true)
- - adapterPackage
```
public abstract String adapterPackage
```
    默认包名为：io.github.linpeilie
    
    Returns:
    
    ConvertAdapterClass 包名
    
    Default:
    
    ""
- - adapterClassName
```
public abstract String adapterClassName
```
    默认类名为：ConvertMapperAdapter
    
    Returns:
    
    ConvertAdapterClass 类名
    
    Default:
    
    ""
- - mapAdapterClassName
```
public abstract String mapAdapterClassName
```
    默认类名为：MapConvertMapperAdapter
    
    Returns:
    
    MapConvertAdapterClass 类名
    
    Default:
    
    ""
- - autoConfigPackage
```
public abstract String autoConfigPackage
```
    MapStructPlus 所生成的配置类(AutoMapperConfig/AutoMapMapperConfig)包路径
    默认包路径为 io.github.linpeilie
    
    Returns:
    
    AutoMapperConfig / AutoMapMapperConfig 包路径
    
    Default:
    
    ""
- - autoMapperConfigClassName
```
public abstract String autoMapperConfigClassName
```
    MapStructPlus 所生成的配置类转换的配置类名
    默认类名为 AutoMapperConfig
    
    Returns:
    
    AutoMapperConfig 类名
    
    Default:
    
    ""
- - autoMapMapperConfigClassName
```
public abstract String autoMapMapperConfigClassName
```
    MapStructPlus 所生成的配置 Map 与对象转换的配置类名
    默认类名为 AutoMapMapperConfig
    
    Returns:
    
    AutoMapMapperConfig 类名
    
    Default:
    
    ""

Annotation Type MapperConfig

Optional Element Summary

Element Detail

mapperPackage

unmappedSourcePolicy

unmappedTargetPolicy

typeConversionPolicy

collectionMappingStrategy

nullValueMappingStrategy

nullValueIterableMappingStrategy

nullValueMapMappingStrategy

nullValuePropertyMappingStrategy

nullValueCheckStrategy

mappingControl

unexpectedValueMappingException

suppressTimestampInGenerated

builder

adapterPackage

adapterClassName

mapAdapterClassName

autoConfigPackage

autoMapperConfigClassName

autoMapMapperConfigClassName