使用 MapStruct 通过参数化构造函数生成 Mapper-java教程-PHP中文网

使用 MapStruct 通过参数化构造函数生成 Mapper

心靈之曲

发布： 2025-07-20 18:44:17

原创

565人浏览过

使用 mapstruct 通过参数化构造函数生成 mapper

本文介绍了如何配置 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 使用这个构造函数：

即构数智人

即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

查看详情

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 官方文档以获取更详细的信息和高级用法。

以上就是使用 MapStruct 通过参数化构造函数生成 Mapper的详细内容，更多请关注php中文网其它相关文章！