MapStruct Core框架中的条件映射与默认映射原理 (Principles of Conditional Mapping and Default Mapping in MapStruct Core Framework)
MapStruct是一个Java注解处理器，用于在两个Java bean之间执行对象映射。它提供了一种简单且类型安全的方式来转换复杂Java对象。
在MapStruct Core框架中，条件映射和默认映射是两个重要的概念。条件映射允许根据给定的条件选择性地映射属性值，而默认映射则定义了在未映射属性字段上应该使用的默认映射行为。
条件映射可以在被映射对象的属性上使用`@Mapping`注解。例如，考虑一个Person类，其中包含一个属性age和一个属性ageGroup：
public class Person {
private int age;
private String ageGroup;
// Getters and setters
}
public class PersonDto {
private int age;
private String ageGroup;
// Getters and setters
}
我们希望在映射时根据年龄属性的值来确定ageGroup属性的值。可以通过在映射方法中使用`@ValueMapping`注解来实现这一目标：
@Mapper
public interface PersonMapper {
@Mapping(target = "ageGroup", source = "age")
@ValueMappings({
@ValueMapping(source = "0", target = "Baby"),
@ValueMapping(source = "10", target = "Child"),
@ValueMapping(source = "18", target = "Adult")
})
PersonDto personToPersonDto(Person person);
}
上面的例子中，当age属性的值为0时，ageGroup属性将被映射为"Baby"；当age属性的值为10时，ageGroup属性将被映射为"Child"；当age属性的值为18时，ageGroup属性将被映射为"Adult"。
独立于条件映射的是默认映射。默认映射规定了在目标对象中没有映射的属性字段上使用的默认映射行为。默认映射可以使用`@Mapping`注解的`defaultValue`属性来指定。例如：
@Mapper
public interface PersonMapper {
@Mapping(target = "ageGroup", source = "age", defaultValue = "Unknown")
PersonDto personToPersonDto(Person person);
}
在上面的例子中，如果没有为ageGroup属性指定任何映射，并且当映射方法被调用时，ageGroup属性将被设置为"Unknown"。
为了使上述映射工作，需要将MapStruct作为一个插件添加到项目的构建配置文件中。例如，如果使用Maven构建项目，需要在pom.xml文件中添加以下依赖：
<dependencies>
<dependency>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct</artifactId>
<version>1.4.2.Final</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.mapstruct</groupId>
<artifactId>mapstruct-maven-plugin</artifactId>
<version>1.4.2.Final</version>
<executions>
<execution>
<id>mapstruct-processor</id>
<phase>generate-sources</phase>
<goals>
<goal>compile</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
上述配置会使MapStruct注解处理器在编译时自动生成映射器的实现类。
综上所述，MapStruct Core框架中的条件映射和默认映射提供了一种灵活和强大的方式来定义复杂对象之间的属性映射关系。通过合理利用这些特性，可以简化对象转换过程并提高代码的可读性和维护性。
