最近在项目中使用 spring 和 hibernate 进行开发,有感于 criteria 比较好用,在查询方法设计上可以灵活的根据 criteria 的特点来方便地进行查询条件的组装。所以现在对 hibernate 的 criteria 深入研究一下。《 hibernate reference 》及网上其它一些资料对 criteria 已经做了很多介绍。本文主要是从 criteria 的结构入手来进行分析。
如图 1 。 hibernate 设计了 criteriaspecification 作为 criteria 的顶级接口,其下面提供了 criteria 和 detachedcriteria 。
criteria 和 detachedcriteria 的主要区别在于创建的形式不一样, criteria 是在线的,所以它是由 hibernate session 进行创建的;而 detachedcriteria 是离线的,创建时无需 session , detachedcriteria 提供了 4 个静态方法 forclass(class) 或 forentityname(name) 进行 detachedcriteria 实例的创建。 spring 的框架提供了
gethibernatetemplate().findbycriteria(detachedcriteria) 方法可以很方便地根据
detachedcriteria 来返回查询结果。
如图 1 , criteria 和 detachedcriteria 均可使用 criterion 和 projection 设置查询条件。可以设置 fetchmode( 联合查询抓取的模式 ) ,设置排序方式。对于 criteria 还可以设置 flushmodel (冲刷 session 的方式)和 lockmode (数据库锁模式)。
下面就对 criterion 和 projection 进行详细说明。
图 1
criterion 是 criteria 的查询条件。
criteria 提供了 add(criterion criterion) 方法来添加查询条件。图 2 是 criterion 的结构图。 criterion 接口的主要实现包括: example 、 junction 和 simpleexpression 。而 junction 的实际使用是它的两个子类 conjunction 和 disjunction ,分别是使用 and 和 or 操作符进行来联结查询条件集合。
criterion 的实例可以通过 restrictions 工具类来创建, restrictions 提供了大量的静态方法,如 eq (等于)、 ge (大于等于)、 between 等来方法的创建 criterion 查询条件
( simpleexpression 实例)。除此之外, restrictions 还提供了方法来创建 conjunction 和 disjunction 实例,通过往该实例的 add(criteria) 方法来增加查询条件形成一个查询条件集合。
至于 example 的创建有所不同, example 本身提供了一个静态方法 create(object entity) ,即根据一个对象(实际使用中一般是映射到数据库的对象)来创建。然后可以设置一些过滤条件:
example exampleuser =example.create(u)
.ignorecase() // 忽略大小写
.enablelike(matchmode.anywhere);
// 对 string 类型的属性,无论在那里值在那里都匹配。相当于 %value%
图 2
project 主要是让 criteria 能够进行报表查询,并可以实现分组。 project 主要有 simpleprojection 、 projectionlist 和 property 三个实现。其中 simpleprojection 和 projectionlist 的实例化是由内建的 projections 来完成,如提供的 avg 、 count 、 max 、 min 、 sum 可以让开发者很容易对某个字段进行统计查询。
property 是对某个字段进行查询条件的设置,如通过
porperty.forname(“color”).in(new string[]{“black”,”red”,”write”}); 则可以创建一个 project 实例。通过 criteria 的 add(project) 方法加入到查询条件中去。
图 3
使用 criteria 进行查询,主要要清晰的是 hibernate 提供了那些类和方法来满足开发中查询条件的创建和组装,其结构层次如何。这样使用起来便可得心应手。