NHibernate3剖析：Mapping篇之ConfORM实战(1):概览

本节内容

• 系列引入
• ORuM思想浮出
• ConfORM概述
• ConfORM初试
• 结语
• 参考资料

系列引入

NHibernate3剖析系列分别从Configuration篇、Mapping篇、Session篇、Core篇、Tool篇、Practice篇、Extension篇等方面全面揭示NHibernate3版本内容、特性及其应用，完全基于NHibernte3版本。

• NHibernate专题：http://kb.cnblogs.com/zt/nhibernate/
• NHibernate官方站点：http://nhforge.org/
• NHibernate参考文档：http://nhforge.org/doc/nh/en/
• 获取NHibernate地址：http://sourceforge.net/projects/nhibernate/files/

ORuM思想浮出

对于ORM(Object Relational Mapping)我们太熟悉了，但是我们从另一个角度可以想象出ORuM(Object Relational un-Mapping)的思想理念。我们在程序中仅仅定义Domain， 而想有个工具可以帮助我们"自动化"实现Mapping，我们无需按传统的ORM思想那样为Domain手动编码Mapping。

ORuM对于使用者来说更像ORAM(Object-Relational Auto-Mapping)或者ORIM(Object-Relational Intelligent-Mapping)的意思。

有没有这样的实现呢？答案是相当肯定的。

ConfORM概述

ConfORM是NHibernate贡献者Fabio Maulo大牛设计的，是一个配置ORM的工具，其接口按照ORM思想定义，基于GNU Lesser General Public License协议。其设计思想来源就是 ORuM(Object Relational un-Mapping)。它按照Domain定义帮助我们"自动"实现Mapping。现在仅仅实现了对NHibernate的"自动"Mapping，如果有兴趣的话，可以添加对EF实现自动Mapping功能。

那么ConfORM到底如何"自动"的呢？

NHibernate对Mapping的处理过程，就是将XML文件反序列化为HbmMapping类，再将HbmMapping类Bind为Mappings，最后Bind SessionFactory。而ConfORM就是利用Domain定 义实现自动生成HbmMapping类，完全避免了编写XML文件和反序列化。这样的话，ConfORM正是起到了ORAWM“object to relational adapter without mappings"的作用。

你可以到http://code.google.com/p/codeconform/ 获取ConfORM

ConfORM初试

这是这个系列的第一篇，我们用一个简单的例子实现一下吧，以后慢慢介绍其细节。首先我们写下NHibernate基础代码和通用代码，这一步的代码在将来的文章中也经常使用，以后就不单独贴出来了。

//Code Snippets Copyright http://lyj.cnblogs.com/
public static class NhConfig
{
    private const string ConnectionString =
        @"Data Source=.\SQLEXPRESS;Initial Catalog=NHTest;Integrated Security=True;Pooling=False";
    public static Configuration ConfigureNHibernate()
    {
        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;
                                              db.LogSqlInConsole = true;//用于显示输出SQL
                                          });
        return configure;
    }

    public static string Serialize(HbmMapping hbmElement)
    {
        var setting = new XmlWriterSettings { Indent = true };
        var serializer = new XmlSerializer(typeof(HbmMapping));
        using (var memStream = new MemoryStream(2048))
        using (var xmlWriter = XmlWriter.Create(memStream, setting))
        {
            serializer.Serialize(xmlWriter, hbmElement);
            memStream.Flush();
            memStream.Position = 0;
            var sr = new StreamReader(memStream);
            return sr.ReadToEnd();
        }
    }
}

ConfigureNHibernate()方法用于配置NHibernate，Serialize方法用于输出。我们开始ConfORM之旅吧：

1.定义一Domain

开始之旅，我们总是从最简单的入手，将来慢慢学习ConfORM到底如何"自动"为我们复杂的Domain结构生成出Mapping的。

//Code Snippets Copyright http://lyj.cnblogs.com/
public class Domain
{
    public virtual int Id { get; set; }
    public virtual string Name { get; set; }
}

2.ConfORM配置

这一步非常重要，是ConfORM的核心所在，实例化一个ObjectRelationalMapper对象，装配Domain对象，实例化Mapper对象，调用Mapper对象的CompileMappingFor()方法自动生成HbmMapping。

//Code Snippets Copyright http://lyj.cnblogs.com/
public static HbmMapping GetMapping()
{
    var orm = new ObjectRelationalMapper();
    orm.TablePerClass<Domain>();
    var mapper = new Mapper(orm);
    return mapper.CompileMappingFor(new[] { typeof(Domain) });
}

3.ConfORM之旅

这一步关键环节是调用Configuration对象的AddDeserializedMapping()方法添加HbmMapping和配置元数据。

//Code Snippets Copyright http://lyj.cnblogs.com/
public static void JustForConfOrm()
{
    //配置NHibernate
    var conf = NhConfig.ConfigureNHibernate();
    //在Configuration中添加HbmMapping
    conf.AddDeserializedMapping(GetMapping(), "Domain");
    //配置元数据
    SchemaMetadataUpdater.QuoteTableAndColumns(conf);
    //创建数据库架构
    new SchemaExport(conf).Create(false, true);
    //建立SessionFactory
    var factory = conf.BuildSessionFactory();
    //打开Session做持久化数据
    using (var s = factory.OpenSession())
    {
        using (var tx = s.BeginTransaction())
        {
            var domain = new Domain {Name = "我的测试"};
            s.Save(domain);
            tx.Commit();
        }
    }
    //打开Session做删除数据
    using (var s = factory.OpenSession())
    {
        using (var tx = s.BeginTransaction())
        {
            s.CreateQuery("delete from Domain").ExecuteUpdate();
            tx.Commit();
        }
    }
    //删除数据库架构
    new SchemaExport(conf).Drop(false, true);
}

4.输出XML

好了，做了上面3步就完成了我们的测试：NHibernate自动创建数据库架构、持久化数据、删除数据、最后把数据库架构删除。这时大家都有一个疑问，ConfORM自动生成的HbmMapping是什么啊？ 序列化HbmMapping对象到底输出什么？为了满足大家的需求我们写段代码让ConfORM打印出XML，对照我们以往手写的*.hbm.xml文件看看是否符合：

//Code Snippets Copyright http://lyj.cnblogs.com/
public static void ShowXmlMapping()
{
    var document = NhConfig.Serialize(GetMapping());
    File.WriteAllText("MyMapping.hbm.xml", document);
    Console.Write(document);
}

这时，我们打开输出目录的MyMapping.hbm.xml文件看看内容：

//Code Snippets Copyright http://lyj.cnblogs.com/
<?xml version="1.0" encoding="utf-8"?>
<hibernate-mapping xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                   namespace="YJingLee.ConfOrm" assembly="YJingLee.ConfOrm"
                   xmlns="urn:nhibernate-mapping-2.2">
  <class name="Domain">
    <id name="Id" type="Int32">
      <generator class="hilo" />
    </id>
    <property name="Name" />
  </class>
</hibernate-mapping>

恩，是手写的完全一样，ConfORM可以意识到Domain类的成员，Id为主键使用了hilo生成策略，Name为属性。咦，难道只会这样生成？答案当然不是，ConfORM提供了很多模式和定制化，这方面在以后一一介绍。

仅仅使用了第二步的那几行代码就完成了自动映射的功能，是不是很酷，看过这篇文章后，你是不是非常急切的想跟着我学习下ConfORM，然后试着重构自己的老程序，抛掉hibernate.cfg.xml和*.hbm.xml文件了啊。

结语

这篇文章先带着大家走进ConfORM，其细节接下来慢慢介绍，大家有什么问题和思考可以回复。

附上源码下载：YJingLee.TryConfOrm.zip (VS2010项目)

参考资料

Fabio Maulo：ConfORM: NHibernate un-Mapping