查詢過濾器用法 === **目錄索引：** - 功能描述 - 查詢規則 1. 全匹配查詢 2. 模糊查詢 3. 范圍查詢 4. 包含查詢 5. 等等。。。 - 查詢過濾器如何集成 - 更多查詢規則參考 # 查詢過濾器 ## 一、功能描述 查詢過濾器可以幫助快速生成查詢條件，不需要編碼通過配置實現，支持模糊查詢、匹配查詢、范圍查詢、不匹配查詢等規則。 ## 二、查詢規則 **說明：**頁面查詢字段，需跟后臺Controller中Page的字段對應一致，后臺不需寫代碼自動生成查詢條件SQL; 默認查詢條件是全匹配，想實現模糊查詢需求在查詢值的前后加: \*; **查詢匹配方式規則：** [1].全匹配查詢：查詢數據沒有特殊格式，默認為全匹配查詢 [2].模糊查詢：查詢數據格式需加星號：{ \* } 例如： ``` 格式一： 張* （后模糊匹配） 格式二： *張 （前模糊匹配） 格式三： *張* （全模糊匹配） 格式四： *張*三* （更高級匹配） ``` [3].包含查詢：查詢數據格式采用逗號分隔：{ , } 例如： ``` 格式： 張三,李四 (含義：In('張三','李四')) ``` [4].不匹配查詢：查詢數據格式需要加嘆號前綴：{ ! } 例如： ``` 格式： !張三 (含義：不等于'張三') 特殊說明：查詢不為Null的語法：!null(大小寫沒關系); 查詢不為空字符串的方法：!(只有一個嘆號); ``` [5].范圍查詢，支持數字，時間的范圍查詢，針對范圍查詢頁面會生成兩個查詢控件 ``` 1. 如果是單一匹配方式，則頁面查詢控件的name， 跟實體字段命名一樣 2. 如果是范圍匹配方式，則頁面查詢控件需要變成兩個分別名 {*}_begin，{*}_end {*}_begin： 表示查詢范圍開始值 {*}_end: 表示查詢范圍結束值 舉例： 字段名稱 orderDate 查詢開始時間 : orderDate_begin 查詢結束時間 : orderDate_end ``` ## 三、查詢過濾器如何集成 **第一步：頁面實現查詢條件** 在線列表的查詢區域，增加需要的查詢字段，如下圖所示。  效果:  **第二步：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; } ``` ## 四、更多查詢規則參考 | 查詢模式 | 用法 | 說明 | |---------------------|-------------------------------------------------------|------------------| | 模糊查詢 | 支持左右模糊和全模糊 需要在查詢輸入框內前或后帶\*或是前后全部帶\* | | | 取非查詢 | 在查詢輸入框前面輸入! 則查詢該字段不等于輸入值的數據| (數值類型不支持此種查詢,可以將數值字段定義為字符串類型的) | | in查詢 | 若傳入的數據帶,(逗號) 則表示該查詢為in查詢 | | | in查詢 | 數字類型字段多值查詢，需要將字段加上后綴“_MultiString”，其他規則同上 | 例如實體字段:tableType，頁面接受參數字段 tableType_MultiString | | 多選字段模糊查詢 | 例如 現在name傳入值 ,a,b,c, 那么結果sql就是 name like '%a%' or name like '%b%' or name like '%c%' | 上述4 有一個特例，若某一查詢字段前后都帶逗號 則會將其視為走這種查詢方式 ,該查詢方式是將查詢條件以逗號分割再遍歷數組 將每個元素作like查詢 用or拼接, | - 高級值規則用法 (查詢內容，帶有查詢規則符號 ) | 查詢模式 | 用法 | 舉例 | |---------------------|-------------------------------------------------------|------------------| | < | 小于查詢。 查詢內容值規則："lt+ 空格 + 內容" | 輸入值： “lt 100” | | <= | 小于等于查詢。 查詢內容值規則："le+ 空格+ 內容" | 輸入值： “le 100” | | \> | 大于查詢。 查詢內容值規則："gt+ 空格+ 內容" | 輸入值： “gt 100” | | \>= | 大于等于查詢。 查詢內容值規則："ge+ 空格+ 內容" | 輸入值： “ge 100” | 1. 范圍匹配方式，則頁面查詢控件需要變成兩個分別名 {*}_begin，{*}_end {*}_begin： 表示查詢范圍開始值 {*}_end: 表示查詢范圍結束值 舉例：  字段名稱 costTime 查詢開始 : costTime_begin 查詢結束 : costTime_end this.queryParam.costTime_begin = costTime_begin; this.queryParam.costTime_end = costTime_end;