# 高级查询组件介绍：高级查询为jpa查询，mybatis查询（不包括xml），sql查询提供通用替换组件，在兼容原逻辑的同时提供了扩展为高级查询的功能。 ## 一、参数改造：为了适配高级查询多种查询方式，后端对查询参数（支持requestBody、requestParam）进行了改造，如下： | 参数 | 类型 | 必需 | 说明 | | ---------------- | ----------------------------------- | ---- | -------------------------------------------------- | | checkKey | String | 否 | 多选时，选择字段的key（不传为id) | | checkValue | String | 否 | 多选时，选择字段值，多个用^拼接 | | query | List | 否 | 查询框查询条件，前端传递 | | defaultCondition | List> | 否 | 默认查询条件，前端有特殊查询条件时可传递 | | staticCondition | List> | 否 | 个人视图条件，前端传递 | | page | int | 否 | 当前页 | | limit | int | 否 | 每页条数 | | orderField | String | 否 | 排序字段，后端会自动增加id排序，推荐让前端传该字段 | | order | String | 否 | 排序，asc升序，desc降序，推荐让前端传 | | haveCount | boolean | 否 | 是否查询count，默认为true，推荐让前端传该字段 | `QueryConditionDetailDTO`参数介绍 | 参数 | 类型 | 必需 | 说明 | | ------------------ | ------------------------ | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | | code | 字段编码 | 是 | 字段编码，为驼峰格式，需与entity中字段名一致 | | area | 字段区域 | 否 | 表或表别名，默认不传 | | condition | 条件符 | 是 | 高级查询条件符，具体值见全局编码：QUERY\_CONDITION\_TYPE | | fieldType | 字段类型 | 是 | 字段类型，详细见下表 | | value | 字段值 | 否 | 字段值 | | valueType | 值类型 | 否 | 动态值类型，具体值见全局编码： | | dataType | 值类型 | 否 | 值类型，为了区分字段数据源新增字段；11：公司、12：核算主体、13：业务类型；
如果条件符是18、19（属于（及其子级）、不属于（及其子集））时，该字段必传 | | specialSql | 特殊sql | 否 | 特殊查询sql，如果字段在明细表中可以使用 | | transUnderlineFlag | 是否转换字段为下划线格式 | 否 | lov使用，如果字段编码已经是下划线格式，传true | fieldType列表 | 值 | 值名称 | | -- | ------------------------------------ | | 1 | 文本 | | 2 | 数字 | | 3 | 单选 | | 4 | 时间（字符串时间） | | 5 | 文本域 | | 6 | 多选 | | 7 | 时间（固化时间，对应数据库存的DATE） | requestBody示例： ```json { "page": 1, "limit": 20, "orderField": "", "order": "", "query": [ { "code": "code", "condition": 3, "fieldType": 1, "value": "11" } ], "staticCondition": [ [ { "code": "name", "label": "对账组织名称", "fieldType": 1, "type": "text", "condition": "3", "value": "123456" } ] ] } ``` requestParam示例： ``` page: 1 limit: 20 orderField: order: query: [{"code":"boeTypeCode","condition":3,"fieldType":1,"value":"2024"}] staticCondition: [[{"code":"validityFlag","fieldType":1,"type":"select","label":"状态","value":"0","condition":"14"}]] ``` ## 二、后端适配为适配高级查询，后端新增工具类：cn.ztessc.common.utils.QueryConditionUtils；该工具类支持适配JPA查询，sql语句查询，Mybatis（不支持xml），并支持dto入参和map入参，dto入参需继承基类 QueryConditionDTO ### 1.JPA查询 cn.ztessc.common.utils.QueryConditionUtils#splicingConditionJpa(java.util.Map, java.lang.Class, java.util.function.Consumer) 该方法适配Map参数的查询示例： ```java public PageUtils queryPage(Query query) { Criteria criteria = QueryConditionUtils.splicingConditionJpa(query,SysPostingKeyEntity.class); splicingCondition(criteria, query); Pageable pageable = QueryConditionUtils.getPageable(query); Page page = this.findAll(criteria, pageable); List dtoList = new ArrayList<>(); if (page != null) { List content = page.getContent(); dtoList = ConvertUtils.sourceToTarget(content, SysPostingKeyDTO.class); // 翻译 transList(dtoList); } PageUtils pageUtils = new PageUtils(page); pageUtils.setList(dtoList); return pageUtils; } ``` ### 2.SQL查询 cn.ztessc.common.utils.QueryConditionUtils#splicingConditionSql(java.util.Map, java.lang.String) 示例： ```java public PageUtils queryCollectionVPage(Query query) { StringBuilder sql = new StringBuilder(); sql.append("select * from SYS_PROJECT_V t where 1=1 "); // 设置查询条件 Map params = new HashMap<>(query.size()); setQueryParamsForCollection(sql, query, params); // 设置排序 sql.append(" order by t.id desc"); String querySql = QueryConditionUtils.splicingConditionSql(query, sql.toString()); PageUtils pageUtils = sqlService.page(querySql, SysProjectVEntity.class, query.getPage(), query.getLimit(), params); return pageUtils; } ``` ### 3.Mybatis查询 cn.ztessc.common.utils.QueryConditionUtils#splicingConditionMybatis(java.util.Map, java.lang.Class) 示例： ```java public PageUtils queryDtoPage(QueryConditionDTO query) { // 获取高级查询组件 QueryWrapper queryWrapper = QueryConditionUtils.splicingConditionMybatis(query, SysPersonalConfigEntity.class); if (CharSequenceUtil.isBlank(query.getOrderField())) { query.setOrderField("assignCategories,assignDetails"); } // 设置默认排序 QueryConditionUtils.setDefaultOrder(query); // 拼接查询条件 splicingCondition(queryWrapper, query); // 获取分页 PageInfo pageable = QueryConditionUtils.getPageable(query, SysPersonalConfigEntity.class); // 查询 PageInfo pageInfo = getBaseMapper().selectPage(pageable, queryWrapper); // 翻译 List dtoList = baseDataTranslateUtils.baseDataTranslate(pageInfo.getRecords(), SysPersonalConfigDTO.class); return QueryConditionUtils.getPageUtil(pageInfo, dtoList); } ```

高级查询组件使用教程

高级查询组件使用教程

关于作者

目录