Criteria Query通過(guò)面向?qū)ο蟮脑O(shè)計(jì)，將數(shù)據(jù)查詢條件封裝為一個(gè)對(duì)象。簡(jiǎn)單來(lái)說(shuō)，Criteria Query可以看作是傳統(tǒng)SQL的對(duì)象化表示，如：
Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Expression.eq("name","Erica"));
criteria.add(Expression.eq("sex",new Integer(1));
這里的criteria實(shí)例本質(zhì)上是對(duì)SQL“select * from t_user where name='Erica' and sex=1”的封裝。
Hibernate在運(yùn)行期會(huì)根據(jù)Criteria中指定的查詢條件生成相應(yīng)的SQL語(yǔ)句。
Criteria查詢表達(dá)式
Criteria本身只是一個(gè)容器，具體的查詢條件要通過(guò)Criteria.add方法添加到Criteria實(shí)例中。
| 方法 |
描述 |
| Expression.eq |
對(duì)應(yīng)SQL “field=value”表達(dá)式
如：Expression.eq("name","Erica")
|
| Expression.allEq |
參數(shù)為一個(gè)Map對(duì)象，其中包含了多個(gè)屬性-值對(duì)應(yīng)關(guān)系。相當(dāng)于多個(gè)Expression.eq關(guān)系的疊加 |
| Expression.gt |
對(duì)應(yīng)SQL“field>value”表達(dá)式 |
| Expression.ge |
對(duì)應(yīng)SQL“field>=value”表達(dá)式 |
| Expression.lt |
對(duì)應(yīng)SQL“field<value”表達(dá)式 |
| Expression.le |
對(duì)應(yīng)SQL“field<=value”表達(dá)式 |
| Expression.between |
對(duì)應(yīng)SQL“between”表達(dá)式
如：Expression.between("age",new Integer(13),new Integer(50));
|
| Expression.like |
對(duì)應(yīng)SQL"field like valule"表達(dá)式 |
| Expression.in |
對(duì)應(yīng)SQL“field in...”表達(dá)式 |
| Expression.eqproperty |
用于比較兩個(gè)屬性之間的值，對(duì)應(yīng)SQL“field>field” |
| Expression.gtProperty |
用于比較兩個(gè)屬性之間的值，對(duì)應(yīng)SQL“field>=field” |
| Expression.ltProperty |
用于比較兩個(gè)屬性之間的值，對(duì)應(yīng)SQL"field<field" |
| Expression.leProperty |
用于比較兩個(gè)屬性之間的值，對(duì)應(yīng)SQL"field<=field" |
| Expression.and |
and關(guān)系組合，如：
Expression.add(Expression.eq("name","Erica"),Expression.add("sex",new Integer(1)))
|
| Expression.or |
or關(guān)系組合，如：
Expression.or(Expression.eq("name","Erica"),Expression.add("sex",new Integer(1)))
|
| Expression.sql |
作為補(bǔ)充，本方法提供了原生SQL語(yǔ)法的支持，我們可以通過(guò)這個(gè)方法直接通過(guò)SQL語(yǔ)句限定查詢條件
下面的代碼返回所有名稱(chēng)以"Erica"其實(shí)的記錄：
Expression.sql("lower({alias}.name) like lower(?)","Erica%",Hibernate.STRING);
其中的"{alias}"將Hibernate在運(yùn)行期使用當(dāng)前關(guān)聯(lián)的POJO別名替換
|
在Hibernate3中，引入了Restrictions類(lèi)作為Expression的替代。
示例查詢
Example類(lèi)實(shí)現(xiàn)了Criteria接口，同樣，它也可以用作Criteria的查詢條件。Example的作用是：根據(jù)已有對(duì)象，查找屬性與之相符的其他對(duì)象。
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());
}
新建一個(gè)TUser對(duì)象exampleUser，并作為范本，查詢所有name屬性與之相同的記錄。
復(fù)合查詢
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());
}
}
紅色部分就是我們新增的復(fù)合查詢條件，可以看到，我們可以通過(guò)Criteria.createCriteria方法在原有Criteria對(duì)象的基礎(chǔ)上構(gòu)建復(fù)合查詢。
DetachedCriteria
Hibernate2中，Criteria生命周期位于其宿主Session生命周期中，也就是說(shuō)，由某個(gè)session創(chuàng)建的Criteria實(shí)例，一旦session銷(xiāo)毀，那么此Criteria實(shí)例也隨之失效。
Hibernate3中引入了DetachedCriteria，DetachedCriteria可以脫離session實(shí)例獨(dú)立存在，這樣，我們就可以將某些通用的Criteria查詢條件進(jìn)行抽離，每次使用時(shí)再與當(dāng)前session實(shí)例綁定以獲得更好的代碼重用效果。
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實(shí)例無(wú)關(guān)，我們可以獨(dú)立創(chuàng)建DetachedCriteria實(shí)例，并在需要使用時(shí)與session相綁定，從而獲得運(yùn)行期Criteria實(shí)例。這樣，我們就可以將查詢邏輯和Criteria實(shí)例分離，以獲得最大化代碼的重用效果。
DetachedCriteria也可以用于子查詢表達(dá)：
DetachedCriteria aveAge=DetachedCriteria.forClass(TUser.class);
avgAge.setProjection(Projections.avg("age"));
Criteria criteria=session.createCriteria(TUser.class);
criteria.add(Subqueries.propertyGT("age",avgAge));
通過(guò)Subqueries我們可以將DetachedCriteria納入查詢表達(dá)式，反映在SQL上則是一個(gè)典型的子查詢語(yǔ)句。上例生成的SQL語(yǔ)句大致如：select ... from T_User where age > (select avg(age) from T_User)
Criteria高級(jí)特性
限定返回的記錄范圍
通過(guò)criteria.setFirstResult/setMaxResults方法可以限制一次查詢返回的記錄范圍：
Criteria criteria=session.createCriteria(TUser.class);
//限定查詢返回檢索結(jié)果中，從100條結(jié)果開(kāi)始的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"));
分組與統(tǒng)計(jì)
在Hibernate3中，我們還可以通過(guò)Criteria完成分組和統(tǒng)計(jì)。分組、統(tǒng)計(jì)表達(dá)式由Hibernate3新引入的Projections Class進(jìn)行封裝。
Criteria criteria=session.createCriteria(TUser.class);
criteria.setProjection(Projections.groupProperty("age"));
List<TUser> list=criteria.list();
for(TUser user:list){
System.out.println(user);
}
上例對(duì)當(dāng)前的TUser記錄按照年齡進(jìn)行分組。通過(guò)Projections.groupProperty方法，我們指定了用于分組的目標(biāo)屬性“age”。生成的SQL語(yǔ)句：select this.age as y0_ from T_User this_group by this_.age。
另外，對(duì)于多條件組合的統(tǒng)計(jì)、分組功能，我們可以借助ProjectionList完成，下面的例子中，我們統(tǒng)計(jì)了各個(gè)年齡層次中的用戶數(shù)量：
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)
評(píng)論(0) 編輯 收藏 所屬分類(lèi):
hibernate