查询过滤器用法

目录索引：

• 功能描述
• 查询条件如何实现
• 查询过滤器高级特性
  • 组合条件查询
  • 字段范围查询
  • 日期字段的数据格式化
• 查询规则
• 更多查询规则参考

查询过滤器

一、功能描述

查询过滤器可以帮助快速生成查询条件，不需要编码通过配置实现，支持模糊查询、匹配查询、范围查询、不匹配查询等规则。

二、查询条件如何实现

第一步：页面实现查询条件在线列表的查询区域，增加需要的查询字段，如下图所示。

效果:

第二步：controller层处理Controller中对应的处理逻辑中追加如下代码：

QueryWrapper<?> queryWrapper = QueryGenerator.initQueryWrapper(?, req.getParameterMap());

代码示例：

    @GetMapping(value = "/list")
    public Result<IPage<JeecgDemo>> list(JeecgDemo jeecgDemo, @RequestParam(name = "pageNo", defaultValue = "1") Integer pageNo, 
                                         @RequestParam(name = "pageSize", defaultValue = "10") Integer pageSize,
            HttpServletRequest req) {
        Result<IPage<JeecgDemo>> result = new Result<IPage<JeecgDemo>>();
        //调用QueryGenerator的initQueryWrapper
        QueryWrapper<JeecgDemo> queryWrapper = QueryGenerator.initQueryWrapper(jeecgDemo, req.getParameterMap());
        Page<JeecgDemo> page = new Page<JeecgDemo>(pageNo, pageSize);
        IPage<JeecgDemo> pageList = jeecgDemoService.page(page, queryWrapper);
        result.setSuccess(true);
        result.setResult(pageList);
        return result;
    }

三、查询规则

说明：页面查询字段，需跟后台Controller中Page的字段对应一致，后台不需写代码自动生成查询条件SQL; 默认查询条件是全匹配，想实现模糊查询需求在查询值的前后加: *;

查询匹配方式规则：[1].全匹配查询：查询数据没有特殊格式，默认为全匹配查询[2].模糊查询：查询数据格式需加星号：{ * }例如：

     格式一： 张*    （后模糊匹配）
     格式二： *张    （前模糊匹配）
     格式三： *张*   （全模糊匹配）                                            
     格式四： *张*三* （更高级匹配）

[3].包含查询：查询数据格式采用逗号分隔：{ , }例如：

格式：  张三,李四  
       (含义：In('张三','李四'))

[4].不匹配查询：查询数据格式需要加叹号前缀：{ ! }例如：

格式： !张三
     (含义：不等于'张三')
    特殊说明：查询不为Null的语法：!null(大小写没关系);
             查询不为空字符串的方法：!(只有一个叹号);

[5].范围查询，支持数字，时间的范围查询，针对范围查询页面会生成两个查询控件

1. 如果是单一匹配方式，则页面查询控件的name， 跟实体字段命名一样
2. 如果是范围匹配方式，则页面查询控件需要变成两个分别名 {*}_begin，{*}_end
{*}_begin： 表示查询范围开始值
{*}_end:    表示查询范围结束值 
举例：
字段名称 orderDate
查询开始时间 : orderDate_begin
查询结束时间 : orderDate_end

四、更多查询规则参考

• 高级值规则用法 (查询内容，带有查询规则符号 )