浅谈J-Hi查询过滤器的实现原理

　　J-Hi设计自己的查询过滤器而没有直接采用Hibernate的Criteria，是出于以下两个原因：

　　1、Hibernate的Criteria的功能是很强大，但在使用上还是比较繁琐。因此J-Hi想从用户使用的简单易用性上考虑设计一款查询过滤器。

　　2、J-Hi是一款跨ORM的多框架平台，不能拘泥一种只在Hibernate适用的产品。因此从设计角度考虑，J-Hi对于查询过滤功能必须要有一个中间层，从而使适应多ORM框架成为可能。

　　下面让我们来分析一下对于SQL的查询具体应该考虑些什么

　　1、字段名 数据库表的字段名

　　2、操作符 比如大于、小于。还会包括一些特殊的操作符如like和in

　　3、NO NO操作符是对操作符的补充，只有in和lik也会有no

　　4、值 对应字段类型的具体值，如字符串就要加引号，日期就要做转换

　　5、空值 空值是特殊值，表述形式如IS NULL或IS NOT NULL

　　6、关系符 两个查询条件之间的关系包括三种 AND OR NOT

　　7、优前级 通过左右括号来控制查询条件的优前级

　　8、通配符 如果是like操作符，在值的左侧或是右侧或两侧都可以通过%来控制值的匹配条件

　　对于java来说，无非就是考虑如何将上述的描述通过对象化的方式实现

　　先让我们用例说明：

   
   
   
   

    
    
    
       
    
    
    
    1
    
    
    
    . Filter filter 
    
    
    
    =
    
    
    
     FilterFactory.getSimpleFilter(
    
    
    
    "
    
    
    
    name
    
    
    
    "
    
    
    
    , 
    
    
    
    "
    
    
    
    马超
    
    
    
    "
    
    
    
    );  
   
   
   
   

　　首先所有的过滤器都必须由FilterFactory(过滤器工厂)创建，参数依次为

　　name：POJO的属性名的字符串,可以通过.级联如(org.id);

　　value：待过滤的过滤值

　　oprtion：操作符，提供多种操作符，具体参见javadoc

　　relation：关系符，两个过滤器之间的关系，如AND / OR / NOT

　　过滤器可以通过addCondition方法累加过滤条件，例如：

   
   
   
   

    
    
    
    filter.addCondition(
    
    
    
    "
    
    
    
    name
    
    
    
    "
    
    
    
    , 
    
    
    
    "
    
    
    
    赵云
    
    
    
    "
    
    
    
    , Filter.OPERATOR_EQ,Filter.RELATIO
   
   
   
   

　　调用addCondtion()方法返回是条件累加后的Filter，因此你可以一直不断的调用addCondtion()方法，而不用每做一个过滤条件就创建一个新的Flter。

　　也可以通过addFilter方法将两个过滤器连接合并在一起

   
   
   
   

    
    
    
    otherFilter.addFilter(filter, Filter.RELATION_AND);  
   
   
   
   

　　因为一个过滤器会有多个查询条件，因此在通过addFilter()将两上过滤器进行合并时会对这两个过滤器自动加左右括号。对应sql为：

   
   
   
   

    
    
    
       
    
    
    
    1
    
    
    
    . (otherFilter的查询条件) and (name like ‘
    
    
    
    %
    
    
    
    马超
    
    
    
    %
    
    
    
    ’ or name 
    
    
    
    =
    
    
    
     ‘赵云’ ) 
   
   
   
   

　　与addFilter对应，J-Hi还提供了removeFilter的功能，目的是通过目标过滤器中删除曾经加进来的子过滤器

   
   
   
   

    
    
    
    otherFilter.remove(filter); 
   
   
   
   

　　对字符串的操作，如果不加操作符那么系统默认采用like操作符，并且左右两侧均会加通配符，为了解决通配符的问题，J-Hi提供了

   
   
   
   

    
    
    
       
    
    
    
    1
    
    
    
    . Filter likeFilter 
    
    
    
    =
    
    
    
     FilterFactory.getLikeFilter(
    
    
    
    "
    
    
    
    name
    
    
    
    "
    
    
    
    , 
    
    
    
    "
    
    
    
    马超
    
    
    
    "
    
    
    
    , 
Filter.RELATION_AND, LikeFilter. LIKE_CONTROLER_LEFT ); 
   
   
   
   

　　对应的SQL语名为：name like ‘%马超’

　　如果对null或非null做过滤

   
   
   
   

    
    
    
    1
    
    
    
    . FilterFactory.getSimpleFilter(propertyName, 
    
    
    
    null
    
    
    
    , Filter.OPERATOR_EQ);      

    
    
    
    2
    
    
    
    . FilterFactory.getSimpleFilter(propertyName, 
    
    
    
    null
    
    
    
    , Filter.OPERATOR_NOT_EQ);  
   
   
   
   

　　对应的SQL语句分别为：propertyName IS NULL ; propertyName IS NOT NULL

　　如果做包含(IN)做过滤

   
   
   
   

    
    
    
    FilterFactory.getInFilter(propertyName, coll); 
   
   
   
   

　　其中coll是java.util.Collection接口的对象

　　除此以外，J-Hi还提供了排序器

   
   
   
   

    
    
    
    1
    
    
    
    . Sorter sorter 
    
    
    
    =
    
    
    
     SorterFactory.getSimpleSort(propertyName, Sorter.ORDER_DESC);     
    
    
    
    
2
    
    
    
    . Sorter.addSort(properyName1, Sorter.ORDER_ASC);  
   
   
   
   

　　首先所有的排序器都必须由SorterFactory(过滤器工厂)创建，排序器可以通过addSort方法累加。也可以通过addSort方法将两个排序器连接合并在一起。

　　具体的调用方法例如：

   
   
   
   

    
    
    
       
    
    
    
    1
    
    
    
    . HiUserManager userMgr 
    
    
    
    =
    
    
    
     (HiUserManager)SpringContextHolder.getBean(HiUser.
    
    
    
    class
    
    
    
    );      
   
    
    
    
    2
    
    
    
    . userMger.getObjects(filter,sorter);  
   
   
   
   

　　总结：J-Hi的查询过滤器并没有象Hibernate的Criteria那么的强大，还不支持外连接与聚合。原因是这种大数据量的统计对ORM框架来实现在效率上并不是好的解决方案，再者实现上述功能增加了使用者操作的复杂度。荐于以上两个原因J-Hi的查询过滤器没有实现上述功能。