阅读更多
查看文章
NHibernate Step by Step (五)Criteria Query2007-05-15 11:45NHibernate 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方法,我们列几个如下:
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混合使用,重要的是解决问题,对不?
HQL的语义,详细的说明请参考api。