Spring Boot实现FormComponent实体与按行分组JSON双向转换

不要修改原有JPA实体的映射逻辑，实体直接和form_component表结构对齐即可，单独定义接口层专用的DTO做序列化/反序列化，避免数据库结构和接口结构耦合，整体实现成本最低。

1. 查询接口返回按行号分组的嵌套结构 #

第一步：定义接口返回专用DTO #

不要直接在实体类上套嵌套注解，单独建两层结构对应要求的JSON格式：

public class FormComponentDTO {
    private List<RowItem> rows;

    // 补全getter/setter，也可以用Lombok @Data简化代码
    public static class RowItem {
        private List<FormComponent> components;
        // 补全getter/setter
    }
}

第二步：查询后内存分组组装结构 #

不需要写复杂的SQL或者自定义JPA关联映射，直接查全量数据后用Stream按rowNumber分组即可，适配表单组件这类数据量不大的场景性能完全足够：

public FormComponentDTO listAllGroupByRow() {
    // 查询时直接按行号、列号升序排序，省掉后续内存排序步骤
    List<FormComponent> allComponents = formComponentRepository.findAll(
            Sort.by(Sort.Direction.ASC, "rowNumber", "colNumber")
    );

    // 按行号分组，用TreeMap保证行号从小到大排列
    Map<Integer, List<FormComponent>> groupByRow = allComponents.stream()
            .collect(Collectors.groupingBy(
                    FormComponent::getRowNumber,
                    TreeMap::new,
                    Collectors.toList()
            ));

    // 组装成要求的嵌套结构
    FormComponentDTO result = new FormComponentDTO();
    List<FormComponentDTO.RowItem> rows = groupByRow.values().stream()
            .map(components -> {
                FormComponentDTO.RowItem row = new FormComponentDTO.RowItem();
                row.setComponents(components);
                return row;
            }).toList();
    result.setRows(rows);
    return result;
}

不要为了这个需求给实体加自关联的@OneToMany映射，rowNumber只是普通业务字段不是外键，硬加关联映射反而容易触发N+1查询问题，增加维护成本。

2. 接收嵌套JSON完成持久化 #

Spring Boot默认的Jackson序列化器可以直接把符合格式的JSON反序列化为上面定义的FormComponentDTO对象，不需要写自定义解析逻辑。

Controller层直接用DTO接参： #

@PostMapping("/form/components/batch-save")
@Transactional
public void batchSaveComponents(@Valid @RequestBody FormComponentDTO formData) {
    // 按需选择逻辑：如果是全量覆盖场景，先删除历史数据再保存新数据
    formComponentRepository.deleteAll();

    // 把嵌套结构拍平为实体列表
    List<FormComponent> entityList = formData.getRows().stream()
            .flatMap(rowItem -> rowItem.getComponents().stream())
            // 可以在这里加字段校验，比如rowNumber、colNumber非空校验
            .toList();

    // 批量保存
    formComponentRepository.saveAll(entityList);
}

可选优化点 #

• 可以给FormComponent的rowNumber、colNumber字段加@NotNull校验注解，配合@Valid做入参校验，避免非法数据入库
• 如果是增量更新而非全量覆盖的场景，可以在拍平逻辑里根据组件id判断是新增还是更新，再对应调用保存/更新逻辑
• 如果后续需要给行、列扩展独立属性（比如行高、列样式），直接在DTO对应层级加字段即可，不需要修改数据库表对应的实体类，扩展性更好
• 如果单表单组件量超过千级，可以把全量查询换成流式查询，避免一次性加载太多数据占内存，绝大多数业务场景下普通查询完全够用

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