Criterion和Criteria

              Hibernate Criterion是Criteria的查询条件。Criteria 提供了add(Criterion criterion)方法来添加查询条件。Criteria 的特点来方便地进行查询条件的组装。

 

              Criteria的常用方法：

 

              1. 创建一个Criteria 实例
            org.hibernate.Criteria接口表示特定持久类的一个查询。Session是 Criteria实例的工厂。
           Criteria crit = sess.createCriteria(Cat.class);
           crit.setMaxResults(50);
           List cats = crit.list();

             2. 限制结果集内容
           一个单独的查询条件是org.hibernate.criterion.Criterion 接口的一个实例。
           org.hibernate.criterion.Restrictions类定义了获得某些内置Criterion类型的工厂方法。
           List cats = sess.createCriteria(Cat.class).add( Restrictions.like("name", "Fritz%") )
.add( Restrictions.between("weight", minWeight, maxWeight) ).list();

           约束也可以按逻辑分组。 

           List cats = sess.createCriteria(Cat.class).add( Restrictions.like("name", "Fritz%") )
.add( Restrictions.or(
           Restrictions.eq( "age", new Integer(0) ),
           Restrictions.isNull("age")
 ) ).list();
 
           List cats = sess.createCriteria(Cat.class).add( Restrictions.in( "name", new String[] { "Fritz", "Izi", "Pk" } ) ).add( Restrictions.disjunction()
          .add( Restrictions.isNull("age") )
          .add( Restrictions.eq("age", new Integer(0) ) )
          .add( Restrictions.eq("age", new Integer(1) ) )
          .add( Restrictions.eq("age", new Integer(2) ) )
 ) ).list();

 

           3. 结果集排序
          使用org.hibernate.criterion.Order来为查询结果排序。 
           List cats = sess.createCriteria(Cat.class).add( Restrictions.like("name", "F%")
.addOrder( Order.asc("name") ).addOrder( Order.desc("age") ).setMaxResults(50)
.list();
 
           List cats = 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()很容易的在互相关联的实体间建立约束。
           List cats = sess.createCriteria(Cat.class) .add( Restrictions.like("name", "F%")
.createCriteria("kittens").add( Restrictions.like("name", "F%").list();

           5. 查询示例
           org.hibernate.criterion.Example类允许通过一个给定实例来构建一个条件查询。     

           Cat cat = new Cat();
           cat.setSex('F');
           cat.setColor(Color.BLACK);
           List results = session.createCriteria(Cat.class).add( Example.create(cat) ) .list();

           6. 投影(Projections)、聚合（aggregation）和分组（grouping）
           org.hibernate.criterion.Projections是 Projection 的实例工厂。一般通过调用 
setProjection()应用投影到一个查询。 
           List results = session.createCriteria(Cat.class).setProjection( Projections.rowCount() ).add( Restrictions.eq("color", Color.BLACK) ).list();
           List results = session.createCriteria(Cat.class).setProjection( Projections.projectionList()
          .add( Projections.rowCount() )
          .add( Projections.avg("weight") )
          .add( Projections.max("weight") )
          .add( Projections.groupProperty("color") )).list();
   在一个条件查询中没有必要显式的使用 "group by" 。某些投影类型就是被定义为分组投影，而这些投影类型也出现在SQL的group by子句中。 可以选择把一个别名指派给一个投影，这样可以使投影值被约束或排序所引用。 

          下面是两种不同的实现方式：

           List results = 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实例中。简而言之，当你添加一个投影到一个投影列表中时你可以为它指定一个别名：

 

           List results = 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();
        

          List results = 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();