NHibernate 变的简单

　　下载示例程序代码 - 1,162.6 KB

　　前言

　　这篇文章出自于我尝试学习使用Nhiberbnate的挫败感。我发现好像Nhibernate全部的介绍材料不是很模糊就是太详细。我所需要的就是一个简单直接的教程，能让我尽快对NHibernate熟悉起来。我从来没有找到。幸运的是，这篇文章将会满足别人的这些需求。

　　这篇文章有些长，但是我鼓励你以你的方式来阅读。NHibernate是一个复杂的程序，是一个绵延曲折的学习过程。这篇文章将为你踏平曲折，从几天或是几周缩短到几个小时。

　　问题

　　NHibernate目的是解决一个众所周知的问题，对象持久代码在开发过程中的瓶颈问题。很多文章表明：1/4到1/3的程序代码是关于对象持久化，从数据库中读取数据，和将数据写回数据库。代码是重复的，耗费时间的，还有很多琐碎的代码要写。

　　对于这个问题，有很多解决方案是可用的。代码生成可以在几秒钟生成数据访问代码。但是如果业务模型改变，这些代码需要重新生成。"对象关系映射"（ORMs）使用了一种新的方式，像NHibernate。他们管理数据访问更加透明，提供了很多简洁的API，可以使用一辆行代码来实现加载和保存整个对象。

　　介绍NHibernate

　　NHibernate是一个持久化引擎框架。它从数据库中加载业务对象，以及将这些对象的变化更新到数据库中。从文章上面可以看出，它可以只使用一两行代码实现业务对象的加载和保存。

　　NHibernate使用映射文件来引导从数据库数据到业务对象的转换。还有一种方法，你可以使用类的特性和属性来替代映射文件。为了让事情尽量简单，我们在这篇文章中将使用映射文件，而不是使用类特性。另外，映射文件能够很清晰的将业务逻辑和持久化代码分开。

　　好了，我们只需要在程序中添加几行代码，和为每一个映射文件创建持久化类，而且NHibernate可以照顾到所有的数据库操作。真不知道使用NHibernate将为我们节省多少开发时间。

　　记住在.NET环境下，NHibernate并不是唯一的ORM框架。有许多商业的和开源的产品可以提供这样的服务。NHibernate是其中最流行的，主要是因为他遗传自强大的Hibernate，一个Java环境下非常流行的ORM框架。另外，微软也为ADO.NET提供了"Entity Framework"，来提供ORM服务。但是，这个产品已经延迟，好长时间已经没有再释放了。

　　安装NHibernate

　　使用NHibernate的第一步就是下载NHibernate和Log4Net（一个开源的日志记录程序，NHibernate使用它来记录错误和警告），NHibernate包含了Log4Net最新的版本，你也可以下载整个Log4Net安装包，这里是下载地址：

• NHibernate
• Log4Net

　　NHibernate不是直接需要Log4Net，可是在调试期间它的自动记录日志功能非常有用。

　　现在开始

　　在这篇文章中，我将使用一个简单的示例程序，而不是解说如何使用NHibernate来进行数据访问。这是一个控制台应用程序，通过消除UI代码让程序变的更加简单。这个程序将创建很多个业务对象，来使用NHibernate来对他们进行持久化，然后将他们从数据库中读取出来。

　　为了程序运行起来，你需要做一下几个事情：

• 为陈旭添加NHibernate和Log4Net的程序集引用
• 为程序添加数据库
• 修改数据库连接字符串

　　这个示例程序引用NHibernate和Log4Net。这些应用应该被你的机器识别，如果你的NHibernate和log4net安装在默认的目录里。如果这些引用不被识别，你可以分别使用NHibernate.dll和Log4Net.dll来替换引用位置。这些DLL文件可以在NHibernate的安装目录中找到。

　　这个示例程序是按照SQL Server Express 2005来配置的，数据库文件（NhibernateSimpleDemo.mdf和NhibernateSimpleDemo.ldf）已经打包在压缩文件里。你可以将数据库搭在你机器的SQL Server上。

　　最后，数据库的连接字符串配置在App.config文件中，默认你使用的是SQL Server数据库。你可以自己根据自己机器SQL Server的版本，来修改数据库的连接字符串。

　　业务模型

　　这里有两种方法使用NHibernate创建应用程序。第一种是“以数据为中心”的方法，它从数据模型和创建业务对象开始。第二种是“以对象为中心”的方法，从业务模型和创建数据库来持久化这个模型开始。这个示例程序使用以对象为中心的方式。

　　这里示例中的业务模型：

　　这个模型表现了一个订单系统的框架，这个模型是不完整的，这里只是使用了几个类来解说使用NHibernate对象持久化。显然这个模型的设计不能代表最佳实践，但是用来展示NHibernate是怎样工作的已经足够应付了。

　　此文将使用这个模型来解说使用NHibernate进行对象持久化的几个概念。

• 处理简单属性
• 处理Components
• 处理one-to-many
• 处理many-to-one
• 处理many-to-many

　　此文不会涉及高级主题,像继承。

　　这个模型由5个类组成，其中的4个是要持久化的类，非持久化类OraderSystem当做这个对象模型的宿主。我们将会在程序运行时初始化OrderSystem对象，然后我们将加载其他的对象到OrderSystem中来。

　　OrderSystem.Customers属性拥有销售者的客户列表，Customers可以通过CustomerID来访问，每一个Customer对象拥有一个ID，name，和address、一个序列的orders。address将被包成一个单独的Address类中。

　　Order类包含了一个订单的ID，时间，顾客信息，和许多购买的产品信息。

　　Product类包含ID，名称。

　　请注意我们只注重NHibernate是怎么工作的，程序初始化时，Product对象将被实例化放入OrderSystem.Catalog属性中，当一个订单被创建时，Product对象引用将不复制到Order.OrderItems属性中。

　　NHibernate一个强大的特点就是不需要为业务类实现特别的接口。事实上，业务对象通常不会担心被持久化机制来加载和保存他们。NHibernate使用的映射数据保存在分离的XML文件中。

　　数据库

　　数据库和对象模型并不是完全匹配，对象模型中包含一个Address类，但是数据库中并没有与之对应的表。数据库中有OrderItems表，但是对象模型中并没有与之对应的持久化的类。这里的不匹配并不是故意的，我们想展示的NHibernate其中的一个概念就是这里并不需要数据库中的表跟类是一一对应的。

　　这里是为什么不完全匹配的原因：

• Address类并不能代表业务模型的一个实体，相反，它只代表一个实体的值，在这个示例中，代表Customer.Address 属性，我们将Address分离一个单独的类，这样我们可以解说什么叫NHibernate使用“Component mapping”。
• OrderItems表是多对多关系中Orders和Products的连接表，这样也不能代表对象模型中的一个实体。

　　Customer表包含了一个普通Customer信息的骨架，包含Customer的Address信息。最佳实践不会像我们这样，将会把Address分离在一个单独的表中。我们把Address信息保存在Customer表中，这样我们可以解释什么是NHibernate使用‘Components’类，而不使用Address自己的表，我们将在下面讨论Components的详细用法。

　　Orders表只包含一个订单的最简单的信息，只有ID，时间，和CustomerID。Orders和Customers之间的关系通过一个外键orders.ustomerID 列对应 Customer.ID列。

　　所有的订单学要一个多对多的关系（每一条订单包含很多条商品信息，每一条商品信息又被包含在很多订单里），所以我们需要OrderItems表来当作中介，简单的连接Order编号和Product编号。

　　这个数据库并不是一个最佳实践，它所包含的信息仅仅用来展示NHibernate是怎样工作的。

　　映射业务模型

　　许多介绍NHibernate的文章都是以配置文件开始的，但是从另一个地方开始：映射类。映射是NHibernate的核心，而且配置也给初学者一个很大的绊脚石。当我们讨论完映射，我们再回来介绍NHibernate的配置部分。

　　映射简单的指定哪一个表对应哪一个类。我们把映射的类对应的表叫这个类的“映射表”。

　　我们在上面就已经说了，Nhibernate不需要特定的接口或是特定的代码写在要映射的类里。但是它需要被声明成Virtual，这样可以在需要的时候创建代理。NHibernate文档里讨论了为什么这样，现在我们把所有业务模型中的类声明成Virtual。

　　映射可以同过分离的XML文件实现，也可以通过在类属性上添加特性来实现。被用于映射的XML文件可以在任何一个项目里引用。为了简单，我们将展示其中一个方法：通过XML文件映射，映射文件需要被编译成程序集的嵌入式资源。

　　你可以映射很多类在同一个映射文件中，但是通常都会为每一个类创建一个映射文件。这样可以保持映射文件的短小，而且容易阅读。

　　开始我们映射实验之前，先让我们看看Customer.hbm.xml文件。hbm.xml后缀的文件是NHibernate标准的映射文件的后缀。我们把映射文件放在Model文件下，但是我们可以把他们放在项目的任何一个地方。最关键的一点是将文件的 BuildAction 属性设置为 Embedden Resource（嵌入式资源）。这个设置将会把映射文件编译到程序集里，这样把他们从程序中脱离出来。

　　映射文件都是标准的格式：

<?xml version="1.0"?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"
namespace="NHibernateSimpleDemo"
assembly="NHibernateSimpleDemo">

　　第一个标签是XML声明，第二个标签定义了XML的命名空间，你可以在这里加入一个XSD信息。第二个标签还包含了属性信息，定义了映射文件要被使用在的程序集名称，这样可以让我们避免在映射标签里写所有的类名。

　　<class>标签

　　下一个标签用来识别我们需要映射的类：

<!-- Mappings for class 'Customer' -->
<class name="Customer" table="Customers" lazy="false">

　　<class>标签的属性指定了要映射的类，以及它的映射表：

• name属性指定要映射的类名
• table属性指定类的映射表
• lazy属性告知NHibernate对这个类不用使用'lazy loading'

　　'lazy loading' 告知NHibernate不要从数据库表中加载这个类对象，直到程序中需要访问这个对象的数据时才加载。这种方式可以减少一个业务对象的内存占用，从而提高性能。处于简单，我们将在这个示例程序中不使用lazy loading。但是在以后使用NHibernate做项目的时候，一直到早点知道它的来龙去脉。

　　<class>标签中还有很多属性，可以查阅NHibernate的帮助文档。

　　<id>标签

　　我们已经标识了类和类对应的映射表，接下来我们需要标识类的标识属性和映射表中的标识列。当我们创建数据的时候，我们需要标识CustomerID为主键（primary key）。

　　所以要这些：

• 指定Customer类的标识属性
• 指定Customer表记录的标识列
• 告知NHibernate让SQL Server设置CustomerID列的值

<!-- Identity mapping -->
<id name="ID">
<column name=" CustomerID " />
<generator class="native" />
</id> 

　　<generator>标签指定数据库记录的标识列的值由SQL Server数据库原生生成。

　　简单属性

　　我们设置好类的标识属性，我们接下来设置类的一般属性，Customer类有一个简单属性：Name。我们把它跟数据库Customer表Name列匹配，属性名和列名相同，所以映射文件很简单：

<!-- Simple mappings -->
<property name="Name" />

　　我们可以匹配Name属性到一个不同名称的列上（如CustomerName）。

　　Component映射

　　NHibernate使用component来映射那些在数据库中没有相应的表来映射的类，就像上面提到的Address类，只是作为Customer的一个属性值，数据库中没有对应的Address表，它遵循一个区别往往出现在"实体类"和"值类"。

• 一个实体类在业务模型中代表着一个实体，在我们的业务模型中，实体类是Customer、Order、和OrderItem。这些类对应着一个业务对象。
• Address类并不代表一个业务对象，它提供了一种封装类值的方式，在NHibernate的术语里，它是一个Customter对象的一个组件。

　　NHibernate用'Component'与.NET使用这个词语无关。一个Component只是一个实体对象的一个值，数据库中没有与之映射的表。

<!-- Component mapping: Address-->
<component name="Address">
<property name="StreetAddress" />
<property name="City" />
<property name="State" />
<property name="Zip" />
</component>

　　<component>标签是一个集合标签。NHibernate将使用.NET反射机制来判断它的真实类型，你也可以通过 class 属性来指定所对应的类名。Customer.hbm.xml文件将匹配两个类。

　　联合映射

　　面向对象设计建立在业务模型中的类相互关联的概念上。

• One-to-one:一个对象至于另外一个对象关联。像一夫一妻。
• One-to-many:指容器,像一个Customer对象可以包含很多Order对象。
• Many-to-one:许多对象可以指向另外同一个对象，像许多Order对应着一个单独的Customer对象。
• Many-to-many:许多对象可以指定另一种对象的任何一个。像一个订单有很多产品，一个产品又可以被包含在很多订单里。

　　集合映射：One-To-Many

　　在Customer类里，你会发现有一个Orders属性，表示客户的所有订单信息。需要注意的一点是：Orders 属性并不是List<T>类型，而是IList<T>。

// Property variable
private IList<Order> p_Orders = new List<Order>();

// Orders property
public IList<Order> Orders
{
　　get { return p_Orders; }
　　set { p_Orders = value; }
}

　　Orders属性被声明为IList<order>，却被实例化为List<Order>。

　　这是因为NHibernate需要集合被声明为接口，而不是接口实现。像上面说的，需要被定义成接口，而不是具体的类。这种被认为是很好的编程实践。定义为接口，使NHibernate更加灵活，而且能够提高效率。

　　NHibernate提供了好几种标签来匹配集合。因为当前集合是个IList<T>，现在我们可以使用<bag>来匹配关联。

<!-- One-to-many mapping: Orders -->
<bag name="Orders" cascade="all-delete-orphan" lazy="false">
<key column="CustomerID" />
<one-to-many class="Order" />
</bag>

　　name属性可以指定要匹配的类的属性，cascade属性的设定表示NHibernate将会操作所有的子对象，包括加载、保存以及删除。all-delete-orphan表示NHibernate将联机保存、删除所有对当前类对应的子对象。

像：当我们删除Customer这个对象时，Customer下的属性Orders所有的Order也将会删除。

　　在所有的关联映射中，cascade必须要指定值，否则NHibernate将不会联机保存或删除。另外<class>标签可以指定一个默认的cascade，使用default-cascade。但是这个值只会提供在保存和更新操作上使用联机操作，不会对删除也使用联机操作。所以，最好还是设置cascade这个属性的值。

　　跟上面一样，为了简单，我们依旧不会使用lazy loading。

　　<bag>标签里包含了两个标签：

• <key>标签的column属性为目标类指定映射表里的列，这一列被用作当前类的映射表和目标类的映射表的外键。
• <ont-to-many>标签表示当前类与以name属性指定的类之间是一对多的关系。name属性指定Order类，当前类Customer与Order之间是一对多的关系。

　　这里我们好像忘记了一点东西，我们指定了目标类，但是没有指定目标类的映射表。<key>标签指定了映射表的列的名称，而不是映射表的名称。但是NHibernate是怎么知道使用哪个表的呢？这是因为当我们指定好了目标类的名称之后，NHibernate会通过目标类的XML映射文件来获取其所应的映射表。所以在这里我们不需要指定目标类的映射表。

　　现在，我们已经完成了Customer类的映射，我开始转向Order类。

　　集合映射：Many-To-One

　　打开 Order.hbm.xml 文件，现在看的话，里面的内容对你来说已经非常熟悉了。<class>标签、<property>标签、还有一个<set>标签是为了一个订单和订单中的商品的一对多关系。但是在Order类和Customer类之间，这里存在着一种新的关系。每一个订单信息需要知道它是哪个顾客的。

　　一开始看，这里有点像一对一的关系，一个订单对应一个顾客，但是这样是不对的，很多条订单可以被包含在一个顾客中，尽管一个订单只对应一个顾客，但是在类的角度上，这是多对一关系。

　　<many-to-one>标签适于这中关系。此标签内不允许有别的标签，尽管关系是 many-to-one, 'many'个对象同时关联到一个对象上。它其实跟<property>一样简单。

<!-- Many-to-one mapping: Customer -->
<many-to-one name="Customer"
class="Customer"
column="CustomerID"
cascade="all" />

　　这里的属性名称意思非常直接明了：

• name属性指定要映射的当前类的属性，这个示例中，Customer是Order类的一个属性。
• class属性指定目标类。这个示例中，目标类就是Customer。
• column属性指定当前类的映射表与目标类用作外键的列。这个示例中，CustomerID是Order与Customer的使用的外键。
• cascade属性指定这种关系的级联类型。

　　class属性不是必需的，NHibernate可以通过.NET反射机制来判断这个类的真实类型；如果映射表中此列于这个类的属性名相同，column属性可以省略。

　　集合映射：Many-To-Many

　　在Order.hbm.xml文件中最后一种有趣的关系就是映射OrderItems属性。OrderItems是IList<Product>类型的，包含了一个序列的Product对象。

　　这种关系跟One-To-Many关系差不多，因为一个订单信息包含很多商品信息。但是一种商品信息可以被包含在很多订单信息里，所以这里是Many-To-Many关系。

　　在数据库中，我们使用 OrderItems 表当作 Orders 表和 Products 表的连接表。OrderItems 表中包含Order编号和Product编号。这种方式通常表示多对多的关系。这种方式是单向的多对多关系，是Order类对Product类。双向的多对多关系是非常复杂的，在本文中我们不会涉及。

　　那我们怎样映射多对多关系呢？其实与映射一对多的关系大致相同，我们可以使用<bag>标签，它包含一个<many-to-many>标签。

<!-- Many-to-many mapping: OrderItems -->
<bag name="Orders" table="OrderItems" cascade="none" lazy="false">
<key column ="OrderID" />
<many-to-many class="Product" column="ProductID" />
</bag>

　　解释一下：

• <bag>标签中的name属性用来指明要映射的 Customer 类的属性，这个示例中，就是Orders属性。
• <bag>标签中的table属性用来指明连接表。这里示例中，就是指 OrderItems 表。
• <bag>标签中的cascade属性用来指明这种多对多关系的联机类型。
• <bag>标签中的lazy属性用来指明是否使用lazy loading特性。
• <key>标签用来指明连接表与当前类的映射表实现连接的外键。这里是指OrderID。
• <many-to-many>标签中的class属性用来指明多对多关系中的目标类。这里是指Product类。
• <many-to-many>标签中的column属性用来指定连接表与目标类的映射表链接的外键。这里当然是ProductID.

　　这里我们跟映射one-to-many关系时一样，我们没有必要指定目标类的映射表，因为我们已经指定了目标类，NHibernate会通过目标类的映射文件来找到它的映射表。

　　这里的<bag>标签中的cadcade属性设置为none，这是因为我们在删掉一个订单信息时，不想连订单里的产品信息一并删掉。

　　Order类中现在只剩一一个简单类型，Date，我们不会再花费时间，现在你可以关闭Order类的映射文件。

　　我们将不再检查 Product.hbm.xml 文件，上面的文章已经涵盖了所有 Product 中的关系映射，打开文件去检查每一项的映射对读者来说是一个很好的练习。

　　调试映射文件

　　大多数映射文件的调试都是在运行期间。当一个程序开始配置NHibernate，程序就会尝试去编译所有它能找到的映射文件。如果NHibernate出现问题，将会抛NHibernate.MappingException异常。你可以捕捉这些异常，也可以让它停止执行。另外，这些异常的异常信息可以在 Log4Net 日志文件中找到。最常见的异常信息将会是这样：

Could not compile the mapping document: 
    NHibernateSimpleDemo.Model.Order.hbm.xml ---> 
    NHibernate.PropertyNotFoundException: Could not find a getter for 
    property 'OrderItems' in class 'NHibernateSimpleDemo.Order'

　　调试符合一般调试模式，解决Bug，重新编译，重新执行。如果你的程序能够完成配置NHibernate，你就应该知道你的映射文件是没有问题的。下面我们来讨论如何配置。

　　如何NHibernate抱怨其中的一个类没有映射，尽管你一直为这里类创建了映射文件，那你可以检查映射文件<class>定义，确定class与映射表匹配是正确的。如果这些都很正确，请确认映射文件的编译类型是嵌入式资源。

　　整合NHibernate

　　这里没有正确的方式把NHibernate整合到你的应用程序中，但作者的本意是遵循一般的三层架构，把NHibernate的配置和处理代码放在数据层，示例程序中包含一个 Persistence 文件夹，其中包含一个 PersistenceManager 类。

　　PersistenceManager类包含了持久化业务模型中的每一个实体的一般函数。单单一个类就已经满足了示例程序，但是对于软件产品这并不是一个很好的实践。在现实的软件编程中，你可以把这些方法分成多个持久化类。

　　PersistenceManager类配置NHibernate，而且持有一个SessionFactory对象的引用。一个SessionFactory 可以产生多个 Session 对象。Session是NHiberante中一个工作单元。一个Session代表了一次你的程序和NHibernate的一次交互。

　　你可以把它们当作成交易层次上一级。一个Session通常只有一次交互，但是它可以包含好几个。你一个打开一个Session，进行一次或是多次事务，然后关闭它，最后释放它。

　　Session通过SessionFactory创建。SessionFactory是密集型资源，而且它的初始化成本较高，从另一方面讲，Session使用了有限的资源，而且强加一些初始化成本。所以，一般的做法是在程序初始化时，创建一个全局的SessionFactory。并且在需要使用Session时，才进行创建。

　　示例程序中，PersistenceManager的初始化只是程序初始化的一部分。PersistenceManager配置了一个SessionFactory。程序使用PersistenceManager.SessionFactory来创建Session。

　　配置NHibernate

　　配置NHibernate有两个元素：配置文件和配置代码。

　　配置文件可以放在程序根目录下的一个单独的文件里，也可以放在App.config文件里。

　　在文章的开始，我们建议您下载Log4Net，Log4Net拥有它本身的配置文件，我们也把它放在App.config文件中，NHibernate和Log4Net的配置文件需要放置在App.config文件中的<configSections>标签中。

　　NHibernate的配置文件很简单，这个配置主要是让NHibernate来创建一个SessionFactory。

• Connection provider:提供连接的工厂。NHibernate应该使用IConnectionProvider。示例程序将使用默认提供的Provider。
• Dialect:数据库方言。示例程序将使用SQL Server 2005方言。
• Connection driver:数据库连接驱动。示例程序将使用SQL Server 客户端驱动。
• Connection String:数据库连接字符串。

　　示例程序中的数据库连接字符串只适合作者的开发环境。你应该修改成符合自己的。

　　配置NHibernate、配置Log4Net

　　您应该回忆起我们向示例程序添加了Log4Net的引用。所以配置NHibernate的第一步就是配置Log4Net。Log4Net的配置不是必需的。

　　现在我们在App.config文件中添加配置：

<!-- Note: Logger level can be ALL/DEBUG/INFO/WARN/ERROR/FATAL/OFF -->

<!-- Specify the logging level for NHibernates -->
<logger name="NHibernate">
<level value="DEBUG" />
</logger>

　　接下来为你的类添加下列特性：

[assembly: log4net.Config.XmlConfigurator(Watch=true)]
namespace NHibernateSimpleDemo
{
    public class PersistenceManager : IDisposable
    {
        // ...
    }
...

　　最后一步调用 Configure() 配置Log4Net。

　　最后在 PersistenceManager 类的构造方法中调用下列方法：

private void ConfigureLog4Net()
{
    log4net.Config.XmlConfigurator.Configure();
}

　　配置NHibernate、配置代码

private void ConfigureNHibernate()
{
    // Initialize
    Configuration cfg = new Configuration();
    cfg.Configure();

    // Add class mappings to configuration object
    Assembly thisAssembly = typeof(Customer).Assembly;
    cfg.AddAssembly(thisAssembly);

    // Create session factory from configuration object
    m_SessionFactory = cfg.BuildSessionFactory();
}

　　首先我们创建一个NHibernate的Configuration对象，通过它来实现从映射文件中映射类。AddAssembly()方法需要所有的映射文件嵌入到项目的程序集中，所以所有的映射文件的BuildAction（编译方式）设置为Embedded Resource（嵌入式资源）。

　　接下来我们需要它来创建一个SessionFactory。我们不需要指定配置文件是放在App.config中，还是一个单独的文件中。

　　BuildSessionFactory()返回一个SessionFactory对象，传递给持久化类的成员变量SessionFactory。

　　以后程序就可以调用SessionFactory，不管什么时候想使用一个Session对象，它是一个全局的变量。

　　如果我们使用了很多复杂的类：一个实体类对应一个持久化类，这样的话我们就需要为每一个类传递一个SessionFactory对象的引用。因为示例程序中，我们只有一个持久化类（PersistenceManager），所以我们可以把SessionFactory当作成员变量来调用。

　　使用NHibernate持久化类

　　NHibernate一个非常强大的特性就是实现联级地保存和删除。例如:当我们保存Customer对象时，NHibernate也会自动将Customer对象下的所有的Order中变化的部分也保存进去。这个功能大大简化了我们持久化的代码。

　　PersistenceManager类包含了实现了基本的增删改查操作的方法。

　　Save():保存实体。

　　RetrieveAll():从数据库中遍历给定类型的所有对象。

　　RetrieveEquals():返回对象中的一个属性等于给定值的所有对象。

　　Delete():这个方法有两个重载方法，第一个方法删除一个实体，第二个方法删除一个序列的实体。

　　所有的方法遵循以下几个常规模式：

　　使用 using 来包装一个NHibernate Session对象，这样可以保证Session在方法执行完毕时自动关闭和自动释放，即使方法执行过程中出现异常。

　　Save()和Delete()方法都是用 using 来包装一个 Transaction。同样是为了自动释放和关闭Transaction的资源。

　　这些方法都调用Session对象的一般方法。

　　PersistenceManager类包含一个 Close()方法，而且实现IDisposible接口。这就意味着在程序关闭的时候，必须释放PersistenceManager的所有资源。

　　PersistenceManager类中的CRUD（创建，遍历，更新，删除）方法不代表一个对象持久化的所有实现。CRUD方法只是用来显示基本的NHibernate的持久化是怎样工作的。NHibernate文档里有详细的解释。

　　回报

　　到了现在你也许会有疑问，NHibernate是一个如此复杂的配置过程，那他应该和手动写CRUD函数一样简单。我个人认为NHibernate的学习过程是非常艰难的，而且进展很慢。

　　好了，现在就是他回报的时候，你是不是觉得到现在我们只不过创建了几个映射文件，还有添加那么几行代码而已。一旦你了解了这个系统，它真的不是很坏。你获得的也是相关可观的。

　　想想我们以前通过手写代码获取Customer序列，然后获取每一个Customer的Order对象序列，还有每一个Order的Product对象序列。

　　看看NHibernate是怎么做的：

IList<T> itemList = session.CreateCriteria(typeof(T)).List<T>();

　　下面就是保存的代码：

foreach (Customer Customer in OrderSystem.Customers)
{
    using (ISession session = m_SessionFactory.OpenSession())
    {
        using (session.BeginTransaction())
        {
            session.SaveOrUpdate(item);
            session.Transaction.Commit();
        }
    }
}

　　运行实例程序

　　示例程序是一个控制台的应用程序，所有它没有用户入口。但是Program类承担了这个角色。Main()方法跟Controller类交互。另外Program类注册了OrderSystem.Populate事件，当OrderSystem被重新重载时触发。

　　这种方式是对MVC架构的一种实现。如果想对MVC有一个深入的了解，阅读这里。如果你对MVC还不够熟悉，通过阅读Main()方法对MVC流程有很好的帮助。

　　保存一个业务模型

　　当清理完数据库，程序在内存中创建业务模型。OrderSystem.Populate()方法开始工作，当其执行完毕后，触发Populated事件，这个事件提示程序业务模型已经从数据库中重新加载。Program类注册这个事件，用它来打印所有Customer信息和Order信息。

　　一旦业务模型被创建，程序就会保存。PersistenceManager中的Save<T>()方法展现了使用NHibernate来持久化代码是多么简单。我们甚至不用再考虑数据库。Controller简单的叙述了PersistenceManager怎样来保存对象。

private static void SaveBusinessObjects
    (OrderSystem OrderSystem, PersistenceManager persistenceManager)
{
    // Save Products
    foreach (Product product in OrderSystem.Catalog)
    {
        persistenceManager.Save<Product>(product);
    }

    // Save Customers (also saves Orders)
    foreach (Customer Customer in OrderSystem.Customers)
    {
        persistenceManager.Save<Customer>(Customer);
    }
}

　　SaveBusinessObjects()方法保存了Products和Customers信息，但是没有保存Orders信息。因为我们已经在Customer.Orders属性上把cascading打开，所以Customer.Orders信息在我们保存Customer时将会自动保存。

　　也会关注为OrderItems表创建条目，即使我们没有为这些写代码。这是因为在Order类的映射文件中，我们已经指定OrderItems表作为连接表在于Order.OrderItems关联的多对多关系中。

　　删除业务对象

　　保存了业务模型之后，程序需要将它们从RAM中清理。从RAM中删除业务对象并不代码从数据库中删除。如果我们从RAM删除了业务对象，NHibernate可以从数据库中随时加载出来。

　　使用NHibernate加载对象

　　一旦业务模型在RAM中被删除，程序就会从数据库中重新加载出来。这一步我们将演示怎样加载持久阿虎对象。程序使用Controller。LoadBusinessObjects()方法来加载对象，这个方法跟Program类中的方法一样简单，也使用 using 来包装。它使用NHibernate中很流行的“Query By Criteria”特性。

public IList<T> RetrieveAll<T>()
{
    using (ISession session = m_SessionFactory.OpenSession())
    {
        // Retrieve all objects of the type passed in
        ICriteria targetObjects = m_Session.CreateCriteria(typeof(T));
        IList<T> itemList = targetObjects.List<T>();

        // Set return value
        return itemList;
    }
}

　　对象的类型通过T参数来制定，这个函数创建一个ICriteria对象，调用List<T>()方法，来返回符合标准的一个对象的集合。

　　示例程序加载了两次Order对象，一次是明确的，一次是含蓄的。

　　当加载OrderSystem.Orders集合时，明确加载了一次Orders对象

　　当加载OrderSystem.Customers集合时含蓄的加载了一次Orders对象。由于Customer映射文件   中的<bag>标签中的cascade属性的设置，程序会在加载Customer对象的时候自动加载Orders对   象。

　　话句话说，cascading会作用在加载时，同样也会作用在保存的时候。如果没有Order集合，我们就不用明确的加载它了。但是加载Orders对象会导致一个风险，就是当我们想创建两个不用引用的Orders对象时，创建两个不同的Orders对象“他们代表着同一个Orders”。

　　这里是我们怎么解决这个问题。首先我们设定Session变量为成员变量，而不是本地变量。这样可以保证每一个Session变量加载的是同一种对象。接下来我们为这个方法添加一个新的参数，SessionAction。这个参数用来指定函数使用哪一个session。

　　Begin：这个方法返回一个新的Session对象。

　　Continue：这个方法持续一个已经存在的session对象。

　　End：这个方法持续一个已经存在的session对象，并且在方法完毕时结束它。

　　BeginAndEnd：这个方法开始一个新的session（会话）并在方法结束时结束它。

　　修改后的方法可以加载许多类型不同的对象，因为他们需要在同一个会话中加载，保证了对象的标识加载了不止一次。

public IList<T> RetrieveAll<T>(SessionAction sessionAction)
{
    // Open a new session if specified

    if ((sessionAction == SessionAction.Begin) || (sessionAction ==
    SessionAction.BeginAndEnd))
    {
        m_Session = m_SessionFactory.OpenSession();
    }

    // Retrieve all objects of the type passed in

    ICriteria targetObjects = m_Session.CreateCriteria(typeof(T));
    IList<T> itemList = targetObjects.List<T>();

    // Close the session if specified

    if ((sessionAction == SessionAction.End) || (sessionAction ==
    SessionAction.BeginAndEnd))
    {
        m_Session.Close();
        m_Session.Dispose();
    }

    // Set return value

    return itemList;
}

　　程序只会在最上面的持久化类上调用RetrieveAll<T>()方法，这些类是：Product,Customer,Orders。我们没有必要明确地遍历OrderItems，也没有必要明确的为Customer加载Orders，或者为Orders加载OrderItems。NHibernate会照顾到所有子对象。

　　NHibernate在查询数据库上有好几种特性：

　　1.Query by criteria:通过创建Criteria对象查询数据库。

　　2.Query by example:通过创建一个你想要遍历类型的对象，设置它的属性来指定某个criteria来查询数据库。

　　3.Hibernate Query Language：一种跟SQL差不多的查询语言。

　　4.SQL语句：也可以通过原生SQL来查询数据库，如果上面几个方法不能满足你的需求的话。

　　SQL语句的方式应该是您选择的最后一种方式，如果上面几种方法不适合您的话。NHibernate文档有详细的解释。

　　验证对象标识

　　一旦示例程序重新加载业务模型以后，它标识对象的标识已经被保存。事实上有两个对象加载了两次：

　　Order对象在OrderSystem.Orders中明确加载一次，在OrderSystem.Customers[i].Orders中含蓄的加载一次。

　　另外，Customer对象在OrderSystem.Customers中明确加载一次，在OrderSystem.Orders[i].Customer中含蓄的加载一次。

　　第一个Customer放置了第一个Order。我们可以测试这个:

　　1.Customer集合中的第一个Customer和Order集合中的第一个Order的Customer是同一个对象。

　　2.Order集合中的第一个Order和Customer集合中的第一个Customer对象的Order是同一个对象。

　　我们通过使用object.ReferenceEquals()方法来判断两个对象是不是同一个引用。

// Compare Customer #1 to the Order #1 Customer--should be equal

Customer CustomerA = OrderSystem.Customers[0];
Customer CustomerB = OrderSystem.Orders[0].Customer;
bool sameObject = object.ReferenceEquals(CustomerA, CustomerB);

// Compare Order #1 to the Customer #1 order--should be equal

Order orderA = OrderSystem.Orders[0];
Order orderB = OrderSystem.Customers[0].Orders[0];
sameObject = object.ReferenceEquals(CustomerA, CustomerB);

　　从数据库中删除对象

　　上面我们已经提到从对象模型中删除一个对象，并不会从数据库删除。示例程序将通过从对象模型中删除一个对象，再从数据库从新加载来解释这一点。

　　从数据库中删除对象，我们需要明确的告诉NHibernate。

public void Delete<T>(IList<T> itemsToDelete)
{
    using (ISession session = m_SessionFactory.OpenSession())
    {
        foreach (T item in itemsToDelete)
        {
            using (session.BeginTransaction())
            {
                session.Delete(item);
                session.Transaction.Commit();
            }
        }
    }
}

　　示例程序展示了从数据库删除第一个Customer对象。然后将会清理对象模型，在清理之前，会重新从数据库中加载对象模型。NHibernate在删除Customer记录的同时，同时也删除了Customer的Orders，还有每一个Order下的OrderItems。

　　把焦点返回到它属于哪里

　　现在我们已经完成了NHibernate基本的CRUD操作。NHibernate将会大大简化你程序中的持久化代码层，我希望你可以带着这个观点离开。一旦你为你的类创建了映射文件，就可以忘记你的持久层，而且你也不用花费几天时间或是几周来编写一个累赘的持久层，才知道NHibernate这么多好处。

　　这里还有另外一个好处，也许是最重要的一个。在VS 2005的项目浏览器中看看这个示例程序，你会发现不部分的工作已经在Model层实现了，Controller管理业务模型和持久管理器中的工作和代理任务。这样的结果就是你可以自由地把你的注意致力于业务模型上。减轻了你写持久化代码的苦差事，NHibernate能够让你的焦点放在你的业务模型上，这是它属于的地方。

　　英文原版：http://www.codeproject.com/KB/database/Nhibernate_Made_Simple.aspx

　　总结

　　有些术语翻译的不对的地方，请大家多多指正，一起学习NHibernate。

　　上面介绍的加载映射文件，以及配置PersistenceManager、SessionFactory如果搭配Spring.NET，上面的所有配置代码，完全可以通过Spring的依赖注入实现，让代码看起来更加简单。

　　上面还有提到所有要映射的类的属性需要声明为Virtual，当然现在也可以不用声明为virtual。

　　上面提到的一个对象实际上加载两次，在现实的项目中，我们一般是不会把lazy设置为true的，因为当一个对象的子对象非常多的时候，NHibernate遍历其子对象是一个非常耗资源的过程。

　　Spring.NET搭配NHibernate对于.NET绝对是一个非常合适的选择。

　　Xuem  www.cnblogs.com/daydayfree