NHibernate3.0剖析:Query篇之NHibernate.Linq标准查询
系列引入
NHibernate3.0剖析系列分别从Configuration篇、Mapping篇、Query篇、Session策略篇、应用篇等方面全面揭示NHibernate3.0新特性和应用及其各种应用程序的集成,基于NHibernte3.0版本。如果你还不熟悉NHibernate,可以快速阅读NHibernate之旅系列文章导航系列入门,如果你已经在用NHibernate了,那么请跟上NHibernate3.0剖析系列吧。
- NHibernate专题:http://kb.cnblogs.com/zt/nhibernate/
- NHibernate官方站点:http://nhforge.org/
- NHibernate参考文档:http://nhforge.org/doc/nh/en/
- 获取NHibernate地址:http://sourceforge.net/projects/nhibernate/
NHibernate.Linq概述
NHibernate.Linq基于HQL AST分析器的Linq Provider,由Steve Strong贡献者开发的,底层使用第三方Re-Linq开源框架。所以NHibernate3.0多了一个必需程序集:Remotion.Data.Linq.dll。
注意:在之前NHibernate版本中并不存在Linq功能,Ayende Rahien贡献者为NHibernate2.1.0GA和NHibernate2.1.2GA版本设计第三方NHiberante.Linq.dll(对应为NHibernate.Linq-1.0.0.GA-bin.zip和NHibernate.Linq-2.1.2-GA-Bin.zip)(目前已经停止了维护),它是基于Criteria API的Linq Provider,主要功能是将简单的Linq表达式转化为Criteria API,由于Criteria API的功能有限,所以存在很多天生的不足(联接和子查询不支持)。如果使用NHibernate2.1.0GA或者NHibernate2.1.2GA版本可以下载使用NHiberante.Linq.dll,在这里不作介绍。
下面看看NHibernate提供的全新的NHibernate.Linq查询。
我们使用ISession接口的Query<T>()扩展方法创建一个NHibernate.Linq查询。
首先需要using NHibernate.Linq命名空间,然后使用ISession.Query<T>()获得IQueryable<T>,我们对其做一些延迟操作(例如where、orderby等),最后使用不延迟的操作(例如ToList()、Count()、FirstOrDefault())返回需要的结果。
注意,NHibernate.Linq查询将Linq运算符转换为HQL,有些Linq运算符本身是专门处理集合的,而SQL主要是在处理无序值集。所以NHibernate.Linq查询肯定不需要支持这些专门处理集合的运算符,例如Except、Intersect、转换运算符、生成运算符等。
下面列举所有Linq运算符和说明,并列举了一些简单的NHibernate.Linq查询,我仅仅对单一对象User对象操作:
//Code Snippets Copyright http://lyj.cnblogs.com/
public class User
{
public Guid Id { get; set; }
public string Name { get; set; }
public int Age { get; set; }
}
标准查询运算符
1.基本形式
使用ISession的Query<User>(),然后ToList()查询出所有的User对象。
//Code Snippets Copyright http://lyj.cnblogs.com/
var basicquery = (from user in session.Query<User>()
select user).ToList();
var basicquery2 = session.Query<User>().ToList();
2.限制运算符
- Where:筛选序列中的项目
说明:对属性值一些筛选,筛选属性支持组件、枚举、各种关联、支持基本类型的方法。例如Int等类型的等于、大于、小于,不等于;String类型的StartsWith、EndsWith、Contains、Equals、ToLower、ToLowerInvariant、ToUpper、ToUpperInvariant、Substring、IndexOf等;DateTime的Year、Date、Month等。也可以在Where运算符中使用聚合操作符的子查询。
//Code Snippets Copyright http://lyj.cnblogs.com/
var restrictionquery = (from user in session.Query<User>()
where user.Name == "李永京"
select user).ToList();
var restrictionquery2 = session.Query<User>().Where(o => o.Name == "李永京").ToList();
3.投影运算符
- Select:创建部分序列的投影
- SelectMany:创建部分序列的一对多投影
说明:Select运算符对于大多数操作都支持,也支持子查询,但是不支持嵌套Select。SelectMany不支持。
//Code Snippets Copyright http://lyj.cnblogs.com/
var selectAnonymousquery = (from user in session.Query<User>()
select new {user.Name, Age = user.Age}).ToList();
var selectAnonymousquery2 = session.Query<User>()
.Select(o => new {o.Name, Age = o.Age})
.ToList();
4.分区运算符
- Skip:返回跳过指定数目项目的序列
- SkipWhile:返回跳过不满足表达式项目的序列
- Take:返回具有指定数目项目的序列
- TakeWhile:返回具有满足表达式项目的序列
说明:不支持SkipWhile和TakeWhile。不支持连写多个Take或者Skip。
//Code Snippets Copyright http://lyj.cnblogs.com/
var partitioningquery = (from user in session.Query<User>()
select user).Take(2).Skip(2).ToList();
var partitioningquery2 = session.Query<User>().Take(2).Skip(2).ToList();
5.排序运算符
- OrderBy:以升序按值排列序列
- OrderByDescending:以降序按值排列序列
- ThenBy:升序排列已排序的序列
- ThenByDescending:降序排列已排序的序列
- Reverse:颠倒序列中项目的顺序(用于操作集合)
说明:排序运算符不支持子查询。
//Code Snippets Copyright http://lyj.cnblogs.com/
var orderingquery = (from user in session.Query<User>()
orderby user.Id descending, user.Name ascending
select user).ToList();
var orderingquery2 = session.Query<User>()
.OrderByDescending(o => o.Id).OrderBy(o=>o.Name).ToList();
6.分组运算符
- GroupBy:按指定分组方法对序列中的项目进行分组
例如下面查询:
//Code Snippets Copyright http://lyj.cnblogs.com/
var groupquery = (from user in session.Query<User>()
group user by user.Name
into g
select new
{
g.Key,
Age = g.Sum(p => p.Age)
}).ToList();
var groupquery2 = session.Query<User>().GroupBy(o => o.Name)
.Select(o =>new { o.Key, Age = o.Sum(p => p.Age)}).ToList();
7.设置运算符
- Distinct:返回无重复项目的序列
- Except:返回代表两个序列差集的序列(用于操作集合)
- Intersect:返回代表两个序列交集的序列(用于操作集合)
- Union:返回代表两个序列交集的序列(用于操作集合)
目前支持Distinct:
//Code Snippets Copyright http://lyj.cnblogs.com/
var distinctquery = session.Query<User>().Distinct().ToList();
8.转换运算符(用于操作集合)
- Cast:将序列中的元素转换成指定类型
- OfType:筛选序列中指定类型的元素
- ToArray:从序列返回一个数组
- ToDictionary:从序列返回一个字典
- ToList:从序列返回一个列表
- ToLookup:从序列返回一个查询
- ToSequence:返回一个IEnumerable序列
NHibernate.Linq不需要支持。
9.元素运算符
- DefaultIfEmpty:为空序列创建默认元素(用于操作集合)
- ElementAt:返回序列中指定索引的元素(用于操作集合)
- ElementAtOrDefault:返回序列中指定索引的元素,或者如果索引超出范围,则返回默认值(用于操作集合)
- First:返回序列中的第一个元素
- FirstOrDefault:返回序列中的第一个元素,或者如果未找到元素,则返回默认值
- Last:返回序列中的最后一个元素(用于操作集合)
- LastOrDefault:返回序列中的最后一个元素,或者如果未找到元素,则返回默认值(用于操作集合)
- Single:返回序列中的单个元素
- SingleOrDefault:返回序列中的单个元素,或者如果未找到元素,则返回默认值
例如下面例子:
//Code Snippets Copyright http://lyj.cnblogs.com/
var firstquery = session.Query<User>().First(u => u.Name == "李永京");
var firstOrDefaultquery = session.Query<User>().FirstOrDefault(u => u.Name == "李永京");
var singlequery = session.Query<User>().Single(u => u.Name == "李永京");
var singleOrDefaultquery = session.Query<User>().SingleOrDefault(u => u.Name == "李永京");
10.生成运算符(用于操作集合)
- Empty:生成一个空序列
- Range:生成一个指定范围的序列
- Repeat:通过将某个项目重复指定次数来生成一个序列
NHibernate.Linq不需要支持。
11.限定符
- All:确定序列中的所有项目是否满足某个条件
- Any:确定序列中是否有任何项目满足条件
- Contains:确定序列是否包含指定项目
仅写下Any示例:
//Code Snippets Copyright http://lyj.cnblogs.com/
var anyquery = session.Query<User>().Any();//就是取任意一个
12.聚合运算符
- Aggregate:对序列执行一个自定义方法
- Average:计算数值序列的平均值
- Count:返回序列中的项目数(整数)
- LongCount:返回序列中的项目数(长型)
- Min:查找数字序列中的最小数
- Max:查找数字序列中的最大数
- Sum:汇总序列中的数字
一些简单例子:
//Code Snippets Copyright http://lyj.cnblogs.com/
var aggregatequery = session.Query<User>()
.Where(o => o.Name.Contains("李永京"))
.Select(o => o.Id)
.Aggregate(new StringBuilder(), (sb, id) => sb.Append(id).Append(","));
var average = session.Query<User>().Average(u => u.Age);
var countquery = session.Query<User>().Count();
var longCountquery = session.Query<User>().LongCount();
var minquery = session.Query<User>().Min(u => u.Age);
var maxquery = session.Query<User>().Max(u => u.Age);
var sumquery = session.Query<User>().Sum(u => u.Age);
13.连接运算符
- Concat:将两个序列连成一个序列
目前还未支持!
14.联接运算符
- GroupJoin:通过归组将两个序列联接在一起
- Join:将两个序列从内部联接起来
涉及对象关联操作,以后单独介绍。
结语
这篇利用单一对象学习下NHibernate.Linq最基本的标准查询,没有涉及多个对象操作,比较简单,目的让大家先熟悉一下NHibernate.Linq查询。接下来的继续学习NHibernate.Linq。主要有NHibernate.Linq复杂标准查询、NHibernate.Linq增强查询、自定义NHibernate.Linq查询及其在项目中的应用。
希望本文对你有所帮助。