Hibernate--Criteria Query and DetachedCriteria

Criteria Query通过面向对象的设计，将数据查询条件封装为一个对象。简单来说，Criteria Query可以看作是传统SQL的对象化表示，如：

Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Expression.eq("name","Erica"));
criteria.add(Expression.eq("sex",new Integer(1));

这里的criteria实例本质上是对SQL“select * from t_user where name='Erica' and sex=1”的封装。

Hibernate在运行期会根据Criteria中指定的查询条件生成相应的SQL语句。

Criteria查询表达式

    Criteria本身只是一个容器，具体的查询条件要通过Criteria.add方法添加到Criteria实例中。

方法 描述

Expression.eq

对应SQL “field=value”表达式

如：Expression.eq("name","Erica")

Expression.allEq 参数为一个Map对象，其中包含了多个属性-值对应关系。相当于多个Expression.eq关系的叠加

Expression.gt 对应SQL“field>value”表达式

Expression.ge 对应SQL“field>=value”表达式

Expression.lt 对应SQL“field<value”表达式

Expression.le 对应SQL“field<=value”表达式

Expression.between

对应SQL“between”表达式

如：Expression.between("age",new Integer(13),new Integer(50));

Expression.like 对应SQL"field like valule"表达式

Expression.in 对应SQL“field in...”表达式

Expression.eqproperty 用于比较两个属性之间的值，对应SQL“field>field”

Expression.gtProperty 用于比较两个属性之间的值，对应SQL“field>=field”

Expression.ltProperty 用于比较两个属性之间的值，对应SQL"field<field"

Expression.leProperty 用于比较两个属性之间的值，对应SQL"field<=field"

Expression.and

and关系组合，如：

Expression.add(Expression.eq("name","Erica"),Expression.add("sex",new Integer(1)))

Expression.or

or关系组合，如：

Expression.or(Expression.eq("name","Erica"),Expression.add("sex",new Integer(1)))

Expression.sql

作为补充，本方法提供了原生SQL语法的支持，我们可以通过这个方法直接通过SQL语句限定查询条件

下面的代码返回所有名称以"Erica"其实的记录：

Expression.sql("lower({alias}.name) like lower(?)","Erica%",Hibernate.STRING);

其中的"{alias}"将Hibernate在运行期使用当前关联的POJO别名替换

在Hibernate3中，引入了Restrictions类作为Expression的替代。

示例查询

    Example类实现了Criteria接口，同样，它也可以用作Criteria的查询条件。Example的作用是：根据已有对象，查找属性与之相符的其他对象。

Criteria criteria=session.CreateCriteria(TUser.class);
TUser exampleUser=new TUser();
exapleUser.getName("Erica");
criteria.add(Example.create(exampleUser));
List<TUser> list=criteria.list();
for(TUser user:list){
System.out.println(user.getName());
}

新建一个TUser对象exampleUser，并作为范本，查询所有name属性与之相同的记录。

复合查询

Criteria criteria=session.createCriteria(TUser.class);
Criteria addrCriteria=criteria.createCriteria("addresses");
addrCriteria.add(Expression.like("addresses","%shanghai%"));
List<TUser> list = criteria.list();
for(TUser user:list){
    System.out.println(user.getName());
    Set<TAddress> addrSet=user.getAddresses();
    for(TAddress addr:addrSet){
        System.out.println(addr.getAddress());
    }
}

红色部分就是我们新增的复合查询条件，可以看到，我们可以通过Criteria.createCriteria方法在原有Criteria对象的基础上构建复合查询。

DetachedCriteria

   Hibernate2中，Criteria生命周期位于其宿主Session生命周期中，也就是说，由某个session创建的Criteria实例，一旦session销毁，那么此Criteria实例也随之失效。

    Hibernate3中引入了DetachedCriteria，DetachedCriteria可以脱离session实例独立存在，这样，我们就可以将某些通用的Criteria查询条件进行抽离，每次使用时再与当前session实例绑定以获得更好的代码重用效果。

DetachedCriteria deCriteria=DetachedCriteria.forClass(TUser.class);
deCriteria.add(Expression.eq("name","Erica"));
deCriteria.add(Expression.eq("sex",new Integer(1)));
Criteria criteria=deCriteria.getExecutableCriteria(session);
List<TUser> list=criteria.list();
for(TUser user:list){
    System.out.println(user.getName());
}

DetachedCriteria的生存周期与session实例无关，我们可以独立创建DetachedCriteria实例，并在需要使用时与session相绑定，从而获得运行期Criteria实例。这样，我们就可以将查询逻辑和Criteria实例分离，以获得最大化代码的重用效果。

    DetachedCriteria也可以用于子查询表达：

DetachedCriteria aveAge=DetachedCriteria.forClass(TUser.class);
avgAge.setProjection(Projections.avg("age"));
Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Subqueries.propertyGT("age",avgAge));

通过Subqueries我们可以将DetachedCriteria纳入查询表达式，反映在SQL上则是一个典型的子查询语句。上例生成的SQL语句大致如：select ... from T_User where age > (select avg(age) from T_User)

Criteria高级特性

    限定返回的记录范围

        通过criteria.setFirstResult/setMaxResults方法可以限制一次查询返回的记录范围：

Criteria criteria=session.createCriteria(TUser.class);

//限定查询返回检索结果中，从100条结果开始的20条记录

criteria.setFirstResult(100);

criteria.setMaxResults(20);

        记录排序：

//

//

Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Expression.eq("groupId",new Integer(2)));
criteria.addOrder(Order.asc("name"));
criteria.addOrder(Order.desc("groupId"));

    分组与统计

        在Hibernate3中，我们还可以通过Criteria完成分组和统计。分组、统计表达式由Hibernate3新引入的Projections Class进行封装。

C

riteria criteria=session.createCriteria(TUser.class);
criteria.setProjection(Projections.groupProperty("age"));
List<TUser> list=criteria.list();
for(TUser user:list){
    System.out.println(user);
}

上例对当前的TUser记录按照年龄进行分组。通过Projections.groupProperty方法，我们指定了用于分组的目标属性“age”。生成的SQL语句：select this.age as y0_ from T_User this_group by this_.age。

    另外，对于多条件组合的统计、分组功能，我们可以借助ProjectionList完成，下面的例子中，我们统计了各个年龄层次中的用户数量：

ProjectionList projectionlist=Projections.ProjectionList();
projectionList.add(Projections.groupProperty("age"));
projectionList.add9Projections.rowCount());
Criteria criteria=session.createCriteria(TUser.class);
criteria.setProjection(projectionList);