Hibernate 的Criteria
1、Criteria
Hibernate设计了CriteriaSpecification作为Criteria的父接口，下面提供了Criteria和DetachedCriteria。
2、DetachedCriteria
Spring的框架提供了getHibernateTemplate().findByCriteria(detachedCriteria)方法可以很方便地根据DetachedCriteria来返回查询结果。DetachedCriteria提供了2个静态方法forClass(Class)或forEntityName(Name)进行DetachedCriteria实例的创建。
3、Criteria和DetachedCriteria比较
3.1、Criteria和DetachedCriteria的主要区别在于创建的形式不一样
Criteria是在线的，是由HibernateSession进行创建的；而DetachedCriteria是离线的，创建时无需Session；
3.2、Criteria与Session绑定，其生命周期跟随着Session结束而结束，使用Criteria时进行查询时，每次都要于执行时期动态建立物件，并加入各种查询条件，随着Session的回收，Criteria也跟着回收。
3.3、Criteria和DetachedCriteria均可使用Criterion和Projection设置查询条件。可以设置FetchMode(联合查询抓取的模式)，设置排序方式。对于Criteria还可以设置FlushModel（冲刷Session的方式）和LockMode（数据库锁模式）。
4、Criterion和Projection
4.1、概念
Criterion是Criteria的查询条件。Criteria提供了add(Criterioncriterion)方法来添加查询条件。
Criterion接口的主要实现包括：Example、Junction和SimpleExpression。
Junction的实际使用是它的两个子类conjunction和disjunction，分别是使用AND和OR操作符进行来联结查询条件集合。
4.2、创建
Criterion的实例可以通过Restrictions工具类来创建，Restrictions提供了大量的静态方法，如eq（等于）、ge（大于等于）、between等来方法的创建Criterion查询条件（SimpleExpression实例）。除此之外，Restrictions还提供了方法来创建conjunction和disjunction实例，通过往该实例的add(Criteria)方法来增加查询条件形成一个查询条件集合。
至于Example的创建有所不同，Example本身提供了一个静态方法create(Objectentity)，即根据一个对象（实际使用中一般是映射到数据库的对象）来创建。然后可以设置一些
过滤条件：
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)方法加入到查询条件中去。
5、具体用法
使用Criteria进行查询，主要要清晰的是Hibernate提供了那些类和方法来满足开发中查
询条件的创建和组装，下面介绍几种用法：
5.1、创建一个Criteria实例
org.hibernate.Criteria接口表示特定持久类的一个查询。Session是Criteria实例的工厂。
Criteriacrit=sess.createCriteria(Cat.class);
crit.setMaxResults(50);
Listcats=crit.list();
5.2、设置查询条件
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","Fritz%"))//设置查询条件
.add(Restrictions.or(Restrictions.eq("age",newInteger(0)),Restrictions.isNull("age")))//逻辑条件
.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();
分页查询
Criteria的setMaxResults()方法可以设定查询的最大结果集，setFirstResult()设定查询的起始位置，通过上述两个方法就可以实现简单的分页
Criteriacriteria=session.createCriteria(User.class);
criteria.setFirstResult(1).criteria.setMaxResults(10).list();
Hibernate提供了相当多的内置criterion类型(Restrictions子类),但是尤其有用的是可以允许你直接使用SQL。
Criteriacriteria=session.createCriteria(Cat.class)
criteria.add(Restrictions.sql("lower({alias}.name)likelower(?)","Fritz%",Hibernate.STRING)).list();
{alias}占位符应当被替换为被查询实体的列别名。
Restrictions的常用条件所示：
Restrictions.eq-->equal,等于.
Restrictions.allEq-->参数为Map对象,使用key/value进行多个等于的比对,相当于多个Restrictions.eq的效果
Restrictions.gt-->great-than>大于
Restrictions.ge-->great-equal>=大于等于
Restrictions.lt-->less-than,<小于
Restrictions.le-->less-equal<=小于等于
Restrictions.between-->对应SQL的between子句
Restrictions.like-->对应SQL的LIKE子句
Restrictions.in-->对应SQL的in子句
Restrictions.and-->and关系
Restrictions.or-->or关系
Restrictions.isNull-->判断属性是否为空,为空则返回true相当于SQL的isnull
Restrictions.isNotNull-->与isNull相反相当于SQL的isnotnull
Restrictions.sqlRestriction-->SQL限定的查询
Order.asc-->根据传入的字段进行升序排序
Order.desc-->根据传入的字段进行降序排序
MatchMode.EXACT-->字符串精确匹配.相当于"like'value'"
MatchMode.ANYWHERE-->字符串在中间匹配.相当于"like'%value%'"
MatchMode.START-->字符串在最前面的位置.相当于"like'value%'"
MatchMode.END-->字符串在最后面的位置.相当于"like'%value'"
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();
5.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(Restrictions.liek("name","F",MatchMode.ANYWHERE));
.addOrder(Property.forName("name").asc())
.addOrder(Property.forName("age").desc())
.setMaxResults(50)
.list();
5.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.5、动态关联抓取
你可以使用setFetchMode()在运行时定义动态关联抓取的语义。
Listcats=sess.createCriteria(Cat.class)
.add(Restrictions.like("name","Fritz%"))
.setFetchMode("mate",FetchMode.EAGER)
.setFetchMode("kittens",FetchMode.EAGER)
.list();
这个查询可以通过外连接抓取mate和kittens。
5.6、Example
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();
5.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();
Listresults=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();