NHibernate Step by Step (一) Hello,NHibernate!

NHibernate Step by Step (一)  Hello,NHibernate!
 好了，今天我们正式开始NHibernate的历程，在第一次的练习中，我将尽量详细地讲解环境的配置，以后将不再详细解释。

基本的软件环境如下：
1．NHibernate www.nhibernate.org 当前版本是1.0.2
2．Code Smith http://www.codesmithtools.com/
3．NHibernate模板 点击这里下载
当然，少不了VS2005跟SQLServer了，我这里用的是SQLServer2005，教程用在SQLServer2000上应该没有问题，默认情况下，我将建立并使用一个叫NHibernate的数据库。

首先，我们先建立一个最简单的Person表，如下完整脚本（你可以进行修改以适合自己的数据库）：

USE [NHibernate]
GO
SET ANSI_NULLS ON
GO
SET QUOTED_IDENTIFIER ON
GO
SET ANSI_PADDING ON
GO
CREATE TABLE [dbo].[Person](
    [id] [ int ] IDENTITY( 1 , 1 ) NOT NULL,
    [name] [varchar]( 50 ) COLLATE Chinese_PRC_CI_AS NOT NULL,
 CONSTRAINT [PK_Person] PRIMARY KEY CLUSTERED 
(
    [id] ASC
)WITH (IGNORE_DUP_KEY  =  OFF) ON [PRIMARY]
) ON [PRIMARY]

GO
SET ANSI_PADDING OFF

仅有两个字段，一个自动增长的id，一个name，如下：

 
然后将下载的nhibernate-template解压，打开Code Smith，将模板加入”Template Explorer”，如下：

 
然后在其中的NHibernate.cst上点右键，选择“Execute”,弹出设置窗口，在左边的属性窗口进行如下设置：

 
注意：SourceDatabase属性在第一次选择时需要配置一个连接字符串，配置好后Code Smith将记录下来。 Assembly属性代表的是生成文件的默认Assembly名，而NameSpace，顾名思义，就是使用的命名空间了，这里我们全部使用”Test.Model”，请记住这个名字，点击左下角的Generate，将会在指定的输出目录下产生两个文件：Person.cs,Person.hbm.xml。

好了，NHibernate需要的类文件和映射文件生成完了，我们可以开始干活了！（生成NHibernate文件均是如此步骤，以后不再赘述）

新建立一个类库工程，为了简洁起见，我们命名为Model，需要注意的是，为了跟刚才生成的文件对应，我们需要在Model工程的属性页中将起Assembly名字设为上面的“Test.Model”,如下：

 
然后将刚才生成的两个文件Person.cs和Person.hbm.xml加入到Model工程中来，选中Person.hbm.xml文件，在属性窗口中将其“Build Action”设置为“Embedded Resource”(这是非常重要的一步，否则NHibernate将无法找到映射文件)，如下：
 

build，ok，通过。

然后建立一个控制台工程，命名为Console1，添加NHibernate和上面Model项目的引用，另外添加一个应用程序配置文件，如下：

<? xml version="1.0" encoding="utf-8"  ?>
< configuration >
   < configSections >
     < section  name ="nhibernate"  type ="System.Configuration.NameValueSectionHandler, System,
                    Version=1.0.5000.0,Culture=neutral, PublicKeyToken=b77a5c561934e089"   />
   </ configSections >

   < nhibernate >
     < add  key ="hibernate.connection.provider"  value ="NHibernate.Connection.DriverConnectionProvider"   />
     < add  key ="hibernate.connection.driver_class"  value ="NHibernate.Driver.SqlClientDriver"   />
     < add  key ="hibernate.connection.connection_string"  value ="Server=localhost;Initial Catalog=NHibernate;Integrated Security=SSPI"   />
     < add  key ="hibernate.connection.isolation"  value ="ReadCommitted" />
     < add  key ="hibernate.dialect"  value ="NHibernate.Dialect.MsSql2000Dialect"   />
   </ nhibernate >

</ configuration >

然后编写如下代码：

using  System;
using  System.Collections.Generic;
using  System.Text;
using  NHibernate;
using  NHibernate.Cfg;
using  Test.Model;

namespace  Console1
{
    class Program
    {
        static void Main(string[] args)
        {
            Configuration config = new Configuration().AddAssembly("Test.Model");
            ISessionFactory factory = config.BuildSessionFactory();
            ISession session = factory.OpenSession();

            Person person = new Person();
            person.Name = "Jackie Chan";

            ITransaction trans = session.BeginTransaction();
            try
            {
                session.Save(person);
                trans.Commit();
                Console.WriteLine("Insert Success!");
            }
            catch (Exception ex)
            {
                trans.Rollback();
                Console.WriteLine(ex.Message);
            }
        }
    }
}

运行，ok，执行成功！！
我们到数据库检查一下，如下：

 
我们想要添加的记录已经成功加入到数据库中！！
是不是感觉有些神奇啊？好，我们开始详细解释。
先来看生成的两个文件，第一个是Person.cs，如下：

using  System;
using  System.Collections;

namespace  Test.Model
{
    Person#region Person

    /**//// <summary>
    /// Person object for NHibernate mapped table 'Person'.
    /// </summary>
    public class Person
    {
        Member Variables#region Member Variables
        
        protected int _id;
        protected string _name;

        #endregion

        Constructors#region Constructors

        public Person() { }

        public Person( string name )
        {
            this._name = name;
        }

        #endregion

        Public Properties#region Public Properties

        public int Id
        {
            get {return _id;}
            set {_id = value;}
        }

        public string Name
        {
            get { return _name; }
            set
            {
                if ( value != null && value.Length > 50)
                    throw new ArgumentOutOfRangeException("Invalid value for Name", value, value.ToString());
                _name = value;
            }
        }

        

        #endregion
    }
    #endregion
}

你可以发现，这完全是一个普通的poco类（Plain Old CLR Object）,仅仅是对数据库person表的一个完全映射，不依赖于任何框架，可以用来作为持久化类，你可以在任何地方使用而不用担心依赖于某些神秘的运行时东西。

另外，NHibernate需要知道怎样去加载（load）和存储（store）持久化类的对象。这正是NHibernate映射文件发挥作用的地方。映射文件告诉NHibernate它应该访问数据库(database)里面的哪个表（table）及应该使用表里面的哪些字段（column）,这就是我们今天要讲的重点了，Person.hbm.xml，如下：

<? xml version="1.0" encoding="utf-8"  ?>
< hibernate-mapping  xmlns ="urn:nhibernate-mapping-2.0" >
  < class  name ="Test.Model.Person, Test.Model"  table ="Person" >
   < id  name ="Id"  type ="Int32"  unsaved-value ="0" >
    < column  name ="id"  sql-type ="int"  not-null ="true"  unique ="true"  index ="PK_Person" />
    < generator  class ="native"   />
   </ id >
   < property  name ="Name"  type ="String" >
    < column  name ="name"  length ="50"  sql-type ="varchar"  not-null ="true" />
   </ property >
  </ class >
</ hibernate-mapping >

不用说，最顶层的hibernate-mapping节点是NHibernate用来进行映射的根了，其中，包含一个class节点，里面的name属性对应我们的Person类，注意，需要完整的限定名；而table属性，则显而易见是对应数据库中的Person表了。
我们再往里面看，分别有两个节点，一个是id，对应数据库中的id，一个是属性name，对应表中的column name和Person类中的name属性，整个映射文件简捷明了，一看即知。实际上这是由代码产生工具产生的映射文件，里面很多东西我们其实可以省略，如下写法：
<property name=”Name” column=”name” />
NHibernate将自动去匹配数据库中的列而不需要我们来设置。

下面，我们来看一下应用程序配置文件中都记录了那些东西，如下：
hibernate.connection.provider_class  
定制IConnectionProvider的类型.
例如：full.classname.of.ConnectionProvider （如果提供者创建在NHibernate中）, 或者 full.classname.of.ConnectionProvider, assembly （如果使用一个自定义的IConnectionProvider接口的实现，它不属于NHibernate）。
 
hibernate.connection.driver_class  
定制IDriver的类型.
full.classname.of.Driver （如果驱动类创建在NHibernate中）, 或者 full.classname.of.Driver, assembly （如果使用一个自定义IDriver接口的实现，它不属于NHibernate）。

hibernate.connection.connection_string  
用来获得连接的连接字符串.

hibernate.connection.isolation  
设置事务隔离级别. 请检查 System.Data.IsolationLevel 来得到取值的具体意义并且查看数据库文档以确保级别是被支持的。
例如： Chaos, ReadCommitted, ReadUncommitted, RepeatableRead, Serializable, Unspecified

hibernate.dialect 
NHibernate方言（Dialect）的类名 - 可以让NHibernate使用某些特定的数据库平台的特性
例如： full.classname.of.Dialect（如果方言创建在NHibernate中）, 或者full.classname.of.Dialect, assembly （如果使用一个自定义的方言的实现，它不属于NHibernate）。

接着，我们开始解释代码的执行，如下：

 

 

Configuration config  =   new  Configuration().AddAssembly( " Test.Model " );

// 通过配置对象来产生一个SessionFactory对象，这是一个Session工厂，
// 那么Session是用来干什么的呢？一个Session就是由NHibernate封装
// 的工作单元，我们可以近似地认为它起到ADO.Net中Connection的作用。
ISessionFactory factory  =  config.BuildSessionFactory();
ISession session  =  factory.OpenSession();

Person person  =   new  Person();
person.Name  =   " Jackie Chan " ;

// 这里，开启一个由NHibernate封装的事务，当然，在这里最终代表
// 的还是一个真实的数据库事务，但是我们已经不需要再区分到底是
// 一个SqlTransaction还是一个ODBCTransaction了
ITransaction trans  =  session.BeginTransaction();
try
{
    //保存，提交，就这么简单！！
         session.Save(person);
        trans.Commit();
        Console.WriteLine("Insert Success!");
}
catch  (Exception ex)
{
        trans.Rollback();
        Console.WriteLine(ex.Message);
}

现在有了一个基本的概念了吧？？
好了，第一篇就讲这么多，我们下次再接着练习。

Step by Step，顾名思义，是一步一步来的意思，整个教程我将贯彻这一理念，待此系列结束后，我们再就某些高级话题进行深入。