我是如何做列表页的（列表页模板）

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

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

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

• 搜索条件支持动态条件查询，后端不需要干预相关条件的组装；即不能出现类似如下的代码（注：此做法只针对单表的查询，如果是非常复杂的多表关联，此方案也许不是最佳的）

       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中我们可以这样写

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

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

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

java

    @RequestMapping(value = "/getStoreByPage", method = RequestMethod.POST)
    @ResponseBody
    public PageInfo<BcStore> 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<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));
 }
 }
        }

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

<table id="datatable1" cellpadding="0" cellspacing="0" border="0"
 class="datatable table table-striped table-bordered table-hover">
 <thead>
 <tr>
 <th>门店编号</th>
 <th>名称</th>
 <th>类型</th>
 <th>店长</th>
 <th>电话</th>
 <th>邮箱</th>
 <th>状态</th>
 <th>创建时间</th>
 <th>操作</th>
 </tr>
 </thead>
 <tbody>
 <tr ng-repeat="store in content">
 <td>{{store.storeCode}}</td>
 <td>{{store.storeName}}</td>
 <td>
 <div ng-show="store.storeType=='1'">
 <span class="label label-success">自营店</span>
 </div>
 <div ng-show="store.storeType=='0'">
 <span class="label label-danger">加盟店</span>
 </div>
 </td>

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

 <pagination class="pagination-sm"
 ng-model="pageRequest.pageNum"
 total-items="pageResponse.total"
 max-size="4"
 ng-change="pageRequest.getResponse"
 items-per-page="pageRequest.pageSize"
 rotate="false"
 previous-text="上一页" next-text="下一页"
 ></pagination>