Jeecg-Boot子表高级查询功能实现指南

问题背景

在Jeecg-Boot 3.7.3版本中，用户在使用高级查询功能查询子表字段时遇到了操作失败的问题。系统抛出的异常信息显示，生成的SQL语句中存在空条件查询（WHERE()），导致MyBatis-Plus无法正确处理查询请求。

技术分析

Jeecg-Boot的高级查询功能默认仅支持主表查询，对于子表的高级查询需要开发者进行额外的实现。这是因为：

1. 代码生成器默认生成的查询逻辑主要针对主表设计
2. 子表关联查询涉及更复杂的SQL构建逻辑
3. 前端组件与后端接口的交互需要特殊处理

解决方案

要实现子表的高级查询功能，需要按照以下步骤进行开发：

后端实现

1. 创建子表查询接口：在子表对应的Controller中新增一个专门处理高级查询的方法

@AutoLog(value = "子表-高级查询")
@ApiOperation(value="子表-高级查询", notes="子表-高级查询")
@PostMapping(value = "/superQuery")
public Result<?> superQuery(
    @RequestBody JSONObject queryJson,
    @RequestParam(name = "superQueryMatchType", required = false) String superQueryMatchType) {
    
    QueryWrapper<子表实体类> queryWrapper = superQueryCondition(queryJson, superQueryMatchType);
    // 执行查询逻辑
    return Result.OK(子表Service.list(queryWrapper));
}

2. 实现查询条件构建：继承Jeecg-Boot提供的SuperQueryCondition类，构建子表查询条件

private QueryWrapper<子表实体类> superQueryCondition(JSONObject queryJson, String superQueryMatchType) {
    QueryWrapper<子表实体类> queryWrapper = new QueryWrapper<>();
    if(queryJson != null && queryJson.size() > 0) {
        // 构建查询条件
        SuperQueryCondition.installMplus(queryWrapper, queryJson, superQueryMatchType);
    }
    return queryWrapper;
}

前端实现

1. 修改页面配置：在子表列表页面的配置中，添加高级查询支持

// 在columns配置中添加需要支持高级查询的字段
{
    title: '字段名称',
    dataIndex: 'fieldName',
    align: 'center',
    scopedSlots: { customRender: 'fieldName' },
    // 添加以下配置支持高级查询
    queryCondition: true
}

2. 调整API调用：修改子表查询方法，调用专门的高级查询接口

// 替换原有的loadData方法
loadData(arg) {
    if(!this.url.superQuery){
        this.$message.error("未配置子表高级查询接口");
        return;
    }
    let params = this.getQueryParams(arg);
    if(this.superQueryFlag){
        // 调用高级查询接口
        this.loading = true;
        superQuery(this.url.superQuery, params.superQueryParams).then((res)=>{
            if(res.success){
                this.dataSource = res.result.records || res.result;
            }
            this.loading = false;
        })
    }else{
        // 普通查询逻辑
        getAction(this.url.list, params).then((res) => {
            if (res.success) {
                this.dataSource = res.result.records || res.result;
            }
        })
    }
}

注意事项

1. 确保子表实体类中的所有查询字段都有正确的数据库映射
2. 前端配置的queryCondition需要与后端字段名严格一致
3. 对于复杂的关联查询，可能需要自定义SQL实现
4. 注意处理空查询条件的情况，避免出现WHERE()这样的无效SQL

扩展建议

对于更复杂的业务场景，可以考虑以下优化：

1. 实现动态SQL构建，支持更灵活的查询条件组合
2. 添加查询条件验证逻辑，防止无效查询
3. 对查询性能进行优化，特别是大数据量表
4. 实现查询条件的缓存机制，提升用户体验

通过以上实现，可以解决Jeecg-Boot中子表高级查询功能不可用的问题，并为用户提供完整的查询体验。