Hibernate createCriteria查询详解

1、创建一个Criteria实例 
net.sf.hibernate.Criteria这个接口代表对一个特定的持久化类的查询。Session是用来制造Criteria实例的工厂。 

Criteria crit = sess.createCriteria(Cat.class); 
crit.setMaxResults(50); 
List cats = crit.list(); 

2、缩小结果集范围 
一个查询条件(Criterion)是net.sf.hibernate.expression.Criterion接口的一个实例。类net.sf.hibernate.expression.Expression定义了获得一些内置的Criterion类型。 

List cats = sess.createCriteria(Cat.class) 
    .add( Expression.like("name", "Fritz%") ) 
    .add( Expression.between("weight", minWeight, maxWeight) ) 
    .list(); 
表达式（Expressions）可以按照逻辑分组. 

List cats = sess.createCriteria(Cat.class) 
    .add( Expression.like("name", "Fritz%") ) 
    .add( Expression.or( 
     Expression.eq( "age", new Integer(0) ), 
     Expression.isNull("age") 
    ) ) 
    .list(); 
List cats = sess.createCriteria(Cat.class) 
    .add( Expression.in( "name", new String[] { "Fritz", "Izi", "Pk" } ) ) 
    .add( Expression.disjunction() 
        .add( Expression.isNull("age") ) 
     .add( Expression.eq("age", new Integer(0) ) ) 
     .add( Expression.eq("age", new Integer(1) ) ) 
     .add( Expression.eq("age", new Integer(2) ) ) 
    ) ) 
    .list(); 
有很多预制的条件类型（Expression的子类）。有一个特别有用，可以让你直接嵌入SQL。 

List cats = sess.createCriteria(Cat.class) 
    .add( Expression.sql("lower($alias.name) like lower(?)", "Fritz%", Hibernate.STRING) ) 
    .list(); 
其中的{alias}是一个占位符，它将会被所查询实体的行别名所替代。(原文:The {alias} placeholder with be replaced by the row alias of the queried entity.) 

3、对结果排序 
可以使用net.sf.hibernate.expression.Order对结果集排序. 

List cats = sess.createCriteria(Cat.class) 
    .add( Expression.like("name", "F%") 
    .addOrder( Order.asc("name") ) 
    .addOrder( Order.desc("age") ) 
    .setMaxResults(50) 
    .list(); 
4、关联（Associations） 
你可以在关联之间使用createCriteria()，很容易地在存在关系的实体之间指定约束。 

List cats = sess.createCriteria(Cat.class) 
    .add( Expression.like("name", "F%") 
    .createCriteria("kittens") 
        .add( Expression.like("name", "F%") 
    .list(); 
注意，第二个createCriteria()返回一个Criteria的新实例，指向kittens集合类的元素。 

下面的替代形式在特定情况下有用。 

List cats = sess.createCriteria(Cat.class) 
    .createAlias("kittens", "kt") 
    .createAlias("mate", "mt") 
    .add( Expression.eqProperty("kt.name", "mt.name") ) 
    .list(); 
（createAlias()）并不会创建一个Criteria的新实例。） 

请注意，前面两个查询中Cat实例所持有的kittens集合类并没有通过criteria预先过滤！如果你希望只返回满足条件的kittens,你必须使用returnMaps()。 

List cats = sess.createCriteria(Cat.class) 
    .createCriteria("kittens", "kt") 
        .add( Expression.eq("name", "F%") ) 
    .returnMaps() 
    .list(); 
Iterator iter = cats.iterator(); 
while ( iter.hasNext() ) { 
    Map map = (Map) iter.next(); 
    Cat cat = (Cat) map.get(Criteria.ROOT_ALIAS); 
    Cat kitten = (Cat) map.get("kt"); 
} 
5、动态关联对象获取（Dynamic association fetching） 
可以在运行时通过setFetchMode()来改变关联对象自动获取的策略。 

List cats = sess.createCriteria(Cat.class) 
    .add( Expression.like("name", "Fritz%") ) 
    .setFetchMode("mate", FetchMode.EAGER) 
    .list(); 
这个查询会通过外连接(outer join)同时获得 mate和kittens。 

6、根据示例查询（Example queries） 
net.sf.hibernate.expression.Example类允许你从指定的实例创造查询条件。 

Cat cat = new Cat(); 
cat.setSex('F'); 
cat.setColor(Color.BLACK); 
List results = session.createCriteria(Cat.class) 
    .add( Example.create(cat) ) 
    .list(); 
版本属性，表示符属性和关联都会被忽略。默认情况下，null值的属性也被排除在外。 

You can adjust how the Example is applied. 你可以调整示例(Example)如何应用。 

Example example = Example.create(cat) 
    .excludeZeroes()           //exclude zero valued properties 
    .excludeProperty("color")  //exclude the property named "color" 
    .ignoreCase()              //perform case insensitive string comparisons 
    .enableLike();             //use like for string comparisons 
List results = session.createCriteria(Cat.class) 
    .add(example) 
    .list(); 
你甚至可以用示例对关联对象建立criteria。 

List results = session.createCriteria(Cat.class) 
    .add( Example.create(cat) ) 
    .createCriteria("mate") 
        .add( Example.create( cat.getMate() ) ) 
    .list();