新手必懂的SpringBoot接口传参全攻略:查询参数/路径参数/JSON 参数

// 你的省市区联动接口（标准查询参数写法）
@GetMapping("/linkage")
public ApiResponse<List<CountryAreaOptionDTO>> linkage(
    @Valid CountryAreaLinkageQueryDTO request // 自动封装所有查询参数
) {
    return ApiResponse.success(countryAreaDOService.queryLinkage(request));
}

// 查询单个地区详情（路径参数写法）
@GetMapping("/area/{areaId}")
public ApiResponse<CountryAreaDO> getAreaById(
    @PathVariable Long areaId // 接收路径中的ID
) {
    return ApiResponse.success(countryAreaDOService.getById(areaId));
}

// 新增地区（JSON参数写法）
@PostMapping("/area/save")
public ApiResponse<Boolean> saveArea(
    @RequestBody CountryAreaDO areaDO // 接收JSON参数
) {
    return ApiResponse.success(countryAreaDOService.save(areaDO));
}

// 前端：?parentId=0&level=1 → 自动封装进DTO
@GetMapping("/linkage")
public ApiResponse linkage(CountryAreaLinkageQueryDTO request) {}

// 只接收 provinceId 这一个参数
@GetMapping("/cities")
public ApiResponse cities(@RequestParam Long provinceId) {}

// 核心联动查询方法
public List<CountryAreaOptionDTO> queryLinkage(Long parentId) {
    // 1. 查询当前层级数据
    List<CountryAreaDO> areas = parentId == null
            ? list(Wrappers.<CountryAreaDO>lambdaQuery().isNull(CountryAreaDO::getPid))
            : list(Wrappers.<CountryAreaDO>lambdaQuery().eq(CountryAreaDO::getPid, parentId));

    // 2. 获取所有父ID集合（判断是否有子节点）
    Set<Long> parentIds = list(Wrappers.<CountryAreaDO>lambdaQuery().isNotNull(CountryAreaDO::getPid))
            .stream().map(CountryAreaDO::getPid).collect(Collectors.toSet());

    // 3. 自动判断层级：省/市/区
    return areas.stream().map(area -> toOption(area, level, parentIds)).toList();
}

// 层级判断规则
parentId == null ? 省份 : parentIds.contains(area.getId()) ? 市 : 区

@Data
public class CountryAreaOptionDTO {
    private Long id;        // 下一级查询的parentId
    private String name;   // 前端展示名称
    private String level;  // 层级编码
    private String levelDesc; // 省/市/区
    private boolean hasChildren; // 是否有子节点
}