我是如何做列表页的(列表页的作用是什么)

最近难得公司业务稍微缓解一些,我们终于有时间静下心总结下技术,对于之前的项目去其糟粕取其精华,我们的目的是:

  • 解决后台管理系统的开发效率问题,封装常用功能,将技术性强的内容分离出去;
  • 将重复性高的开发工作统一技术规范,避免各自研究;
  • 采用最佳实践,参考优秀项目,制定最佳方法,至少是最适合当前团队的。

这里我先总结下我这块针对数据列表页的做法,后续再补充其它模块的做法,先看下列表页的需求:

  • 搜索条件支持动态条件查询,后端不需要干预相关条件的组装;即不能出现类似如下的代码(注:此做法只针对单表的查询,如果是非常复杂的多表关联,此方案也许不是最佳的)
       if(!StringUtils.isEmpty(employeeEnityRequest.getEmployeeName)){
 criteria.andEmployeeNameEqualTo(employeeEnityRequest.getEmployeeName);
        }
        if(!StringUtils.isEmpty(employeeEnityRequest.getEmployeeStatus)){
 criteria.andEmployeeStatusEqualTo(Integer.valueOf(employeeEnityRequest.getEmployeeStatus));
        }
  • 查询异步,用户点击下一页时如果需要刷新整个页面体验性不太好。

上面这两需求非常常规,有很多种实现方式,我分享下我的做法(我的环境是eclipse,tomcat,maven,spring mvc, mybatise,mysql):

针对动态查询,我们通过约定规则来实现,比如View中我们可以这样写

它的意思是查询email字段,操作符是=号。WHERE是固定的,后台解析收集条件时做识别作用,中间的是字段名称,后面是操作符,操作符比如有EQ,LIKE等常规的数据库查询操作符。这样我们可以在前端任意增加修改条件,而后台的逻辑是不需要有任务变更的,详细的收集过程请看本文后面的介绍。

针对异步查询,我采用了angularjs相关技术,当时遇到一个问题:angularjs在查询时一般都会指定一个写好的model传递到后台,但由于上面动态查询的条件是变动的(字段名称不固定,字段数量不固定,操作类型不固定),所以没有办法去定义这样的model。第一直觉是将整个表单传递到后台,后台根据表单的值来解决特定的条件,第二个问题来了,既然是将表单传递到后台,那么后台要用什么参数来接收这个表单呢,于时想到HttpServletRequest,但经过测试,这个参数始终取不到值,当时的代码如下:

java

    @RequestMapping(value = "/getStoreByPage", method = RequestMethod.POST)
    @ResponseBody
    public PageInfo getStoreByPage(HttpServletRequest request,int pageNum, int pageSize) {

js

$.ajax({
    type : "POST",
    url : url,
    dataType : 'json',
    data:$("#searchForm").serialize,
    async : false,
    success : function(data) {
        $scopeLocal.pageResponse = data;
        $scopeLocal.content=data.list;
    }
});

后来和同事讨论说是需要设置ajax的contentType为
application/x-www-form-urlencoded,但设置后直接报错,请求无法到达服务端,说明参数类型匹配错误,将后台controller方法中的参数HttpServletRequest删除后顺利通过。但这个参数删除了,表单值从哪取呢?好在后端也可以取到当前请求,RequestContextHolder可以帮助我们,于是下面的代码就水到渠成了,通过这个帮助类我们可以从请求中根据我们制定的规定来解析条件,至于条件对象的格式,主要看数据访问端的使用情况,这里先不贴代码了,我们主要采用的是通用mapper那套方案,网上可去搜索。到此,问题解决了,数据也可以顺利查到了。

private static String DEFAULT_PRE_WHERE = "WHERE.";
private String preWhere = DEFAULT_PRE_WHERE;
List searchFilterStrings = Lists.newArrayList;

        Map map = request.getParameterMap;

        for (Map.Entry 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));
 }
 }
        }

列表数据的展示,我没有采用jquery datatable之类的控件,我感觉需要写JS代码,看起来比较复杂,采用angularjs的ng-repeat非常直观,且容易控制细节。

分页控制我们采用了angularjs与boostrap的一个插件完成,需要引用ui-bootstrap-tpls.min.js以及boostrap-ui相关的代码才行:

 
门店编号 名称 类型 店长 电话 邮箱 状态 创建时间 操作
{{store.storeCode}} {{store.storeName}}
自营店
加盟店