Criteria Query通過面向對象的設計,將數據查詢條件封裝為一個對象。簡單來說,Criteria Query可以看作是傳統SQL的對象化表示,如:
Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Expression.eq("name","Erica"));
criteria.add(Expression.eq("sex",new Integer(1));
這里的criteria實例本質上是對SQL“select * from t_user where name='Erica' and sex=1”的封裝。
Hibernate在運行期會根據Criteria中指定的查詢條件生成相應的SQL語句。
Criteria查詢表達式
Criteria本身只是一個容器,具體的查詢條件要通過Criteria.add方法添加到Criteria實例中。
方法 |
描述 |
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”表達式
如:Expression.between("age",new Integer(13),new Integer(50));
|
Expression.like |
對應SQL"field like valule"表達式 |
Expression.in |
對應SQL“field in...”表達式 |
Expression.eqproperty |
用于比較兩個屬性之間的值,對應SQL“field>field” |
Expression.gtProperty |
用于比較兩個屬性之間的值,對應SQL“field>=field” |
Expression.ltProperty |
用于比較兩個屬性之間的值,對應SQL"field<field" |
Expression.leProperty |
用于比較兩個屬性之間的值,對應SQL"field<=field" |
Expression.and |
and關系組合,如:
Expression.add(Expression.eq("name","Erica"),Expression.add("sex",new Integer(1)))
|
Expression.or |
or關系組合,如:
Expression.or(Expression.eq("name","Erica"),Expression.add("sex",new Integer(1)))
|
Expression.sql |
作為補充,本方法提供了原生SQL語法的支持,我們可以通過這個方法直接通過SQL語句限定查詢條件
下面的代碼返回所有名稱以"Erica"其實的記錄:
Expression.sql("lower({alias}.name) like lower(?)","Erica%",Hibernate.STRING);
其中的"{alias}"將Hibernate在運行期使用當前關聯的POJO別名替換
|
在Hibernate3中,引入了Restrictions類作為Expression的替代。
示例查詢
Example類實現了Criteria接口,同樣,它也可以用作Criteria的查詢條件。Example的作用是:根據已有對象,查找屬性與之相符的其他對象。
Criteria criteria=session.CreateCriteria(TUser.class);
TUser exampleUser=new TUser();
exapleUser.getName("Erica");
criteria.add(Example.create(exampleUser));

List<TUser> list=criteria.list();


for(TUser user:list)
{
System.out.println(user.getName());
}
新建一個TUser對象exampleUser,并作為范本,查詢所有name屬性與之相同的記錄。
復合查詢
Criteria criteria=session.createCriteria(TUser.class);
Criteria addrCriteria=criteria.createCriteria("addresses");
addrCriteria.add(Expression.like("addresses","%shanghai%"));

List<TUser> list = criteria.list();

for(TUser user:list)
{
System.out.println(user.getName());
Set<TAddress> addrSet=user.getAddresses();

for(TAddress addr:addrSet)
{
System.out.println(addr.getAddress());
}
}
紅色部分就是我們新增的復合查詢條件,可以看到,我們可以通過Criteria.createCriteria方法在原有Criteria對象的基礎上構建復合查詢。
DetachedCriteria
Hibernate2中,Criteria生命周期位于其宿主Session生命周期中,也就是說,由某個session創建的Criteria實例,一旦session銷毀,那么此Criteria實例也隨之失效。
Hibernate3中引入了DetachedCriteria,DetachedCriteria可以脫離session實例獨立存在,這樣,我們就可以將某些通用的Criteria查詢條件進行抽離,每次使用時再與當前session實例綁定以獲得更好的代碼重用效果。
DetachedCriteria deCriteria=DetachedCriteria.forClass(TUser.class);
deCriteria.add(Expression.eq("name","Erica"));
deCriteria.add(Expression.eq("sex",new Integer(1)));

Criteria criteria=deCriteria.getExecutableCriteria(session);
List<TUser> list=criteria.list();

for(TUser user:list)
{
System.out.println(user.getName());
}
DetachedCriteria的生存周期與session實例無關,我們可以獨立創建DetachedCriteria實例,并在需要使用時與session相綁定,從而獲得運行期Criteria實例。這樣,我們就可以將查詢邏輯和Criteria實例分離,以獲得最大化代碼的重用效果。
DetachedCriteria也可以用于子查詢表達:
DetachedCriteria aveAge=DetachedCriteria.forClass(TUser.class);
avgAge.setProjection(Projections.avg("age"));

Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Subqueries.propertyGT("age",avgAge));

通過Subqueries我們可以將DetachedCriteria納入查詢表達式,反映在SQL上則是一個典型的子查詢語句。上例生成的SQL語句大致如:select ... from T_User where age > (select avg(age) from T_User)
Criteria高級特性
限定返回的記錄范圍
通過criteria.setFirstResult/setMaxResults方法可以限制一次查詢返回的記錄范圍:
Criteria criteria=session.createCriteria(TUser.class);
//限定查詢返回檢索結果中,從100條結果開始的20條記錄
criteria.setFirstResult(100);
criteria.setMaxResults(20);
記錄排序:
//
//
Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Expression.eq("groupId",new Integer(2)));

criteria.addOrder(Order.asc("name"));
criteria.addOrder(Order.desc("groupId"));
分組與統計
在Hibernate3中,我們還可以通過Criteria完成分組和統計。分組、統計表達式由Hibernate3新引入的Projections Class進行封裝。
Criteria criteria=session.createCriteria(TUser.class);
criteria.setProjection(Projections.groupProperty("age"));

List<TUser> list=criteria.list();

for(TUser user:list)
{
System.out.println(user);
}
上例對當前的TUser記錄按照年齡進行分組。通過Projections.groupProperty方法,我們指定了用于分組的目標屬性“age”。生成的SQL語句:select this.age as y0_ from T_User this_group by this_.age。
另外,對于多條件組合的統計、分組功能,我們可以借助ProjectionList完成,下面的例子中,我們統計了各個年齡層次中的用戶數量:
ProjectionList projectionlist=Projections.ProjectionList();
projectionList.add(Projections.groupProperty("age"));
projectionList.add9Projections.rowCount());

Criteria criteria=session.createCriteria(TUser.class);
criteria.setProjection(projectionList);
posted on 2008-05-10 22:59
Kira-2006 閱讀(807)
評論(0) 編輯 收藏 所屬分類:
hibernate