列表页的动态条件搜索

在我是如何做列表页的，我提到了列表页的动态条件搜索，主要的目的就是在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，看起来并不难，但要解决这么几个问题：

参数收集问题，表单域的值以什么样的方式提交到后台？

后台接收参数类型是什么？

如何将表单域中的条件转换成数据库组件能够识别的条件？

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

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

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

参数收集问题，表单域的值以什么样的方式提交到后台方法？

一般做页面查询时请求数据就两种方式，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基本保持不变，应付普通的管理界面查询足够了。