Example.excludeProperty
Example作用是：根据以后的对象，查找属性之间的相符的其它对象 用法：
Criteria criteria = session.createCriteria(TUser. class );
TUser exUser = new TUser();
exUser.setName( " Erica " );
criteria.add(Example.create(exUser));
复制代码
这里我们新建一个TUser对象exUser，并作为范本，查询所有的name属性与之相同的用户记录 上列语句等同于： Criteria criteria = session.createCriteria(TUser.class);criteria.add(Expression.eq("name","Erica")); 默认情况下，Hibernate会过滤掉是列对象的NUll值属性，我们也可以通过调用Example.excludeNone/excludeZeroes 方法来对这个特性进行调整，或者通过Example.excludeProperty方法将某个属性排除在外 举例描述Example类的用途 大部分我们会在代码中进行判断，根据用户输入的查询生成最终的查询条件，由于组合条件不确定，往往导致逻辑判断语句拖沓起伏，如下：
public
List querUsers(String name,Integer age)
throws
HibernateException{
Criteria criteria
=
session.craeteCriteria(TUser.
class
);
if
(
null
!=
name){
criteria.add(Expression.like(
"
name
"
,name))
}
if
(
null
!=
age){
criteria.add(Expression.eq(
"
age
"
,age));
}
return
criteria.list();}
对于上面的例子，如果出现了十个，那么情况相当复杂，示例查询在这里，就可以起到相当大的作用，我们可以修改如下：
public
List querUsers(TUser user){
Criteria criteria
=
session.createCriteria(TUser.
class
);
criteria.add(Example.create(user));
return
criteria.list();
}
Hibernate复合查询
Criteria criteria
=
session.createCriteria(TUser.
class
);
Criteria addrCriteria
=
criteria.createCriteria(
"
addresses
"
);
addrCriteria.add(Expression.like(
"
address
"
,
"
%Shanghai
"
));
运行后Hibernate显示的SQL语句如下：
select
...
from
T_USER
user
inner
join
T_Address address
on
user
.id
=
address.
user_id
where
address.address
like
?
Hibernate DetachedCriteria
由某个Session创建的Criteria实例，一旦Session销毁，那么此Criteria实例也随之实效，这很大的程度上限制了Criteria的重用，对于相同的Criteria查询条件，每次我们都必须由当前Session构造其查询实例，未免失之繁琐。
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 list
=
criteria.list();
复制代码
我们可以采用DetachedCriteria实现子查询，例子如下：
DetachedCriteria avgAge
=
DetachedCriteria.forClass(TUser.
class
);
avgAge.setProjection(Projections.avg(
"
avg
"
));
Criteria criteria
=
session.createCriteria(TUser.
class
);
criteria.add(Subqueries.propertyGt(
"age"
,avgAge));
=
criteria.list();
通过Subqueries我们可以将DetachedCriteria纳入查询表达式，反映SQL上则是一个典型的子查询语句,上例运行期生成的SQL语句大致如下：
select
...
from
T_USER
user
where
age
>
(
select
avg
(age)
from
T_USER)
Hibernate Criteria 分组于统计
下列我们采用TUser对象中的age分组
Criteria criteria
=
session.createCriteria(TUser.
class
);
criteria.setProjection(Projections.groupProptery(
"
age
"
));
List list criteria.list();
通过上例运行期大概生成的SQL语句如下：
select
this.age
as
y0_
from
T_USER this_
group
by
this_.age
可以看到Projections.groupProperty()方法实际上是对SQL group by 子句的封装，同样，我们可以通过Projections.avg()、rowCount()、count()、max()、min()、countDistinct()等方法实现查询统计功能。
另外，对于多条件组合的统计、分组功能，我们可以借助ProjectionList完成，下面例子中，我们统计了各个年龄层次中的用户数量：
ProjectionList projectionList
=
Projections.projectionList();
projectionList.add(Projections.groupProperty(
"
age
"
));
projectionList.add(Projections.rowCount());
Criteria criteria
=
session.createCriteria(TUser.
class
);
criteria.setProjection(projectionList);
List list criteria.list();
Hibernate 属性查询
有时候我们并不需要获取完整的实体对象，如在一个下拉框中显示用户名，此时我们需要的数据仅仅是实体对象的某个属性（库表记录中的某个字段信息）。同样通过HQL我们也可以简单地做到这一点
List list
=
session.criteriaQuery(
"
select user.name from TUser user
"
).list();
Iterator it
=
list.iterator();
while
(is.hashNext){
System.out.println(it.next);
}
HQL "select user.name from TUser user" 指定了我们只需要获取TUser对象的name属性（也就是T_User表的name字段）。此时返回的是List数据结构中，每个条目都是一个Stirng类型的那么数据（而非TUser对象）
List list = session.criteriaQuery("select user.name，user.age from TUser user").list(); Iterator it =list.iterator(); while(is.hashNext){ Object[] obj=(Object[])it.next System.out.println(obj[0]); System.out.println(obj[1]); }
HQL select user.name，user.age from TUser user 表明我们需要读取name和age属性的内容，而此时，返回的list数据结构中，每个条目都是一个对象数据（Objcet[]）,其中一次包含了我们所获得的属性数据
如果觉得返回数组的方式不够符合面向对象的风格，我们可以通过HQL中动态构造对象实例的方法对这些平面化的数据进行封装。
List list
=
session.criteriaQuery(
"
select new TUser(user.name,user.age) from TUser user
"
).list();
Iterator it
=
list.iterator();
while
(is.hashNext){
TUser user
=
(TUser)it.next
System.out.println(user.getName());
}
实体更新与删除
Hibernate 2中查询及更新
TUser user
=
(TUser)session.get(TUser.
class
,
new
Integer(
1
));
user.setAge(
new
Integer(
18
));
session.save(user);
以上代码完成ID=1的用户数据更行，那么，如果我们需要将库表中所有的用户的年龄置为18，该如何操作呢，别无它法，我们只有搜先利用HQL “from TUser ”查询出所有的实体，设置年属性后在逐一保存
Hibernate3 HQL提供了更为灵活的便捷的实现方式（bulkdelete/update）
Transaction tx
=
session.beginTranscation();
String sql
=
"
update TUser set age=18 where id=1
"
;
Query query
=
session.createQuery(hql);
query.executeUpdate();
tx.commit();
HQL delte子句使用
Transaction tx
=
session。beginTranscation();
String sql
=
"
delete TUser where id=1
"
;
Query query
=
session.createQuery(hql);
int
ret
=
query.executeUpdate();
System.out.println(ret);
tx.commit();
参数绑定
String sql="from TUser user where user.age>"+age;
编码更加凌乱，可读性降低、难以进行性能优化、引入额外的安全风行
我们应该采用
session.find("from TUser user where user.name=?","Erica",Hibernate.STRING);
多参数的情况
Object[] args
=
new
Object[]{
"
Erica
"
,
new
Integer(
20
)};
Type[] types
=
new
Type[]{Hibernate.STRING,Hibernate.INTEGER};
session.find(
"
from TUser user where user.name=? and user.age>?
"
,args,types);
或者通过Query接口进行参数填充
Query query
=
session.createQuery(
"
from TUser user where user.name=? and user.age>?
"
);
query.setString(
0
,
"
Erica
"
);
quer.setInteger(
1
,
20
);
占位符
String sql
=
from TUser user where user.name
=
:name and user.age
>
:age
"
;
Query query
=
session.createQuery(hql);
query.setParameter(
"
name
"
,
"
Erica
"
);
query.setParameter(
"
age
"
,
18
);
＝＝＝＝＝＝＝＝＝＝＝
http://developer.51cto.com/art/200909/153767.htm
最近在项目中使用 Spring 和 Hibernate 进行开发，有感于Hibernate Criteria 比较好用，在查询方法设计上可以灵活的根据 Criteria 的特点来方便地进行查询条件的组装。本人对此进行了整理，希望读者能够借鉴。
现在对Hibernate Criteria 的用法进行总结：
Hibernate 设计了 CriteriaSpecification 作为 Criteria 的父接口，下面提供了 Criteria和DetachedCriteria 。Criteria 和 DetachedCriteria 的主要区别在于创建的形式不一样， Criteria 是在线的，所以它是由 Hibernate Session 进行创建的；而 DetachedCriteria 是离线的，创建时无需 Session，DetachedCriteria 提供了 2 个静态方法 forClass(Class) 或 forEntityName(Name) 进行DetachedCriteria 实例的创建。 Spring 的框架提供了getHibernateTemplate().findByCriteria(detachedCriteria) 方法可以很方便地根据DetachedCriteria 来返回查询结果。
Criteria 和 DetachedCriteria 均可使用 Criterion 和 Projection 设置查询条件。可以设置 FetchMode( 联合查询抓取的模式 ) ，设置排序方式。对于 Criteria 还可以设置 FlushModel （冲刷 Session 的方式）和 LockMode （数据库锁模式）。
下面对 Hibernate Criterion 和 Projection 进行详细说明。
Hibernate Criterion 是 Criteria 的查询条件。Criteria 提供了 add(Criterion criterion) 方法来添加查询条件。
Hibernate 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) ，即根据一个对象（实际使用中一般是映射到数据库的对象）来创建。然后可以设置一些过滤条件：
1. Example exampleUser =Example.create(u)
2. .ignoreCase() // 忽略大小写
3. .enableLike(MatchMode.ANYWHERE);
4. // 对 String 类型的属性，无论在那里值在那里都匹配。相当于 %value%
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) 方法加入到查询条件中去。使用 Criteria 进行查询，主要要清晰的是 Hibernate 提供了那些类和方法来满足开发中查询条件的创建和组装，下面介绍几种用法：
1. 创建一个Criteria 实例
org.hibernate.Criteria接口表示特定持久类的一个查询。Session是 Criteria实例的工厂。
1. Criteria crit = sess.createCriteria(Cat.class);
2. crit.setMaxResults(50);
3. List cats = crit.list();
4.
2. 限制结果集内容
一个单独的查询条件是org.hibernate.criterion.Criterion 接口的一个实例。
org.hibernate.criterion.Restrictions类 定义了获得某些内置Criterion类型的工厂方法。
1. List cats = sess.createCriteria(Cat.class)
2. .add( Restrictions.like("name", "Fritz%") )
3. .add( Restrictions.between("weight", minWeight, maxWeight) )
4. .list();
约束可以按逻辑分组。
1. List cats = sess.createCriteria(Cat.class)
2. .add( Restrictions.like("name", "Fritz%") )
3. .add( Restrictions.or(
4. Restrictions.eq( "age", new Integer(0) ),
5. Restrictions.isNull("age")
6. ) )
7. .list();
8.
9. List cats = sess.createCriteria(Cat.class)
10. .add( Restrictions.in( "name", new String[] { "Fritz", "Izi", "Pk" } ) )
11. .add( Restrictions.disjunction()
12. .add( Restrictions.isNull("age") )
13. .add( Restrictions.eq("age", new Integer(0) ) )
14. .add( Restrictions.eq("age", new Integer(1) ) )
15. .add( Restrictions.eq("age", new Integer(2) ) )
16. ) )
17. .list();
Hibernate提供了相当多的内置criterion类型(Restrictions 子类), 但是尤其有用的是可以允许你直接使用SQL。
1. List cats = sess.createCriteria(Cat.class)
2. .add( Restrictions.sql("lower({alias}.name) like lower(?)", "Fritz%",
3.
4. Hibernate.STRING) )
5. .list();
{alias}占位符应当被替换为被查询实体的列别名。
Property实例是获得一个条件的另外一种途径。你可以通过调用Property.forName() 创建一个Property。
1. Property age = Property.forName("age");
2. List cats = sess.createCriteria(Cat.class)
3. .add( Restrictions.disjunction()
4. .add( age.isNull() )
5. .add( age.eq( new Integer(0) ) )
6. .add( age.eq( new Integer(1) ) )
7. .add( age.eq( new Integer(2) ) )
8. ) )
9. .add( Property.forName("name").in( new String[] { "Fritz", "Izi", "Pk" } ) )
10. .list();
3. 结果集排序
你可以使用org.hibernate.criterion.Order来为查询结果排序。
1. List cats = sess.createCriteria(Cat.class)
2. .add( Restrictions.like("name", "F%")
3. .addOrder( Order.asc("name") )
4. .addOrder( Order.desc("age") )
5. .setMaxResults(50)
6. .list();
7.
8. List cats = sess.createCriteria(Cat.class)
9. .add( Property.forName("name").like("F%") )
10. .addOrder( Property.forName("name").asc() )
11. .addOrder( Property.forName("age").desc() )
12. .setMaxResults(50)
13. .list();
4. 关联
你可以使用createCriteria()非常容易的在互相关联的实体间建立约束。
1. List cats = sess.createCriteria(Cat.class)
2. .add( Restrictions.like("name", "F%")
3. .createCriteria("kittens")
4. .add( Restrictions.like("name", "F%")
5. .list();
注意第二个 createCriteria()返回一个新的 Criteria实例，该实例引用kittens 集合中的元素。
接下来，替换形态在某些情况下也是很有用的。
1. List cats = sess.createCriteria(Cat.class)
2. .createAlias("kittens", "kt")
3. .createAlias("mate", "mt")
4. .add( Restrictions.eqProperty("kt.name", "mt.name") )
5. .list();
(createAlias()并不创建一个新的 Criteria实例。)
Cat实例所保存的之前两次查询所返回的kittens集合是 没有被条件预过滤的。如果你希望只获得符合条件的kittens， 你必须使用returnMaps()。
1. List cats = sess.createCriteria(Cat.class)
2. .createCriteria("kittens", "kt")
3. .add( Restrictions.eq("name", "F%") )
4. .returnMaps()
5. .list();
6. Iterator iter = cats.iterator();
7. while ( iter.hasNext() ) {
8. map
9. cat
10. kitten
11. }
5. 动态关联抓取
你可以使用setFetchMode()在运行时定义动态关联抓取的语义。
1. List cats = sess.createCriteria(Cat.class)
2. .add( Restrictions.like("name", "Fritz%") )
3. .setFetchMode("mate", FetchMode.EAGER)
4. .setFetchMode("kittens", FetchMode.EAGER)
5. .list();
这个查询可以通过外连接抓取mate和kittens。
6. 查询示例
org.hibernate.criterion.Example类允许你通过一个给定实例 构建一个条件查询。
1. org.hibernate.criterion.Example类允许你通过一个给定实例 构建一个条件查询。
2.
3. Cat cat = new
4. cat.setSex('F');
5. cat.setColor(Color.BLACK);
6. List results = session.createCriteria(Cat.class)
7. .add( Example.create(cat) )
8. .list();
版本属性、标识符和关联被忽略。默认情况下值为null的属性将被排除。
可以自行调整Example使之更实用。
1.
2. Example example = Example.create(cat)
3. .excludeZeroes() //exclude zero valued properties
4. .excludeProperty("color") //exclude the property named "color"
5. .ignoreCase() //perform case insensitive string comparisons
6. .enableLike(); //use like for string comparisons
7. List results = session.createCriteria(Cat.class)
8. .add(example)
9. .list();
甚至可以使用examples在关联对象上放置条件。
1. List results = session.createCriteria(Cat.class)
2. .add( Example.create(cat) )
3. .createCriteria("mate")
4. .add( Example.create( cat.getMate() ) )
5. .list();
7. 投影(Projections)、聚合（aggregation）和分组（grouping）
org.hibernate.criterion.Projections是 Projection 的实例工厂。我们通过调用setProjection()应用投影到一个查询。
1. List results = session.createCriteria(Cat.class)
2. .setProjection( Projections.rowCount() )
3. .add( Restrictions.eq("color", Color.BLACK) )
4. .list();
5.
6. List results = session.createCriteria(Cat.class)
7. .setProjection( Projections.projectionList()
8. .add( Projections.rowCount() )
9. .add( Projections.avg("weight") )
10. .add( Projections.max("weight") )
11. .add( Projections.groupProperty("color") )
12. )
13. .list();
