使用Spring Data批量选取百余个参数的最优方案咨询

针对你遇到的百余个参数封装到DTO生成Excel的场景，以下几种方案比你提到的两种更易维护和扩展：

1. 使用Spring Data 投影（Projection） #

这是Spring Data原生支持的方案，无需手写大量映射代码，非常适合多字段查询场景。

实现方式： #

定义一个接口投影，只需要声明对应参数的getter方法，Spring会自动动态生成实现类：

public interface ExcelParamProjection {
    // 对应数据库查询的每个参数，声明getter
    String getUserId();
    String getUserName();
    Integer getAge();
    LocalDateTime getCreateTime();
    // ... 其余百余个参数的getter
}

在Repository中编写查询方法，直接返回投影类型：

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
    @Query("SELECT u.userId, u.userName, u.age, u.createTime, ... FROM User u WHERE u.status = 1")
    List<ExcelParamProjection> findParamsForExcel();
}

生成Excel时，直接通过投影的getter获取字段值即可，甚至无需额外转成DTO（如果投影满足Excel生成的字段需求）。

优点： #

• 无需手写构造函数或映射逻辑，代码简洁
• 字段对应关系清晰，修改参数只需调整JPQL和投影接口
• 支持关联表字段查询，只需在JPQL中关联对应表并声明getter

缺点： #

• 如需复杂字段转换（比如日期格式化、枚举转文本），需要在投影接口中添加默认方法实现

2. 使用MapStruct 实现对象映射 #

如果你的查询结果可以先封装为实体（或实体的子集），用MapStruct这类编译期生成映射代码的工具，能高效完成实体到DTO的转换。

实现方式： #

首先定义DTO类（正常声明字段和setter/getter即可，无需超长构造函数）：

public class ExcelParamDto {
    private String userId;
    private String userName;
    private Integer age;
    private String createTimeStr; // 比如需要格式化后的日期字符串
    // ... 其余字段的setter/getter
}

然后定义MapStruct的Mapper接口：

@Mapper(componentModel = "spring")
public interface ExcelParamMapper {
    ExcelParamMapper INSTANCE = Mappers.getMapper(ExcelParamMapper.class);

    @Mapping(source = "createTime", target = "createTimeStr", dateFormat = "yyyy-MM-dd HH:mm:ss")
    ExcelParamDto entityToDto(User user);

    // 如果涉及多实体关联查询，可自定义映射方法
}

在业务层查询实体列表后，调用Mapper转换：

List<User> userList = userRepository.findAllByStatus(1);
List<ExcelParamDto> dtoList = userList.stream()
                                      .map(ExcelParamMapper.INSTANCE::entityToDto)
                                      .collect(Collectors.toList());

优点： #

• 编译期生成映射代码，性能优于反射式工具
• 支持复杂字段转换、默认值设置等场景
• 代码维护成本低，修改字段只需调整Mapper注解

缺点： #

• 若查询的参数来自多个无关联的表，没有统一实体对应，该方案不太适用

3. JdbcTemplate + 自定义RowMapper #

如果涉及复杂的多表联合查询，原生SQL比JPQL更灵活，配合自定义RowMapper可以清晰控制每个字段的映射逻辑。

实现方式： #

编写原生SQL，通过JdbcTemplate执行并映射到DTO：

@Autowired
private JdbcTemplate jdbcTemplate;

public List<ExcelParamDto> getParamsForExcel() {
    String sql = "SELECT u.user_id, u.user_name, u.age, t.order_no, t.order_amount " +
                 "FROM user u LEFT JOIN order t ON u.user_id = t.user_id " +
                 "WHERE u.status = 1";

    return jdbcTemplate.query(sql, (rs, rowNum) -> {
        ExcelParamDto dto = new ExcelParamDto();
        dto.setUserId(rs.getString("user_id"));
        dto.setUserName(rs.getString("user_name"));
        dto.setAge(rs.getInt("age"));
        dto.setOrderNo(rs.getString("order_no"));
        dto.setOrderAmount(rs.getBigDecimal("order_amount"));
        // ... 其余字段的映射
        return dto;
    });
}

优点： #

• 完全控制SQL和映射逻辑，适合复杂多表场景
• 原生SQL性能优于JPQL，尤其大数据量查询时
• 字段对应关系一目了然，后期修改参数只需调整SQL和映射代码

缺点： #

• 需要手写映射代码，字段较多时代码量较大
• SQL与Java代码耦合，修改SQL需同步调整映射逻辑

4. DTO Builder模式配合multiselect #

如果你坚持使用JPQL的multiselect，用Builder模式替代超长构造函数，能大幅提升代码可读性和可维护性。

实现方式： #

在DTO中实现Builder内部类：

public class ExcelParamDto {
    private String userId;
    private String userName;
    private Integer age;
    // ... 其余字段

    private ExcelParamDto(Builder builder) {
        this.userId = builder.userId;
        this.userName = builder.userName;
        this.age = builder.age;
        // ... 赋值其余字段
    }

    public static Builder builder() {
        return new Builder();
    }

    public static class Builder {
        private String userId;
        private String userName;
        private Integer age;
        // ... 其余字段

        public Builder userId(String userId) {
            this.userId = userId;
            return this;
        }

        public Builder userName(String userName) {
            this.userName = userName;
            return this;
        }

        public Builder age(Integer age) {
            this.age = age;
            return this;
        }

        // ... 其余字段的setter方法

        public ExcelParamDto build() {
            return new ExcelParamDto(this);
        }
    }
}

在JPQL中调用Builder构造DTO：

@Query("SELECT NEW com.example.dto.ExcelParamDto.Builder() " +
       ".userId(u.userId) " +
       ".userName(u.userName) " +
       ".age(u.age) " +
       "... " +
       ".build() " +
       "FROM User u WHERE u.status = 1")
List<ExcelParamDto> findParamsForExcel();

优点： #

• 避免了超长构造函数的参数顺序混乱问题
• 可选择性设置字段，后期新增参数只需添加Builder的setter方法
• 代码可读性优于全参构造函数

缺点： #

• 仍需编写大量Builder方法，字段较多时代码量较大

内容的提问来源于stack exchange，提问作者ellen lew