多字段查询,相对于单字段的过滤而言,可以称得上是高级查询了。见下图。
多字段查询的jqGrid调用方式如下:
$(document).ready(function(){
$("#grid").jqGrid({
url:'queryAllBrand.action',
datatype: "json",
mtype: 'POST',
colNames:['品牌ID','品牌代码', '品牌名称', '品牌状态','最后修改时间'],
colModel:[
{name:'brandId',index:'brandId', width:90},
{name:'code',index:'code', width:110},
{name:'brandName',index:'brandName', width:100},
{name:'status',index:'status', width:80},
{name:'lastModifiedDatetime',index:'lastModifiedDatetime', width:100}
],
rowNum:30,
rowList:[30,40,50],
pager: '#nav',
sortname: 'brandId',
viewrecords: true,
width: 500,
height: 500,
sortorder: "ASC",
jsonReader: {
repeatitems : false,
id: "0"
},
caption: "品牌信息"
}).navGrid('#nav',{edit:false,add:false,del:false})
.searchGrid({multipleSearch:true});
});
大家可以看到最后一句话:.searchGrid({multipleSearch:true}),对,就是这么简单。(不过这种拼接调用的方式有一个问题。页面进入的时候,默认就会出来一个查询框,就像上面的图显示的一样,这感觉很不爽!暂时还没有找到好的办法!!??)
那么这种方式和单字段查询的区别在什么地方呢?
单字段查询,jqGrid向服务器传递的参数是searchField、searchString、searchOper这三个参数。多字段查询的时候,jqGrid不再采用这种方式,因为多个查询条件,参数数目就不是固定的了。这种情况下,jqGrid向服务器传递的参数是一个名字叫做filters的json字符串。类似于如下的形式:
filters =
{"groupOp":"AND",
"rules":[
{"field":"invdate","op":"ge","data":"2007-10-06"},
{"field":"invdate","op":"le","data":"2007-10-20"},
{"field":"name","op":"bw","data":"Client 3"}
]
}
知道了这一点,我们就可以在Action类中定义一个变量是filters,然后用json-lib包提供的JSONObject类来进行json参数的解析。
json-lib包不仅提供了把Bean或容器类List、Map等转换为json格式数据的方法,而且提供了把json格式数据转换为容器类或者Bean类对象的方法。
为了方便转换,我们这里定义了两个Transfer Object对象,分别是JqGridSearchTo对象以及JqGridSearchDetailTo对象。
JqGridSearchTo对象的定义如下:(为了方便,我们把一些其他jqGrid上传的参数也封装了进去)
public class JqGridSearchTo implements java.io.Serializable{
private String groupOp; //多字段查询时分组类型,主要是AND或者OR
private List rules; //多字段查询时候,查询条件的集合
private int page; //当前第几页
private int rows; //每页显示多少条数据
private String sidx; //排序字段
private String sord; //排序类型 ASC或者DESC
private boolean _search; //是否是查询 true 或者 false
private String nd; //暂时不清楚啥用的
private String searchField; //单字段查询的时候,查询字段名称
private String searchString; //单字段查询的时候,查询字段的值
private String searchOper; //单字段查询的时候,查询的操作
public JqGridSearchTo(){
}
......//省略Getter和Setter方法定义
}
然后定义jqGridSearchDetailTo对象,这个对象只是为多字段查询的rules中的查询条件设计的,相对非常简单:
public class JqGridSearchDetailTo implements java.io.Serializable{
private String field; //查询字段
private String op; //查询操作
private String data; //选择的查询值
public JqGridSearchDetailTo(){
}
......//省略Getter和Setter方法定义
}
这里需要说明一下,大家应该看到了,这两个类定义的属性和获取的json数据格式是一样的。这就方便json-lib进行转换。
然后大家看看Action中的执行方法类的定义:
@SuppressWarnings("unchecked")
public String queryAllBrand()
{
try
{
if(page == null ) page= "1";
if(sidx==null) sidx ="brandId";
if(rows==null) rows ="30";
if(sord==null) sord ="asc";
if(_search == null) _search="";
if(nd == null) nd = "0";
log.info("Page="+page+";sidx="+sidx+";rows="+rows+";sord="+sord+";_search="+_search+";nd="+nd);
log.info("searchField="+searchField+";searchValue="+searchString+";searchOper="+searchOper);
log.info("filters="+filters);
JqGridSearchTo to = new JqGridSearchTo();
if(_search.equals("true") && filters != null ){
JSONObject filt = JSONObject.fromObject(filters);
Map m = new HashMap();
m.put("rules", JqGridSearchDetailTo.class);
to = (JqGridSearchTo)JSONObject.toBean(filt, JqGridSearchTo.class, m);
log.info(to.toString());
}
to.setPage(Integer.parseInt(page));
to.setRows(Integer.parseInt(rows));
to.setSidx(sidx);
to.setSord(sord);
to.setSearchField(searchField);
to.setSearchOper(searchOper);
to.setSearchString(searchString);
to.set_search(Boolean.parseBoolean(_search));
PageModel pm = this.brandService.findAll(to);
//封装成JSON对象返回
HttpServletResponse response = ServletActionContext.getResponse();
response.setContentType("text/json; charset=UTF-8");
PrintWriter out = response.getWriter();
JSONObject ja = JSONObject.fromObject(pm);
out.print(ja.toString());
}
catch(Exception e)
{
e.printStackTrace();
}
return null;
}
这里需要说明一下的是:我们在转换jqGrid上传的json数据的时候,没有直接用JSONObject.toBean(filt,JqGridSearchTo.class)这种方式,而是首先定义了一个Map对象,并指定了rules转换的目标对象。这是因为如果不用Map指定rules的List包含的对象类,那么,json-lib默认会把rules的List中包含的对象转换成一个叫做ezmorphDynaBean的对象,而不会按照我们的定义转换成JqGridSearchDetailTo对象。
另外,相比于我上一篇文章中的转换对象为Json数据的方式,本文中直接使用了JSONObect.fromObject方法,是不是更简单了!!
然后就该重新设定一个方法来解析我们获取到的查询条件了。
/**
* 根据表名称的别名以及JqGridSearchTo的查询条件组合HQL语句
* @param alias 查询对象对应的别名
* @param to
* @return
*/
public static String getCombOperation(String alias,JqGridSearchTo to){
StringBuilder result = new StringBuilder("");
if (to != null) {
if(!to.get_search()){ //不是查询,则直接组合排序条件即可
result.append(" order by ");
result.append(alias);
result.append(".");
result.append(to.getSidx());
result.append(" "+to.getSord());
}
else if (to.get_search() && to.getSearchField() != null && to.getSearchOper() != null ) {
//只是单字段的查询
String cond = SearchOperationUtil.getOperation(to.getSearchField(), to.getSearchOper(), to.getSearchString());
if(cond != null && cond.trim().length() != 0){
result.append(" WHERE ");
result.append(alias);
result.append(".");
result.append(cond);
}
result.append(" order by ");
result.append(alias);
result.append(".");
result.append(to.getSidx());
result.append(" "+to.getSord());
}
else if (to.get_search() && to.getGroupOp() != null && to.getRules()!= null && to.getRules().size() != 0){
//多字段的组合查询
String groupOp = to.getGroupOp();
Iterator it = to.getRules().iterator();
result.append(" WHERE ");
int i = 0;
while (it.hasNext()) { //循环处理所有的查询条件
i++;
JqGridSearchDetailTo dto = (JqGridSearchDetailTo) it.next();
result.append(alias);
result.append(".");
result.append(SearchOperationUtil.getOperation(dto
.getField(), dto.getOp(), dto.getData()));
if (i < to.getRules().size())
result.append(" " + groupOp + " ");
}
result.append(" ORDER BY ");
result.append(alias);
result.append(".");
result.append(to.getSidx());
result.append(" "+to.getSord());
}
}
log.info(result.toString());
return result.toString();
}
OK,在最后看一下我们的Dao实现类是如何实现的吧。
@SuppressWarnings("unchecked")
public PageModel findAll(JqGridSearchTo to)
{
if (to == null )
return null;
Session s = null;
try
{
s = this.getSession();
int page = to.getPage();
int rows = to.getRows();
String whereCond = SearchOperationUtil.getCombOperation("brand", to);
//得到总记录数
String queryCountHql = "select count(*) from MProductBrand brand" + whereCond;
Query query = s.createQuery(queryCountHql);
int records = ((Long)query.uniqueResult()).intValue();
int offset = (page-1) * rows;
List datas = s.createQuery("from MProductBrand brand" + whereCond)
.setFirstResult(offset)
.setMaxResults(rows)
.list();
//得到结果集
PageModel pm = new PageModel();
int totalPage = records/rows;
if(records % rows > 0)
totalPage += 1;
pm.setTotal(totalPage);
pm.setRows(datas);
pm.setPage(page);
pm.setRecords(records);
return pm;
}
finally
{
if(s!=null)
s.close();
}
}
看起来比以前更简单了。
OK,That’s all !
以上部分代码存在一些隐患,请勿用于您的正式环境!