Hibernate中Criteria的完整用法 （转）
最近在项目中使用 Spring 和 Hibernate 进行开发，有感于 Criteria 比较好用，在查询方法
设计上可以灵活的根据Criteria的特点来方便地进行查询条件的组装。现在对Hibernate的Criteria的用法进行总结：
Hibernate设计了CriteriaSpecification作为Criteria的父接口，下面提供了Criteria和DetachedCriteria。
Criteria和DetachedCriteria的主要区别在于创建的形式不一样，Criteria是在线的，所
以它是由HibernateSession进行创建的；而DetachedCriteria是离线的，创建时无需
Session，DetachedCriteria提供了2个静态方法forClass(Class)或forEntityName(Name)
进行DetachedCriteria实例的创建。Spring的框架提供了getHibernateTemplate
().findByCriteria(detachedCriteria)方法可以很方便地根据DetachedCriteria来返回查询结
果。
Criteria和DetachedCriteria均可使用Criterion和Projection设置查询条件。可以设
置FetchMode(联合查询抓取的模式)，设置排序方式。对于Criteria还可以设置FlushModel
（冲刷Session的方式）和LockMode（数据库锁模式）。
下面对Criterion和Projection进行详细说明。
Criterion是Criteria的查询条件。Criteria提供了add(Criterioncriterion)方法来
添加查询条件。
Criterion接口的主要实现包括：Example、Junction和SimpleExpression。而
Junction的实际使用是它的两个子类conjunction和disjunction，分别是使用AND和OR操
作符进行来联结查询条件集合。
Criterion的实例可以通过Restrictions工具类来创建，Restrictions提供了大量的静态
方法，如eq（等于）、ge（大于等于）、between等来方法的创建Criterion查询条件
（SimpleExpression实例）。除此之外，Restrictions还提供了方法来创建conjunction和
disjunction实例，通过往该实例的add(Criteria)方法来增加查询条件形成一个查询条件集合
。
至于Example的创建有所不同，Example本身提供了一个静态方法create(Object
entity)，即根据一个对象（实际使用中一般是映射到数据库的对象）来创建。然后可以设置一些
过滤条件：
ExampleexampleUser=Example.create(u)
.ignoreCase()//忽略大小写
.enableLike(MatchMode.ANYWHERE);
//对String类型的属性，无论在那里值在那里都匹配。相当于%value%
Project主要是让Criteria能够进行报表查询，并可以实现分组。Project主要有
SimpleProjection、ProjectionList和Property三个实现。其中SimpleProjection和
ProjectionList的实例化是由内建的Projections来完成，如提供的avg、count、max、
min、sum可以让开发者很容易对某个字段进行统计查询。
Property是对某个字段进行查询条件的设置，如通过Porperty.forName(“color”).in
(newString[]{“black”,”red”,”write”});则可以创建一个Project实例。通过
criteria的add(Project)方法加入到查询条件中去。
使用Criteria进行查询，主要要清晰的是Hibernate提供了那些类和方法来满足开发中查
询条件的创建和组装，下面介绍几种用法：
1.创建一个Criteria实例
org.hibernate.Criteria接口表示特定持久类的一个查询。Session是Criteria实例的工厂。
Criteriacrit=sess.createCriteria(Cat.class);
crit.setMaxResults(50);
Listcats=crit.list();
2.限制结果集内容
一个单独的查询条件是org.hibernate.criterion.Criterion接口的一个实例。
org.hibernate.criterion.Restrictions类定义了获得某些内置Criterion类型的工厂方法。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","Fritz%"))
.add(Restrictions.between("weight",minWeight,maxWeight))
.list();
约束可以按逻辑分组。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","Fritz%"))
.add(Restrictions.or(
Restrictions.eq("age",newInteger(0)),
Restrictions.isNull("age")
))
.list();
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.in("name",newString[]{"Fritz","Izi","Pk"}))
.add(Restrictions.disjunction()
.add(Restrictions.isNull("age"))
.add(Restrictions.eq("age",newInteger(0)))
.add(Restrictions.eq("age",newInteger(1)))
.add(Restrictions.eq("age",newInteger(2)))
))
.list();
Hibernate提供了相当多的内置criterion类型(Restrictions子类),但是尤其有用的是可以允许
你直接使用SQL。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.sql("lower({alias}.name)likelower(?)","Fritz%",
Hibernate.STRING))
.list();
{alias}占位符应当被替换为被查询实体的列别名。
Property实例是获得一个条件的另外一种途径。你可以通过调用Property.forName()创建一个
Property。
Propertyage=Property.forName("age");
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.disjunction()
.add(age.isNull())
.add(age.eq(newInteger(0)))
.add(age.eq(newInteger(1)))
.add(age.eq(newInteger(2)))
))
.add(Property.forName("name").in(newString[]{"Fritz","Izi","Pk"}))
.list();
3.结果集排序
你可以使用org.hibernate.criterion.Order来为查询结果排序。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","F%")
.addOrder(Order.asc("name"))
.addOrder(Order.desc("age"))
.setMaxResults(50)
.list();
Listcats=sess.createCriteria(Cat.class)
.add(Property.forName("name").like("F%"))
.addOrder(Property.forName("name").asc())
.addOrder(Property.forName("age").desc())
.setMaxResults(50)
.list();
4.关联
你可以使用createCriteria()非常容易的在互相关联的实体间建立约束。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","F%")
.createCriteria("kittens")
.add(Restrictions.like("name","F%")
.list();
注意第二个createCriteria()返回一个新的Criteria实例，该实例引用kittens集合中的元素。
接下来，替换形态在某些情况下也是很有用的。
Listcats=sess.createCriteria(Cat.class)
.createAlias("kittens","kt")
.createAlias("mate","mt")
.add(Restrictions.eqProperty("kt.name","mt.name"))
.list();
(createAlias()并不创建一个新的Criteria实例。)
Cat实例所保存的之前两次查询所返回的kittens集合是没有被条件预过滤的。如果你希望只获得
符合条件的kittens，你必须使用returnMaps()。
Listcats=sess.createCriteria(Cat.class)
.createCriteria("kittens","kt")
.add(Restrictions.eq("name","F%"))
.returnMaps()
.list();
Iteratoriter=cats.iterator();
while(iter.hasNext()){
Mapmap=(Map)iter.next();
Catcat=(Cat)map.get(Criteria.ROOT_ALIAS);
Catkitten=(Cat)map.get("kt");
}
5.动态关联抓取
你可以使用setFetchMode()在运行时定义动态关联抓取的语义。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","Fritz%"))
.setFetchMode("mate",FetchMode.EAGER)
.setFetchMode("kittens",FetchMode.EAGER)
.list();
这个查询可以通过外连接抓取mate和kittens。
6.查询示例
org.hibernate.criterion.Example类允许你通过一个给定实例构建一个条件查询。
Catcat=newCat();
cat.setSex('F');
cat.setColor(Color.BLACK);
Listresults=session.createCriteria(Cat.class)
.add(Example.create(cat))
.list();
版本属性、标识符和关联被忽略。默认情况下值为null的属性将被排除。
可以自行调整Example使之更实用。
Exampleexample=Example.create(cat)
.excludeZeroes()//excludezerovaluedproperties
.excludeProperty("color")//excludethepropertynamed"color"
.ignoreCase()//performcaseinsensitivestringcomparisons
.enableLike();//uselikeforstringcomparisons
Listresults=session.createCriteria(Cat.class)
.add(example)
.list();
甚至可以使用examples在关联对象上放置条件。
Listresults=session.createCriteria(Cat.class)
.add(Example.create(cat))
.createCriteria("mate")
.add(Example.create(cat.getMate()))
.list();
7.投影(Projections)、聚合（aggregation）和分组（grouping）
org.hibernate.criterion.Projections是Projection的实例工厂。我们通过调用
setProjection()应用投影到一个查询。
Listresults=session.createCriteria(Cat.class)
.setProjection(Projections.rowCount())
.add(Restrictions.eq("color",Color.BLACK))
.list();
Listresults=session.createCriteria(Cat.class)
.setProjection(Projections.projectionList()
.add(Projections.rowCount())
.add(Projections.avg("weight"))
.add(Projections.max("weight"))
.add(Projections.groupProperty("color"))
)
.list();
在一个条件查询中没有必要显式的使用"groupby"。某些投影类型就是被定义为分组投影，他
们也出现在SQL的groupby子句中。
可以选择把一个别名指派给一个投影，这样可以使投影值被约束或排序所引用。下面是两种不同的
实现方式：
Listresults=session.createCriteria(Cat.class)
.setProjection(Projections.alias(Projections.groupProperty("color"),"colr"))
.addOrder(Order.asc("colr"))
.list();
List results = session.createCriteria(Cat.class)
.setProjection(Projections.groupProperty("color").as("colr"))
.addOrder(Order.asc("colr"))
.list();
alias()和as()方法简便的将一个投影实例包装到另外一个别名的Projection实例中。简而言之，
当你添加一个投影到一个投影列表中时你可以为它指定一个别名：
Listresults=session.createCriteria(Cat.class)
.setProjection(Projections.projectionList()
.add(Projections.rowCount(),"catCountByColor")
.add(Projections.avg("weight"),"avgWeight")
.add(Projections.max("weight"),"maxWeight")
.add(Projections.groupProperty("color"),"color")
)
.addOrder(Order.desc("catCountByColor"))
.addOrder(Order.desc("avgWeight"))
.list();
Listresults=session.createCriteria(Domestic.class,"cat")
.createAlias("kittens","kit")
.setProjection(Projections.projectionList()
.add(Projections.property("cat.name"),"catName")
.add(Projections.property("kit.name"),"kitName")
)
.addOrder(Order.asc("catName"))
.addOrder(Order.asc("kitName"))
.list();
也可以使用Property.forName()来表示投影：
Listresults=session.createCriteria(Cat.class)
.setProjection(Property.forName("name"))
.add(Property.forName("color").eq(Color.BLACK))
.list();
Listresults=session.createCriteria(Cat.class)
.setProjection(Projections.projectionList()
.add(Projections.rowCount().as("catCountByColor"))
.add(Property.forName("weight").avg().as("avgWeight"))
.add(Property.forName("weight").max().as("maxWeight"))
.add(Property.forName("color").group().as("color")
)
.addOrder(Order.desc("catCountByColor"))
.addOrder(Order.desc("avgWeight"))
.list();
8.离线(detached)查询和子查询
DetachedCriteria类使你在一个session范围之外创建一个查询，并且可以使用任意的Session来
执行它。
DetachedCriteriaquery=DetachedCriteria.forClass(Cat.class)
.add(Property.forName("sex").eq('F'));
//创建一个Session
Sessionsession=.;
Transactiontxn=session.beginTransaction();
Listresults=query.getExecutableCriteria(session).setMaxResults(100).list();
txn.commit();
session.close();
DetachedCriteria也可以用以表示子查询。条件实例包含子查询可以通过Subqueries或者
Property获得。
DetachedCriteriaavgWeight=DetachedCriteria.forClass(Cat.class)
.setProjection(Property.forName("weight").avg());
session.createCriteria(Cat.class)
.add(Property.forName("weight).gt(avgWeight))
.list();
DetachedCriteriaweights=DetachedCriteria.forClass(Cat.class)
.setProjection(Property.forName("weight"));
session.createCriteria(Cat.class)
.add(Subqueries.geAll("weight",weights))
.list();
相互关联的子查询也是有可能的：
DetachedCriteriaavgWeightForSex=DetachedCriteria.forClass(Cat.class,"cat2")
.setProjection(Property.forName("weight").avg())
.add(Property.forName("cat2.sex").eqProperty("cat.sex"));
session.createCriteria(Cat.class,"cat")
.add(Property.forName("weight).gt(avgWeightForSex))
.list();