本文介绍了如何配置 MapStruct，使其在使用 Mapper 时，使用参数化构造函数来创建目标对象，而不是默认的无参构造函数和 Setter 方法。通过 @Default 注解或其他配置方式，可以灵活地控制 MapStruct 的对象实例化过程。本文将提供详细的配置方法和示例代码，帮助你更好地理解和使用 MapStruct 的构造函数支持。
MapStruct 1.4 版本之后，开始支持使用构造函数来实例化映射目标对象。这为开发者提供了更灵活的对象创建方式，尤其是在目标对象具有不可变属性或需要特定初始化逻辑时。
配置 MapStruct 使用参数化构造函数
有几种方法可以配置 MapStruct 使用参数化构造函数：
1. 使用 @Default 注解
这是最直接的方法。将 @Default 注解添加到你希望 MapStruct 使用的参数化构造函数上。
例如，假设你有以下 FlightBooking 类：
public class FlightBooking {
private final String flight_booking_id;
public FlightBooking(String flight_booking_id) {
this.flight_booking_id = flight_booking_id;
}
public String getFlight_booking_id() {
return flight_booking_id;
}
}你可以通过以下方式配置 MapStruct 使用这个构造函数：
import org.mapstruct.Mapper;
import org.mapstruct.Mapping;
import org.mapstruct.MappingConstants;
import org.mapstruct.ReportingPolicy;
@Mapper(componentModel = "spring", unmappedTargetPolicy = ReportingPolicy.IGNORE)
public interface FlightMapper {
@Mapping(target = "flight_booking_id", source = "booking_id")
FlightBooking flightBookingPostRequestDtoToFlightBooking(FlightBookingPostRequestDto flightBookingDto);
}并且你的DTO是这样的：
public class FlightBookingPostRequestDto {
private String booking_id;
public String getBooking_id() {
return booking_id;
}
public void setBooking_id(String booking_id) {
this.booking_id = booking_id;
}
}现在，MapStruct 将生成如下的 Mapper 实现：
@Component
public class FlightMapperImpl implements FlightMapper {
@Override
public FlightBooking flightBookingPostRequestDtoToFlightBooking(FlightBookingPostRequestDto flightBookingDto) {
if ( flightBookingDto == null ) {
return null;
}
String booking_id = flightBookingDto.getBooking_id();
FlightBooking flightBooking = new FlightBooking( booking_id );
return flightBooking;
}
}2. 构造函数选择策略 (Constructor Selection Strategy)
如果你的类有多个构造函数，并且你想更精确地控制 MapStruct 使用哪个构造函数，可以使用构造函数选择策略。这涉及使用 @ObjectFactory 和自定义工厂方法。 这种方法较为复杂，通常在需要更细粒度的控制时使用。详细信息请参考 MapStruct 官方文档。
注意事项
- 确保 MapStruct 版本在 1.4 或更高版本。
- 如果目标类有多个构造函数，并且没有使用 @Default 注解，MapStruct 可能会选择默认的无参构造函数（如果存在）。
- 在使用参数化构造函数时，确保 Mapper 中提供了所有必需的参数映射。 可以通过 @Mapping 注解指定源属性到构造函数参数的映射关系。
总结
MapStruct 1.4 引入的构造函数支持为对象映射提供了更大的灵活性。 通过使用 @Default 注解或其他配置方式，可以轻松地控制 MapStruct 使用参数化构造函数来创建目标对象。 这对于处理不可变对象和需要特定初始化逻辑的对象非常有用。 务必参考 MapStruct 官方文档以获取更详细的信息和高级用法。
