NHibernate Step by Step (五)Criteria Query

可能很多人象我一样，刚开始接触HQL时，脑袋一片混沌，这是什么语法嘛！！之所以这样，是因为我们总是会先入为主地将之与SQL想比，虽然HQL看起来很SQL，而且设计时就有这样的意图，但是毕竟是两种差别很大的东西，难免就会出现理解偏差的问题。好了，我们今天就不让大家脑袋发晕了，HQL我们暂时放一放。今天我们来说另外一种查询方法：

Criteria Query.

什么是Criteria Query?简单说，就是将我们的查询条件封装为一个预定义的查询对象，由这个查询对象来执行查询，而不用我们再去写HQL了，而且更接近我们贯常的编程习惯。

是不是很不错？让我们来look look：

 

// 创建关联到某个类的查询对象
ICriteria criteria  =  session.CreateCriteria( typeof (Person));

// 添加表达式
criteria.Add(Expression.Eq( " Name " , " Jackie Chan " ));

IList list  =  criteria.List();

注意这一句：

  

Expression.Eq( " Name " , " Jackie Chan " )

Eq是Equal的缩写，意思是添加一个查询表达式，Person.Name = “Jackie Chan”

对应HQL就是：

from Person p where p.Name=”Jackie Chan”

NHibernate会在运行时动态生成类似上面的HQL，我们可以在配置文件把show-sql打开，观看生成的SQL。

这样是不是感觉清晰多了？又回到我们以前的编码习惯了！

为了对应HQL的种种查询条件，NHibernate预定义了大量的Expression方法，我们列几个如下：

HQL的语义，详细的说明请参考api。

 

Eq           =  Equal
Gt           =  Greater than
Lt           =  Less than
Like         =  Like
Not          =  Not
IsNull       =  Is Null

基本上对应了大部分

下面，我们详细介绍Criteria的用法。

1． Example查询

我们常常有这样的查询页面：

用户可以输入“姓名”、“性别”、“年龄”等等来进行查询，而我们常常的做法就是如下的烦琐：

string  condition  =  “”;
if (txtName.Text  !=  null )
        condition  +=  “ Name = ”  +  txtName.Text;

if (txtSex.Text  !=  null )
       condition  +=  “ and Sex = ”  +  txtSex.Text;

……

代码看起来实在是不甚美观，有什么解决办法呢？

Criteria提供了专为这种问题而设计的Example查询，如下：

ICriteria criteria  =  session.CreateCriteria( typeof (Person));

Person person  =  new  Person();
person.Name  =  " Jackie Chan " ;
person.Age  =  50 ;

// 创建一个Example对象
criteria.Add(Example.Create(person));
IList list  =  criteria.List();

请注意：

  

criteria.Add(Example.Create(person));

这句代码的意思是通过构造的person对象的属性来生成表达式，实际生成的代码如下：

  

SELECT  this.id  as  id0_, this.name  as  name0_, this.age  as  age0_  FROM  Person this  WHERE  (this.age  =  @p0 )

对应上面的问题，我们简单地new出一个person对象，然后填充其属性即可，不用再去构造那丑陋的条件判断语句了！

2． 排序

我们想对返回的list进行排序，该怎么办呢？如下：

ICriteria criteria  =  session.CreateCriteria( typeof (Person));
criteria.Add(Expression.Gt( " Age " ,  20 )); 

// 添加一个排序对象
criteria.AddOrder(Order.Asc( " Age " ));

IList list  =  criteria.List();

请注意：

  

criteria.AddOrder(Order.Asc( " Age " ));

这句代码的意思是在criteria上构造一个排序对象，并以Age属性做正序排列，NHibernate在运行时会生成如下语句：

  

SELECT  this.id  as  id0_, this.name  as  name0_, this.age  as  age0_  FROM  Person this  WHERE  this.age  >  @p0  ORDER  BY  this.age  asc

如你所猜想，Order类肯定有另外一个“Desc“方法：）

3． 限制记录范围

在显示大量的记录时，我们常常采用的方法就是分页，如果用NHibernate来做，该怎么办呢？

如下代码：

ICriteria criteria  =  session.CreateCriteria( typeof (Person));

// 从第10条记录开始取
criteria.SetFirstResult( 10 );

// 取20条记录
criteria.SetMaxResults( 20 );

IList list  =  criteria.List();

这样，我们就达到了分页的目的。

注意：

NHibernate的分页机制实际上依赖于不同的数据库实现，所以，对特定的某种数据库，并不一定是效率最好的，比如对SQLServer（为什么受伤的总是俺？为什么总是说俺比不上Oracle？俺都赶在2005年年底出2005版本了！！）。想知道为什么吗？很简单，check一下上面代码生成的SQL就清楚了！或者深入点再看看NHibernate的分页代码，我就不解释了，自己动手，丰衣足食：）

总体来讲，Criteria对我们来说更熟悉，更容易上手，但是目前Criteria还是不够完善——将对应的HQL一一封装实在太烦琐了，所以NHibernate还是以HQL查询为主，我们在使用的时候则看需要了，要么使用HQL，要么HQL和Criteria混合使用，重要的是解决问题，对不？

好了，这一篇就讲这么多，我们下次再接着练习。