本文介绍 Hibernate Criteria API 的使用方法，包括基本查询条件设置、高级特性如分页与排序等，并对比 HQL 查询语言。
Criteria 本身只是一个查询容器，具体的查询条件需要通过 Criteria.add
方法添加到 Criteria 实例中。
如前例所示， Expression 对象具体描述了查询条件。针对 SQL 语法，
Expression 提供了对应的查询限定机制，包括：
|
方法 |
描述 |
|
Expression.eq
|
对应 SQL “ field = value ”表达式。 如 Expression.eq( "name" , "Erica" ) |
|
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” 表达式 如下面的表达式表示年龄（ age ）位于 13 到 50 区 间内。 Expression.between( "age" , new Integer(13), new Integer(50));
|
|
Expression.like
|
对应 SQL 中的 “field like value” 表达式
|
|
Expression.in
|
对应 SQL 中的 ”field in …” 表达式
|
|
Expression.eqProperty
|
用于比较两个属性之间的值，对应 SQL 中的“ field = field ”。 如： Expression.eqProperty( "TUser.groupID" , "TGroup.id" );
|
|
Expression.gtProperty
|
用于比较两个属性之间的值，对应 SQL 中的“ field > field ”
|
|
Expression.geProperty
|
用于比较两个属性之间的值，对应 SQL 中的“ field >= field ”
|
|
Expression.ltProperty
|
用于比较两个属性之间的值，对应 SQL 中的“ field < field ”
|
|
Expression.leProperty
|
用于比较两个属性之间的值，对应 SQL 中的“ field <= field ”
|
|
Expression.and
|
and 关系组合。 如： Expression.and( Expression.eq( "name" , "Erica" ), Expression.eq( "sex" , new Integer(1) ) );
|
|
Expression.or
|
or 关系组合。 如： Expression.or( Expression.eq( "name" , "Erica" ), Expression.eq( "name" , "Emma" ) );
|
|
Expression.sql
|
作为补充，本方法提供了原生 SQL 语法的支持。我 们可以通过这个方法直接通过 SQL 语句限定查询 条件。 下面的代码返回所有名称以“ Erica ”起始的记录： Expression.sql( “ lower({alias}.name) like lower(?) ” , "Erica%" , Hibernate.STRING ); 其中的“ {alias} ”将由 Hibernate 在运行期使 用当前关联的 POJO 别名替换。
|
注意 Expression 各方法中的属性名参数（如 Express.eq 中的第一个参数），这里所谓属性名是 POJO 中对应实际库表字段的属性名（大小写敏感），而非库表中的实际字段名称。
Criteria 高级特性
限定返回的记录范围
通过 criteria. setFirstResult/setMaxResults 方法可以限制一次查询返回
的记录范围 :
Criteria criteria = session.createCriteria(TUser. class );
// 限定查询返回检索结果中，从第一百条结果开始的 20 条记录
criteria.setFirstResult(100);
criteria.setMaxResults(20);
对查询结果进行排序
// 查询所有 groupId=2 的记录
// 并分别按照姓名 ( 顺序 ) 和 groupId （逆序）排序
Criteria criteria = session.createCriteria(TUser. class );
criteria.add(Expression.eq( "groupId" , new Integer(2)));
criteria.addOrder(Order.asc( "name" ));
criteria.addOrder(Order.desc( "groupId" ));
Criteria 作为一种对象化的查询封装模式，不过由于 Hibernate 在实现过程中将精力
更加集中在 HQL 查询语言上，因此 Criteria 的功能实现还没做到尽善尽美（这点上， OJB
的 Criteria 实现倒是值得借鉴），因此，在实际开发中，建议还是采用 Hibernate 官
方推荐的查询封装模式： HQL 。
扫一扫
519
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
