NHibernate 3版本新特性

柳宾实
2023-12-01

Configuration部分

在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部分

对于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");

Query部分

在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();

其他

还有其他一些新特性:

重构Logging Abstraction日志系统模块:移除对log4net.dll程序集依赖,现在可以用CommonLogging或者NLog日志系统。可以参考Using NLog via Common.Logging with NHibernate

属性延迟加载和No Proxy关联特性:具体使用方法可以参考Ayende的NHibernate new feature: Lazy PropertiesNHibernate new feature: No proxy associations两篇博文。它仅支持Castle的bytecode-providers,不支持Spring.Net和LinFu代理。

映射支持XDocument、System.Uri、XmlDoc、Local & Utc DateTime类型。

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是一款开源工具,其他都是商业版本。

 类似资料: