Hibernate3的DetachedCriteria支持

Hibernate3支持DetachedCriteria，这是一个非常有意义的特性！我们知道，在常规的Web编程中，有大量的动态条件查询，即用户在网页上面自由选择某些条件，程序根据用户的选择条件，动态生成SQL语句，进行查询。

　　针对这种需求，对于分层应用程序来说，Web层需要传递一个查询的条件列表给业务层对象，业务层对象获得这个条件列表之后，然后依次取出条件，构造查询语句。这里的一个难点是条件列表用什么来构造？传统上使用Map，但是这种方式缺陷很大，Map可以传递的信息非常有限，只能传递name和value，无法传递究竟要做怎样的条件运算，究竟是大于，小于，like，还是其它的什么，业务层对象必须确切掌握每条entry的隐含条件。因此一旦隐含条件改变，业务层对象的查询构造算法必须相应修改，但是这种查询条件的改变是隐式约定的，而不是程序代码约束的，因此非常容易出错。

　　DetachedCriteria可以解决这个问题，即在web层，程序员使用DetachedCriteria来构造查询条件，然后将这个DetachedCriteria作为方法调用参数传递给业务层对象。而业务层对象获得DetachedCriteria之后，可以在session范围内直接构造Criteria，进行查询。就此，查询语句的构造完全被搬离到web层实现，而业务层则只负责完成持久化和查询的封装即可，与查询条件构造完全解耦，非常完美！这恐怕也是以前很多企图在web层代码中构造HQL语句的人想实现的梦想吧！

　　示例代码片段如下：

　　web层程序构造查询条件：

　　java代码:

DetachedCriteria detachedCriteria = DetachedCriteria.forClass(Department.class); detachedCriteria.add(Restrictions.eq("name", "department")).createAlias("employees", "e").add(Restrictions.gt(("e.age"), new Integer(20)));

　　Department和Employee是一对多关联，查询条件为：

　　名称是“department”开发部门；
　　部门里面的雇员年龄大于20岁；

　　业务层对象使用该条件执行查询：

　　java代码:

detachedCriteria.getExecutableCriteria(session).list();

　　最大的意义在于，业务层代码是固定不变的，所有查询条件的构造都在web层完成，业务层只负责在session内执行之。这样代码就可放之四海而皆准，都无须修改了。

　　然而Spring和Hibernate3的DetachedCriteria有不兼容的问题，因此在Spring环境下面使用Hibernate3需要注意：

　　Spring的HibernateTemplate提供了Hibernate的完美封装，即通过匿名类实现回调，来保证Session的自动资源管理和事务的管理。其中核心方法是：

　　java代码:

HibernateTemplate.execute(new HibernateCallback() { 　public Object doInHibernate(Session session) throws HibernateException { 　　.... 　} }

　　回调方法提供了session作为参数，有了session，就可以自由的使用Hibernate API编程了。使用了spring的之后，代码修改如下：

　　web层代码：

　　java代码:

DetachedCriteria detachedCriteria = DetachedCriteria.forClass(Department.class); detachedCriteria.createAlias("employees", "e").add(Restrictions.eq("name", "department")).add(Restrictions.gt(("e.age"), new Integer(20))); departmentManager.findByCriteria(detachedCriteria);

　　构造detachedCriteria，作为参数传递给departmentManager

　　业务层代码使用spring，DepartmentManager的findByCriteria如下：

　　java代码:

public List findByCriteria(final DetachedCriteria detachedCriteria) { 　return (List) getHibernateTemplate().execute(new HibernateCallback() { 　　public Object doInHibernate(Session session) throws HibernateException { 　　　Criteria criteria = detachedCriteria.getExecutableCriteria(session); 　　　return criteria.list(); 　　} 　}); }

　　实际上也就是：

　　java代码:

Criteria criteria = detachedCriteria.getExecutableCriteria(session); return criteria.list();

　　而已

　　但是该程序代码执行，会抛出强制类型转换异常！

　　我跟踪了一下spring和Hibernate源代码，原因如下：

　　spring的HibernateTemplate的execute方法提供的回调接口具有Session作为参数，但是实际上，默认情况下，HibernateTemplate传递给回调接口的session并不是org.hibernate.impl.SessionImpl类，而是SessionImpl类的一个Proxy类。之所以替换成为一个Proxy类，HibernateTemplate的注释说明，Proxy提供了一些额外的功能，包括自动设置Cachable，Transaction的超时时间，Session资源的更积极的关闭等等。

　　java代码:

private boolean exposeNativeSession = false; ...

　　execute方法内部：

Session sessionToExpose = (exposeNativeSession ? session : createSessionProxy(session));

　　但是遗憾的是，Hibernate的DetachedCriteria的setExecutableCriteria方法却要求将session参数强制转为SessionImpl，但是spring传过来的却是一个Proxy类，因此就报错了。

　　java代码:

public Criteria getExecutableCriteria(Session session) { 　impl.setSession( (SessionImpl) session ); // 要求SessionImpl，Spring传递的是Proxy 　return impl; }

　　解决方法，禁止Spring的HibernateTemplate传递Proxy类，强制要求它传递真实的SessionImpl类，即给exexute方法增加一个参数，提供参数为true，如下：

　　java代码:

public List findByCriteria(final DetachedCriteria detachedCriteria) { 　return (List) getHibernateTemplate().execute(new HibernateCallback() { 　　public Object doInHibernate(Session session) throws HibernateException { 　　　Criteria criteria = detachedCriteria.getExecutableCriteria(session); 　　　return criteria.list(); 　　} 　}, true); }

 

一点体会：

假设要通过stuName查询一个学生Student记录，可以如下：

 DetachedCriteria dc  =  DetachedCriteria.forClass(Student. class );
    dc.add(Restrictions.like("stuName", stuName, MatchMode.ANYWHERE));
      

 如果要通过Student的Team的teamName查询一个Student记录，很多人都会这么写：

 DetachedCriteria dc  =  DetachedCriteria.forClass(Student. class );
    dc.add(Restrictions.like("team.teamName", teamName, MatchMode.ANYWHERE));
      

遗憾的是上述程序报错，说是在Student中找不到team.teamName属性，这是可以理解的。那么如何通过teamName查找Student呢？
可以这么写：

 DetachedCriteria dc  =  DetachedCriteria.forClass(Student. class );
    dc.createAlias("team", "t");
    dc.add(Restrictions.like("t.teamName", teamName, MatchMode.ANYWHERE));
      

没错，就是要先建立team的引用，才能用team导航到teamName。

这里有一个特殊情况，如果是对引用对象的id查询，则可以不用建立引用，也就是可以不调用createAlias()语句，如下所示：

 DetachedCriteria dc  =  DetachedCriteria.forClass(Student. class );
    dc.add(Restrictions.like("team.id", teamId, MatchMode.ANYWHERE));
      

据我个人的经验，team后只能跟其主键属性，比较其他属性要用别名。此主键属性可以用“id”字符来指代，也可以用team的主键属性来指代。换句话说，我的Student类的类主键“stuId”，不管是在HQL还是在QBC中，都可以用stu.id来指代stu.stuId。在这里可以看出“id”字符的特殊性。上述是个人观点，并未得到确实的证实。