列表页的动态条件搜索

  在我是如何做列表页的,我提到了列表页的动态条件搜索,主要的目的就是在View中能够动态的指定条件,而后端的数据查询逻辑尽量不变。之前在搞.net的时候,我们可以借助强大的ExpressionTree来解决,之前有一篇是微软的EntityFramework表达式转换:Linq to Entity经验:表达式转换,是将一种表达式转换成数据库组件能够识别的表达式,只不过那篇没有涉及到View中的条件而已。页面动态查询的最简单的方法就是解析View中特定的值来得到后台组件能够识别的查询逻辑。
 
  我们期待View中能够这样指定条件:
 

<input type="text" name="WHERE.storeName.LIKE" class="form-control" style="width: 180px;" " />


  它的意思是查询字段storeName,操作符是like,看起来并不难,但要解决这么几个问题:

  1.   参数收集问题,表单域的值以什么样的方式提交到后台?
  2.   后台接收参数类型是什么?
  3.   如何将表单域中的条件转换成数据库组件能够识别的条件?


  我们选择的数据库组件是mybatis+mysql。个人感觉mybatis在处理动态查询时比JPA在前期(技术学习前期,即水平还不太够的时候)要简单些,也可能是我对JPA的认识还不够,总感觉mybatis这种拼SQL的方式比较熟悉一些,也比较容易控制。当然它们的定位本身就不同,这里不多讨论。基于mybatis我们采用了tk.mybatis这个开源的组件,它的功能非常丰富,分页,通用mapper,代码生成等大部分功能都已经包含,大家有兴趣可以去搜索。

   注:下面的功能是我的同事完成,这里我做为学习的过程来分享下,可能也有理解不到位的地方,纯属个人学习理解。其中有部分功能未展示出来(比如权限过滤,and or这些分组查询的支持等),只包含最基本的,每个项目的需求不同以及团队环境不同可以会有多种实现方式,选择大家都能接受的就可以了。

  我们再分别看下上面的三个问题怎么解决:

  1.   参数收集问题,表单域的值以什么样的方式提交到后台方法?

     一般做页面查询时请求数据就两种方式,get或者post。get一般是在采用了ajax这类技术,post就复杂一些,分为两种:一种也是采用ajax提交到后台,一种是表单的提交。这里呢,由于我们采用了angularjs,所以很显然只能采用ajax提交,如果查询条件多,可采用ajax的post。由于上面贴的代码片段显示条件的name是动态的,所以我们不可能定义一个具体的后台的业务Model对前台的条件,比如有name,email,phone等等,所以我们采用将表单域整个序列化后的结果传递到后台。

     

                 var requestData = $("#"+options.searchFormId+"").serialize();
                     var url = listUrl+"?"+requestData+"&pageNum="+$scopeLocal.pageRequest.pageNum;
                     $.ajax({
                         type : "POST",
                         url : url,
                         dataType : 'json',
                         async : false,
                         beforeSend:options.beforeSend,
                         error:options.error,
                         success : function(data) {
                             $scopeLocal.pageResponse = data;
                             $scopeLocal.content=data.list;
                             options.callback($scopeLocal,data);
                         }
                     });


  2:参数类型是什么?
     如果是表单提交方式,我们可以采用HttpServletRequest这个对象来接收所有表单域的值,但上一步我们采用的提交方式并非表单自身的提交,而是ajax的提交,ajax的请求,是不识别HttpServletRequest这个参数类型的,为此我们需要定义一个自定义的公共的对象来接收我们动态View中指定的条件,这里就有个我们的SearchModel,它包含如下内容:

  • 分页信息,当前页,页数据大小
  • 搜索条件信息集合List<SearchFilter>,一堆我们自己定义的条件,主要包含字段名称,操作符以及值,这里是本文的重点。
  • 转换为SQL的逻辑

     SearchFilter:

  public final class SearchFilter implements Serializable {

    private String propertyName;

    private Object value;

    private Operator operator;

    private String orGroup;

      SearchModel:

public class SearchModel implements Serializable {

    private List<SearchFilter> searchFilters;
    private int pageNum = 1;
    private int pageSize = 10;

 

     上面搜索条件的信息,我们需要从View中获取,这里应用HandlerMethodArgumentResolver来解决,它只有两个方法:

  • 判断是否是支持的参数类型
boolean supportsParameter(MethodParameter parameter);

       这个方法实现比较简单,只需要判断下当前的参数类型是否是指定的类型即可:

@Override
    public boolean supportsParameter(MethodParameter parameter) {
         Class<?> parameterType = parameter.getParameterType();
         return SearchModel.class.isAssignableFrom(parameterType);
    }

 

  • 解析数据的详细过程
Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer, NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception;

      这个方法是核心,之前有提到过,因为我们是ajax提交,在后台的controller方法中不能包含HttpServletRequest request 这个参数,但后台要想取表单域的值从哪取呢?其实还是从这个参数中取,只不过我们需要换一种方法,可以从上面接口的的webRequest对象中获取,有了这个对象也就意味着你得到了表单域的所有值了,后台的事情就好办了。

HttpServletRequest request = webRequest.getNativeRequest(HttpServletRequest.class);

      下面只需要一个转换类将HttpServletRequest中的表单值填充到我们自定义的SearchModel中就可以了,这里需要一个专业处理转换有类SearchFilterBuilder,首先将表单值转换成一个集合,字符串类型的:

    public static SearchFilterBuilder from(final HttpServletRequest request) {
        return new SearchFilterBuilder(request);
    }

    public List<String> buildToStrings() {
        return buildToStrings(true);
    }
    public List<String> buildToStrings(final boolean containsDataAuth) {
        List<String> searchFilterStrings = Lists.newArrayList();

        Map<String, String[]> map = request.getParameterMap();

        for (Map.Entry<String, String[]> entry : map.entrySet()) {
            String strKey = entry.getKey();
            for (String value : entry.getValue()) {

                if (!Strings.isNullOrEmpty(value)
                        && !"none".equals(value)
                        && strKey.startsWith(preWhere)) {

                    String filedAndOp = strKey.substring(preWhere.length());
                    searchFilterStrings.add(String.format("%s=%s", filedAndOp, value));
                }
            }
        }
        if (containsDataAuth) {
           // to do
        }

        return searchFilterStrings;
    }

     基于上面得到的条件集合进一步解析条件,由于我们前端View传递的条件是字符串的,所以这里应用了一个专门的正则表达式的类DefaultSearchFilterStringProcessor去解析数据

    

   public List<SearchFilter> build() {

        List<String> searchFilterStrings = buildToStrings();

        List<SearchFilter> searchFilters = Lists.newArrayList();

        searchFilters.addAll(searchFilterStrings.stream()
                .map(DefaultSearchFilterStringProcessor::from)
                .collect(Collectors.toList()));

        return searchFilters;

    }

 

   由于字符串处理的逻辑与本文关联并不大,这里就不贴相关代码了,不会正则的用最笨的人肉解析字符串也是可以的,如前面说的都拿到Request对象了后面都好操作。

  3:如果将表单域中的条件转换成数据库组件能够识别的条件?
     tk.mybatis或者是官方的mybatis-spring组件都支持动态条件,由于我这采用的是tk.mybatis,所以某些类都是tk.mybatis的,tk是进一步的封装,所以原理大体是相同的,之前有提到过操作mybtis有点像操作原生SQL,感觉就是一种拼SQL的过程,这里我们拼这个动态条件也是类似,简单的话只需要一个静态转换方法就可以了,如果再深入一点可以想办法做成自动识别并转换,有能力的可研究。无非就是如下的转换:

             switch (op) {
                case EQ:
                    this.criteria.andEqualTo(filed, value);
                    break;

                case NOTEQ:
                    this.criteria.andNotEqualTo(filed, value);
                    break;

                case LE:
                    this.criteria.andLessThanOrEqualTo(filed, value);
                    break;


  解决完上面这些,我们就可以直接这样写后台代码了:
  controller:

@RequestMapping(value = "/getAllByPage")
    @ResponseBody
    public PageInfo<BcStore> getAllByPage(final SearchModel s1) {
        this.convertSearchModel(s1);
        
        return storeService.select(s1);
    }


  service:有了example对象,分页信息,排序字段,后面的就是tk.mybatis的基本功能了。

@Override
    public final PageInfo<T> select(final SearchModel searchModel) {
        Example example = ExampleBuilder.forClass(genericType).fromSearchFilters(searchModel.getSearchFilters()).build();
        return select(example, searchModel.getPageNum(), searchModel.getPageSize(), searchModel.getOrderBy());
    }

 

  基于上面的内容,针对查询条件,我们可以在View中任意指定查语语句所包含的条件,后台的controller以及service基本保持不变,应付普通的管理界面查询足够了。

 

posted on 2016-01-18 19:09  min.jiang  阅读(2724)  评论(0编辑  收藏  举报