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进行封装。
Criteria 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);
posted on 2008-05-10 22:59
Kira-2006 阅读(798)
评论(0) 编辑 收藏 所属分类:
hibernate