学步园

本文参考张老三大哥在网上发布的《NHibernate（一）》（主要）和其它一些从网上的资料，做为学习NHibernate的基础，非常感谢这些大侠，这里还要特别感谢陈锂榕同学，是你们帮助了我更好的学习NHibernate。

本文约定：
１．NHibernate简写为NH；
２．本文例子的开发平台为：WinXP + sp2 ，SqlServer 2005，NHibernate 1.0.0.0；
３．本文只是本人学习NHibernate时随手写的学习笔记，不保证程序的准确性，使用本程序造成的任何损失与本人无关；
４．转载请注明出处。

本文的内容：
１．简单介绍NH；
２．使用NH实现单表单对象的CRUD操作。

经验教训：
１．实体类的映射文件的Build Action属性务必设为Embedded Resource，若则会出错；
２．使用NH操作数据表时，数据表表名和字段名不能为SqlServer 2005的关键字，若则会提示：could not User...

点击下载本文相关代码

下面是张老三大哥对NHibernate的介绍，照搬过来。

一、NH简介
　　NH是基于ms.net的O/R Mapping持久框架，它从基于Java的Hibernate项目移植而来。O/R Mapping就是把对象到映射关系数据库的记录，简单的说就是能实现把一个对象存储为数据表中的一条记录和由一条记录创建一个相应的对象，数据表中的数据就是对象的属性。
　　那么为什么要使用O/R Mapping？它与传统的DataSet/DataTable又有什么不同了？
　　首先是设计上的不同，当使用O/R Mapping时，更多的是从对象的角度来设计程序，而把数据(对象的属性)存储的细节放在后面, 可以完全采用面向对象(OO)的方式来设计，而在使用DataSet/DataTable时，它只是存放数据的对象，看起来更像一个数据表，不能直观的表达业务概念。

二、NH中主要接口的介绍
　　ISession：是面向用户的主要接口，主要用于对象持久化，数据加载等操作，支持数据库事务，它隐藏了NHB内部复杂的实现细节，ISession由ISessionFactory创建。

　　ISessionFactory：是NHB内部的核心类，它维护到持久机制(数据库)的连接并对它们进行管理，同时还会保存所有持久对象的映射信息。
　　ISessionFactory由Configuration创建，因为创建ISessionFactory的开销非常大（需要加载映射信息），所以这个对象一般使用Singleton（单例）模式。

　　ITransaction：是NH的事务处理接口，它只是简单的封装了底层的数据库事务。事务必须由ISession来启动。

　　ICriteria：是Expression(表达式)数据加载接口，Expression是一个关系表达式组合，通过它能产生SQL语句的Where部分, 用户需要通过ISession来间接调用它。

　　IQuery：是HQL数据加载接口，HQL(Hibernate Query Language)是NHB专用的面向对象的数据查询语言，它与数据库的SQL有些类似，但功能更强大！同ICriteria一样，也需要通过ISession来间接调用它。

三、介绍张老三文章中封装的几个类：BizObject、ObjectBroker、Sessions。

Sessions类：封装了NH中的ISession和ISessionFactory两个接口，Sessions类的属性和方法都是静态的，它有一个Factory属性, 用于返回ISessionFactory, 有一个GetSession方法，用于取得一个新的ISession。Sessions类的代码如下：

using System;
using NHibernate;
using System.Reflection;

namespace NHibernateTest
{
    /**//// 
    /// Sessions 的摘要说明。
    /// 
    public class Sessions
    {
        private static readonly object lockObj = new object();
        private static ISessionFactory _factory;

        public Sessions()
        {
            //
            // TODO: 在此处添加构造函数逻辑
            //
        }
        public static ISessionFactory Factory
        {
            get
            {
                if (_factory == null)
                {
                    lock (lockObj)
                    {
                        if (_factory == null)
                        {
                            NHibernate.Cfg.Configuration cfg = new NHibernate.Cfg.Configuration();
                            cfg.AddAssembly(Assembly.GetExecutingAssembly());
                            _factory = cfg.BuildSessionFactory();
                        }
                    }
                }
                return _factory;
            }
        }
        public static ISession GetSession()
        {
            return Factory.OpenSession();
        }

    }
}

ObjectBroker类：ObjectBroker对ISession进行了必要的封装，通过ISession,就可以简单的完成对象的CRUD操作了。ObjectBroker类的代码如下：

using System;
using NHibernate;

namespace NHibernateTest
{
    /**//// 
    /// ObjectBroker 的摘要说明。
    /// 
    public class ObjectBroker
    {
        private ObjectBroker() { }

        public static void Load(object obj, object id)
        {
            ISession s = Sessions.GetSession();
            try
            {
                s.Load(obj, id);
            }
            finally
            {
                s.Close();
            }
        }

        public static void Create(object obj)
        {
            ISession s = Sessions.GetSession();
            ITransaction trans = null;
            try
            {
                trans = s.BeginTransaction();
                s.Save(obj);
                trans.Commit();
            }
            finally
            {
                s.Close();
            }
        }

        public static void Update(object obj)
        {
            ISession s = Sessions.GetSession();
            ITransaction trans = null;
            try
            {
                trans = s.BeginTransaction();
                s.Update(obj);
                trans.Commit();
            }
            finally
            {
                s.Close();
            }
        }

        public static void Delete(object obj)
        {
            ISession s = Sessions.GetSession();
            ITransaction trans = null;
            try
            {
                trans = s.BeginTransaction();
                s.Delete(obj);
                trans.Commit();
            }
            finally
            {
                s.Close();
            }
        }
    }

}

BizObject：业务实体类的基类，实现CRUD操作。BizObject类的代码如下：

using System;

namespace NHibernateTest
{
    /**//// 
    /// BizObject 的摘要说明。
    /// 
    public class BizObject
    {
        public BizObject() { }

        public BizObject(object existingId)
        {
            ObjectBroker.Load(this, existingId);
        }
        public virtual void Create()
        {
            ObjectBroker.Create(this);
        }
        public virtual void Update()
        {
            ObjectBroker.Update(this