NHibernate 3 版本新特性

  • 李永京

2010 年 12 月 14 日

话题:.NET语言 & 开发架构

2010 年 12 月 4 号 Fabio Maulo 发布了 NHibernate 3.0.0.GA 正式版本,基于.Net3.5 和.NET 3.5 Client Profile 平台,主要改变是增加 Loquacious 配置和基于 Lambda 表达式查询和 Linq 查询。你可以到这里下载 NHibernate 3.0.0.GA。接着 Fabio Maulo 陆续发了NHibernate.Caches.3.0.0.GANHibernate.Validator.1.3.0.Alpha1ConfORM 1.0.1.2

下面是 NHibernate 3 版本新特性:

在 Configuration 部分新增两种 Loquacious-Configuration 方式:流配置 (fluent-configuration)lambda 表达式配置 (lambda-configuration)

fluent-configuration 顾名思义,使用 Fluent API 配置 SessionFactory 属性,提供强类型支持、编译期错误检查等。你可以通过SessionFactory fluent 配置了解详细信息。例如使用流配置方式最小配置 NHibernate:

var configure = new Configuration();
configure.SessionFactory()
   .Named("Demo")
   .Proxy.Through<ProxyFactoryFactory>()
   .Integrate
       .Using<MsSql2008Dialect>()
       .Connected
          .Using("ConnectionString");

lambda-configuration 是利用 C#3.0 扩展方法 (Extension Methods) 配置 SessionFactory 属性。你可以通过Configuration 篇之 SessionFactory lambda 配置Cache lambda-configuration 配置了解详情。例如使用 lambda 表达式方式最小配置 NHibernate:

var configure = new Configuration();
configure.SessionFactoryName("Demo");
configure.Proxy(p => p.ProxyFactoryFactory<ProxyFactoryFactory>());
configure.DataBaseIntegration(db =>
{
   db.Dialect<MsSql2008Dialect>();
   db.Driver<SqlClientDriver>();
   db.ConnectionString = ConnectionString;
});

新增WcfOperationSessionContext 类提供对 WCF 环境的支持,我们直接配置"current_session_context_class"为"wcf_operation"在 WCF 环境中应用 NHibernate。

对于 Mapping 部分,Fabio Maulo 完全重构了 NHibernate.Cfg.MappingSchema 代码部分,提高了性能。同时为 NHibernate 专门设计了一个配置 ORM 工具——ConfORM:解析 Domain 结构,按照模式适配器和自定义配置生成 HbmMapping 类,避免 NHibernate 通过读取 XML 映射文件反序列化等方式生成 HbmMapping 类的过程。不过ConfORM不是 NHibernate 的一部分,需要另外单独下载。李永京在自己的博客中介绍了这个工具,可以参考ConfORM 概览原理OneToOne 语义ManyToMany 语义Component 语义。我们可以这样使用:

var orm = new ObjectRelationalMapper();
orm.TablePerClass<Domain>();
var mapper = new Mapper(orm);
var hbmMapping= mapper.CompileMappingFor(new[] { typeof(Domain) });

在 Configuration 类中新增了AddDeserializedMapping(HbmMapping mappingDocument, string documentFileName) 方法,可以直接解析 HbmMapping,这样选择不使用 xml 文件而是 ConfORM。例如上面使用 ConfORM 生成的 hbmMapping 我们加到 Configuration 中:

var conf=new Configuration();
//...
conf.AddDeserializedMapping(hbmMapping, "Domain");

在 NHibernate 3.0.0 版本中,Query 方式新增了Linq 支持强类型查询 API(QueryOver)两种查询方式。

QueryOver 是 Lambda 表达式方式的条件 (Criteria) 查询,可读性强且支持 property-renaming 特性。可以参考QueryOver in NH 3.0。例如下面查询 Name 为李永京、按照 Age 降序的 Person 集合:

var query = s.QueryOver<Person>()
   .Where(p => p.Name == "李永京")
   .OrderBy(p => p.Age).Asc
   .List();

Linq 基于 HQL AST 分析器的 Linq Provider 实现,由Steve Strong贡献者开发的,底层使用第三方Re-Linq开源框架。不过 NHibernate3.0.0 版本提供的 Linq 查询还处于 Bate 阶段,Fabio Maulo 准备发布 3.1 版本修复 Linq 查询 BUG。可以参考:NHibernate.Linq 标准查询增强查询自定义扩展。我们使用 ISession 接口的 Query<T>() 扩展方法创建一个 NHibernate.Linq 查询。

var query = session.Query<Person>().Where(o => o.Name == "李永京").ToList();

还有其他一些新特性:

  1. 重构 Logging Abstraction 日志系统模块:移除对 log4net.dll 程序集依赖,现在可以用 CommonLogging 或者 NLog 日志系统。可以参考Using NLog via Common.Logging with NHibernate
  2. 属性延迟加载和 No Proxy 关联特性:具体使用方法可以参考 Ayende 的NHibernate new feature: Lazy PropertiesNHibernate new feature: No proxy associations两篇博文。它仅支持 Castle 的 bytecode-providers,不支持 Spring.Net 和 LinFu 代理。
  3. 映射支持 XDocument、System.Uri、XmlDoc、Local & Utc DateTime 类型。
  4. bytecode-providers 程序集更新:Castle 使用 2010 年 11 月 15 号发布的 2.5.2 正式版本,即 Castle.Core.dll 程序集。LiuFu 使用 2010 年 4 月 5 号发布的 1.04 版本,即 LinFu.DynamicProxy.dll 程序集。

如果从 NHibernate2.1.2 版本升级到 NHibernate3.0.0 版本,需要注意下面改变:

  1. NHibernate3.0.0 版本不支持.Net3.5 以下版本,即.Net2.0 版本不可以升级到 NHibernate3.0.0 版本。
  2. [NH-2392]ICompositeUserType.NullSafeSet 方法签名改变。
  3. [NH-2199]maps/dictionaries 中 null 值不再不加提示地忽略 / 删除。
  4. [NH-1894]SybaseAnywhereDialect 删除,代之以 SybaseASA9Dialect。删除了 Sybase Adaptive Server Enterprise (ASE) 方言。
  5. [NH-2251]Dialect 中的 GetLimitString 签名变化。
  6. [NH-2284]删除了过时的成员。
  7. [NH-2358]DateTimeOffset 类型现在不再是 DateTime 的替代。

最近一年,网络上出现了一些优秀的 NHibernate 工具:

  1. HQL Language Service for Visual Studio:为我们编写 HQL 查询提供了智能提示和语法验证检查功能。
  2. NHibernate Profile:可视化 NHibernate 性能检测优化工具。
  3. Visual NHibernate:可视化设计和映射工具。
  4. Mindscape NHibernate Designer:VS 设计工具,类似于 EF 设计器。

其中 HQL Language Service for Visual Studio 是一款开源工具,其他都是商业版本。

据我了解的情况来看,将来的版本发布预计一两个月后会发布 3.1 版本,然后就升级至.Net4 平台开发 NHibernate 4 版本,主要就是逐步改写内部代码去掉 Iesi.Collections.dll,使用.Net4 提供的 ISet 集合和添加一些新功能,比如Duck Typing(鸭子类型) 等。另外,NHibernate 源码将迁移到 CodePlex 网站,使用 Hg 版本控制。

感谢李永伦对本文的审校。

.NET语言 & 开发架构