Hibernate QBC查询

转载自iteye的iorit2003博客

QBC查询：

  QBC 查询就是通过使用 Hibernate 提供的 Query By Criteria API 来查询对象，这种 API 封装了 SQL 语句的动态拼装，对查询提供了更加面向对象的功能接口。我们看下面的示例程序：

Criteria criteria=session.createCriteria(User.class);

criteria.add(Expression.eq(“name”,”zx”));

criteria.add(Expression.eq(“age”,new Integer(27));

List list=criteria.list();

当执行 criteria.list() 时会生成类似这样的 SQL 语句： Select * from user where name=’zx’ and age=27; 所以在这里我们可以看出， Criteria 实际上是一个查询容器，它对查询条件表达式的添加进行了封装，具体的查询条件是通过 add() 方法添加的，而且具体的查询条件的表达式运算是通过 Expression 指定的。 Hibernate 在运行期会根据 Criteria 指定的表达式条件来添加查询条件，并且生成查询语句。这种方式非常符合 Java 以及所有面向对象编程语言的编程方式，所以大多数的持久层框架都提供了对这种方式查询的支持。下面我们讲解这种查询方式的各个技术细节。

1、 Criteria 查询表达式：

正如我们所见， Expression 对查询语句的表达式进行了封装和限制，下表列出了 Expression 所有的方法，以及每个方法所对应的查询表达式及其限制。

方法	描述
Expression.eq	对应 SQL 的“ field=value ”表达式 如： Expression.eq(“name”,”zx”);
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表达式，如：查询年龄在21与27岁之间的用户，可以写成Expression.between(“age”,new Integer(21),new Integer(27));
Expression.like	对应SQL语句的”field like value”表达式
Expression.in	对应SQL语句的“field in(……)”表达式
Expression.eqProperty	用于比较两个属性值，对应”field=field”SQL表达式
Expression.gtProperty	用于比较两个属性值，对应”field>field”SQL表达式
Expression.geProperty	用于比较两个属性值，对应”field>=field”SQL表达式
Expression.ltProperty	用于比较两个属性值，对应”field<field”SQL表达式
Expression.leProperty	用于比较两个属性值，对应”field<=field”SQL表达式
Expression.and	对应SQL语句的And关系组合，如：Expression.and(Expression.eq(“name”,”zx”),Expression.eq(“sex”,”1”));
Expression.or	对应SQL语句的Or关系组合，如：Expression.or(Expression.eq(“name”,”zx”),Expression.eq(“name”,”zhaoxin”));
Expression.sql	作为补充这个方法提供了原生SQL语句查询的支持，在执行时直接通过原生SQL语句进行限定，如：Expression.sql(“lower({alias}.name) like (?)”,“zhao%”,Hibernate.STRING) ;在运行时{ alias }将会由当前查询所关联的实体类名替换，()中的?将会由”zhao%”替换，并且类型由Hibernate.STRING指定。

注意： Expression 各方法中的属性参数（各方法中的第一个参数）所指定的属性名称（如： name,sex ），并不是数据库表中的实际字段名称，而是实体对象中映射实际数据表字段的类属性名称。

2、 示例查询：

示例查询是通过 Example 类来完成的， Example 类实现了 Criterion 接口，可以用作 Criteria 查询条件， Example 类的作用是：根据已有对象，查询属性值与之相同的其他对象。如下代码所示：

Criteria criteria=session.createCriteria(User.class);

User exampleuser=new User(“zx”);

criteria.add(Example.create(exampleuser));

List list=criteria.list();

for(int i=0;i<list.size();i++){

  User user=(User)list.get(i);

  System.out.println(user.getName()+”\n”);

}

上述代码中 User exampleuser=new User(“zx”);criteria.add(Example.create(exampleuser)); 两句相当于

criteria.add(Expression.eq(“name”,”zx”)); 因此会生成类似如下的 SQL 语句：

select * from user where name=’zx’; 在上面的代码中 exampleuser 称为示例对象。

在 Hibernate 中队示例查询，默认情况下会排除掉示例对象中属性值为空的属性，还可以调用 Example.excludeNone （排除空串值） /excludeZeros （排除零值），或者调用 Example.excludeProperty 方法来指定排除特定属性。

示例查询主要应用于组合查询中，比如根据用户输入的查询条件动态生成最终的查询语句，通过使用示例查询，可以避免由于查询条件过多而写的大量 if 判断语句。

3、 复合查询：

复合查询主要是处理，具有关联关系的两个实体怎样进行关联查询，比如 User 实体对象与 Addres 实体对象具有一对多的关联关系，我们可以如下构造符合查询：

Criteria criteria=session.createCriteria(User.class);

Criteria addcriteria=criteria.createCriteria(“addresses”);(1)

  addcriteria.add(Express.like(“address”,”%tianjin%”));

List list=criteria.list();

  for(int i=0;i<list.size();i++){

    User user=(User)list.get(i);

    System.out.println(user.getName()+”\n”);

    Set addresses=user.getAddresses();

    Iterator it=addresses.iterator();

    while(it.hasNext(){

     Address address=(Address)it.next();

     System.out.println(address.getAddress()+”\n”);

    }

  }

当执行到了（ 1 ）处时，表明要针对 User 对象的 addresses 属性添加新的查询条件，因此当执行 criteria.list() 时， Hibernate 会生成类似如下的 SQL 语句：

Select * from user inner join address on user.id=address.id where address.address like ‘%shanghai%’;

正如我们所见，我们可以通过向 Criteria 中添加保存关联对象的集合属性（ addresses 属性保存与 User 对象相关联的 Address 对象），来构造复合查询，在数据库一端是通过内连接查询来实现。

4、 Criteria 的高级特性：

A、 限定返回记录条数：

我们可以通过利用 Criteria.setFirstResult/setMaxResult 方法来限定返回某一次查询的记录数，如下代码：

Criteria criteria=session.createCriteria(User.class);

criteria.setFirstResult(100);

criteria.setMaxResult(200);

通过以上代码可以设定该次查询返回 user 表中的从第 100 条记录开始直到第 200 条记录结束的 100 条记录。

B、 对查询结果进行排序：

可通过使用 net.sf.hibernate.expression.Order 类可以对查询结果集进行排序，如下面代码：

Criteria criteria=session.createCriteria(User.class);

criteria.add(Expression.eq(“groupid”,”2”);

criteria.addOrder(Order.asc(“name”));

criteria.addOrder(Order.desc(“groupid”));

List list=criteria.list();

通过使用 Order 类的 asc()/desc() 方法，可以指定针对某个字段的排序逻辑，如果执行上述代码，会生成类似如下的 SQL 语句：

Select * from user where groupid=’2’ order by name asc,groupid desc

C、 分组与统计：

在 Hibernate3 中，对 Criteria 又增添了新功能，可以支持分组与统计功能，在 Hibernate3 中增加了 Projections 以及 ProjectionList 类，这两个类对分组与统计功能进行了封装，如下代码：

Criteria criteria=session.createCriteria(User.class);

criteria.setProjection(Projections.groupProperty(“age”));(1)

List list=criteria.list();

Iterator it=list.iterator();

while(it.hasNext()){

System.out.println(it.next());

}

通过（ 1 ）处的代码，我们通过 Projections 类指定了用于分组的目标属性，当进行检索时 Hibernate 会生成类似如下的 SQL 语句：

Select age from user group by age;

还可以通过使用 Projections 的 avg()/rowCount()/count()/max()/min()/countDistinct() 等方法来实现统计功能，如下面的代码示例：

Criteria criteria=session.createCriteria(User.class);

criteria.setProjection(Projections.avg(“age”));(1)

List list=criteria.list();

Iterator it=list.iterator();

while(it.hasNext()){

System.out.println(it.next());

}

通过（ 1 ）处的代码，我们实现了对用户平均年龄的统计，当进行检索时， Hibernate 会生成类似如下的 SQL 语句：

Select avg(age) from user;

另外，在 SQL 语句中的多条件分组与统计功能，可以利用 ProjectionList 类来实现，如下面代码所示：

Criteria criteria=session.createCriteria(User.class);

ProjectionList prolist=Projections.projectionList();

prolist.add(Projections.groupProperty(“age”));

prolist.add(Projections.rowCount());

criteria.setProjection(prolist);

List list=criteria.list();

通过以上代码，实现了对不同年龄人员数量的分组统计，当进行检索时， Hibernate 会生成类似如下的 SQL 语句：

Select age,count(*) from user group by age;

5、 DetachedCriteria:

在 Hibernate2 中， Criteria 实例是与创建它的 Session 实例具有相同的生命周期的，也就是说， Session 实例是它所创建的 Criteria 实例的宿主，当 Session 关闭时，寄生于 Session 实例的 Criteria 都将失效。这就对 Criteria 的重用造成了困难，为了实现 Criteria 实例的重用，在 Hibernate3 中提供了一个 DetachedCriteria 类， DetachedCriteria 实例的生命周期与 Session 实例的生命周期无关，我们可以利用 DetachedCriteria 对一些常用的 Criteria 查询条件进行抽离，当需要进行检索时再与 Session 实例关联，从而获得运行期的 Criteria 实例。如下面的代码所示：

  DetachedCriteria dc= DetachedCriteria.forClass(User.class);

  dc.add(Expression.eq(“name”,”zhaoxin”));

  dc.add(Expression.eq(“sex”,”1”));

Criteria criteria=dc.getExecutableCriteria(session);

  Iterator it=criteria.list().iterator();

  while(it.hasNext()){

    User user=(User)it.next();

    System.out.println(user.getName());

  }

正如我们所见， DetachedCriteria 的生存周期与 session 实例无关，当需要进行检索时，通过 getExecutableCriteria(session) 方法，与当前的 Session 实例关联并获得运行期的 Criteria 实例，完成检索。

DetachedCriteria 也可以用于完成子查询功能，如下代码所示：

DetachedCriteria dc= DetachedCriteria.forClass(User.class);

dc.setProjection(Projections.avg(“age”));

Criteria criteria=session.createCriteria(User.class);

criteria.add(Subqueries.propertyGt(“age”,dc));

List list=criteria.list();

通过 Subqueries 类，实现了添加子查询的功能，我们将 DetachedCriteria 所设定的查询条件，当作子查询添加到了运行时 Criteria 实例的查询条件中，当执行检索时 Hibernate 会生成类似如下的 SQL 语句：

Select * from user where age>(select avg(age) from user group by age);