Nhibernate随手记（1）

 　　学习Nhibernate的萌芽

　　　　今早有群里有人问Nhibernate的问题，没学过，刚好来了兴趣，无意很快在园子里下载到了一本Nhibernate3.0的电子书，内容非常不错，很快地看了扫了一下，再记个笔记，不过针对当前的最新版本文章的内容参考时候因稍作调整。一直觉得EF用起来蛮好用的，很多人喜欢EF,接触了好多初学EF Code First的同学，虽然有现成的工具在建好数据库后自动生成Code First 模式的代码文件，但自己建模都比较含糊，往往不清楚怎么去建立合适的Model，所以学习一下Nhibernate也是有好处的，我也可以了解下这个大名鼎鼎的hibernate移植版，因为这些都很直观，而且对于延迟加载也会有深入的理解。今天就开始我的Nhibernate入体验了此文适合想入门了解Nhibernate的童鞋看。电纸书（英文版）下载地址:点击这里。

　　建立我的第一个Nhibernate学习项目

 本项目包含元素套件

　　1.Nhibernate_One_Lib 类库文件一枚

　　2.Nhibernate_One_App 控制台营养程序一枚

　　3.一个名为Schema解决方案文件夹，包含（nhibernate-configuration.xsd，nhibernate-mapping.xsd）

　　4.官网下载的最新版本的Nhibernate3.3，本例不打算FluentNHibernate的无配置文件强类型的方式使用NHibernate，单纯体验配置的乐趣

　　5.耐心一颗

　　备注：套件3你可以完全不需要，如果你认为你习惯使用了Ctrl+C ,Ctrl+V不需要智能提示的话，完全可以不需要。

   1.首先我们看一下Nhibernate_One_Lib中所包含类之间的关系及内部元素的概况

     

 2.各个实体类文件的数据如下，同时我把我使用体会的一些细节说一下，希望理解错的地方大家可以指正一下：

　　在Nhibernate中，每个实体类对应一个xml文件，其名称约定为：类名+.hbm.xml(hbm其实是Hibernate Mapping的缩写)，在加载实体集的时候，NHibernate框架就会根据相应的类型搜索对应的xml进行关联，例如 名为Person的类，应该有一个对应的Person.hbm.xml文件进行元数据的描述。当然使用FluentNHibernate无需该配置文件。

Entity<T>

namespace Nhibernate_One_Lib
{
    public abstract class Entity<T>
    {
        public virtual T Id { get; protected set;} 
    }
}

此处的protected修饰符其实没有对于Nhibernate没有任何意义，因为Nhibernate会忽略他的存在，只是为了保护数据不被人为修改

 Produnct类及其对应xml文件

using System;

namespace Nhibernate_One_Lib
{
    public class Product : Entity<Guid>
    {
        public virtual string Name { get; set; }

        public virtual string Description { get; set; }

        public virtual decimal UnitPrice { get; set; }
    }
}

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"  assembly="Nhibernate_One_Lib" namespace="Nhibernate_One_Lib">
 <class name="Product"  dynamic-update="true" optimistic-lock="dirty">
   <id name="Id">
     <generator class="guid.comb" />
   </id>
   <discriminator column="ProductType" />
   <natural-id mutable="true">
     <property name="Name" not-null="true" />
   </natural-id>
   <property name="Description" />
   <property name="UnitPrice" not-null="true" type="Currency" />
 </class>
</hibernate-mapping>

PS: 1.id ，natural-id，分别为托管标识和自然标识， Nhibernate极力推荐托管标志并为其存储格式制订一个枚举类型，这是在处理数据迁移是会很方便。

　　2.dynamic-update="true" optimistic-lock="dirty" 

   这是用于多用户并发控制的设置项，关于乐观并发和悲观可以看一下园子里的文章介绍。下面是Dynamic update的优点描述。

　　When optimistic-lock is set to dirty, dynamic-update must be true. Dynamic update simply means that the update statement only updates dirty properties, or properties with changed values, instead of explicitly setting all properties.

Book类及其对应xml文件

namespace Nhibernate_One_Lib
{
    public class Book : Product
    {
        public virtual string ISBN { get; set; }

        public virtual string Author { get; set; }
    }
}

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="Nhibernate_One_Lib" namespace="Nhibernate_One_Lib">
  <subclass name="Book" extends="Product"  dynamic-update="true">
    <property name="ISBN"></property>
    <property name="Author"></property>
  </subclass>
</hibernate-mapping>

　　首先我们知道Book类继承自Product类，那么我们看到配置文件中的标签 subclass ，extends就不难理解了

下面是Moive和AcotorRole的一对多的关系映射，需要看仔细一些

using System.Collections.Generic;

namespace Nhibernate_One_Lib
{
    public class Movie : Product
    {
        public virtual string Director { get; set; }

        public virtual IList<ActorRole> Actors { get; set; }
    }
}

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"  assembly="Nhibernate_One_Lib" namespace="Nhibernate_One_Lib">
  <subclass name="Movie" extends="Product" dynamic-update="true">
    <property name="Director"></property>
    <list name="Actors" cascade="all-delete-orphan">
      <key column="MoiveId"></key>
      <index column="ActorId"></index>
      <one-to-many class="ActorRole" />
    </list>
  </subclass>
</hibernate-mapping>

--------------------------------------------------------------------------------------------------------------------

using System;

namespace Nhibernate_One_Lib
{
    public class ActorRole : Entity<Guid>
    {
        public virtual string Actor { get; set; }

        public virtual string Role { get; set; }

        public virtual Movie Movie { get; set; }
    }
}

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="Nhibernate_One_Lib" namespace="Nhibernate_One_Lib">
  <class name="ActorRole">
    <id name="Id">
      <generator class="guid.comb" />
    </id>
    <property name="Actor" not-null="true" />
    <property name="Role" not-null="true" />
  </class>
</hibernate-mapping>

从上面的配置我们可以看出在ActorRole 类中Movie是一个导航属性

 <list name="Actors" cascade="all-delete-orphan">
      <key column="MoiveId"></key>
      <index column="ActorId"></index>
      <one-to-many class="ActorRole" />
 </list>

这段配置文件我们会发Actors并不是Moive表中的数据项，也是一个导航属性，cascade="all-delete-orphan"指定了可以进行级联删除操作。ActorId，MoiveId则是ActorRole表中的数据项，key 指定了两个表之间使用MovieId进行关联，one-to-many class="ActorRole"是一对多关系的体现。

Nhibernate_One_App 应用部分

  在引入Nhibernate.dll文件后，我们开始编辑配置文件

<?xml version="1.0" encoding="utf-8" ?>
<configuration>

  <configSections>
    <section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler,NHibernate" />
  </configSections>
  <connectionStrings>
    <add name="db" connectionString="Server=.;Database=NHCookbook; Trusted_Connection=SSPI" />
  </connectionStrings>
  <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
    <session-factory>
      <property name="proxyfactory.factory_class">
        NHibernate.Bytecode.DefaultProxyFactoryFactory, NHibernate
      </property>
      <property name="dialect">
        NHibernate.Dialect.MsSql2008Dialect,NHibernate
      </property>
      <property name="connection.connection_string_name">
        db
      </property>
      <property name="show_sql">true</property>
      <property name="adonet.batch_size">
        100
      </property>
      <mapping assembly="Nhibernate_One_Lib" />
    </session-factory>
  </hibernate-configuration>
</configuration>

这段配置文件非常简单，我在使用的时候需要注意两点：

1.我们不再需要第三方的代理类库支援，如 NHibernate.ByteCode.Castle.dll等，Nhibernate3.3已经自己实现了该功能。

<property name="proxyfactory.factory_class">
    NHibernate.Bytecode.DefaultProxyFactoryFactory,NHibernate
 </property>

2.我们可以使用下面的属性运行时查看Nhibernate自动生成的SQL语句。

  <property name="show_sql">true</property>

代码运行测试部分

using System;
using System.Collections.Generic;

namespace Nhibernate_One_App
{
    internal class Excuter
    {
        private Configuration nhConfig;

        private ISessionFactory sessionFactory;

        public IStatelessSession session { get; private set; }

        public Excuter()
        {
            nhConfig = new Configuration().Configure();
            sessionFactory = nhConfig.BuildSessionFactory();
            session = sessionFactory.OpenStatelessSession();
        }

        private static void Main(string[] args)
        {
            var e = new Excuter();
            InsertMovie(e.session);
            PrintMovies(e.session);
            UpdateMoviePrice(e.session);
            PrintMovies(e.session);
            Console.WriteLine("执行完成");
            Console.ReadKey();
        }

        private static void InsertMovie(IStatelessSession session)
        {
            using (var tx = session.BeginTransaction())
            {
                for (int i = 0; i < 2; i++)
                    session.Insert(new Movie()
                    {
                        Name = "Movie " + i.ToString(),
                        Description = "A great movie!",
                        UnitPrice = 14.95M,
                        Director = "Johnny Smith"
                    });
                tx.Commit();
            }
        }

        public static void PrintMovies(IStatelessSession session)
        {
            {
                using (var tx = session.BeginTransaction())
                {
                    var movies = GetMovies(session);
                    foreach (var movie in movies)
                    {
                        Console.WriteLine(string.Format("Movie.Name={0},Movie.UnitPrice={1}", movie.Name, movie.UnitPrice));
                    }
                    tx.Commit();
                }
            }
        }

        private static void UpdateMoviePrice(IStatelessSession session)
        {
            var movies = GetMovies(session);
            foreach (var movie in movies)
            {
                movie.UnitPrice = (decimal)new Random().Next(10, 26) - 0.05M;
                session.Update(movie);
            }
        }

        private static IEnumerable<Movie> GetMovies(IStatelessSession session)
        {
            return session.CreateQuery("from Movie").List<Movie>();
        }
    }
}

运行效果：

本文用到的数据表脚本（运行后应该生成如下效果）：

 

USE [NHCookbook]
 GO
 /****** Object:  Table [dbo].[Product]    Script Date: 07/13/2013 11:31:15 ******/
 SET ANSI_NULLS ON
 GO
 SET QUOTED_IDENTIFIER ON
 GO
 CREATE TABLE [dbo].[Product](
     [Id] [uniqueidentifier] NOT NULL,
     [Name] [nvarchar](50) NOT NULL,
     [ProductType] [nvarchar](50) NOT NULL,
     [Description] [nvarchar](50) NULL,
     [UnitPrice] [decimal](18, 0) NOT NULL,
     [Director] [nvarchar](50) NULL,
     [Author] [nvarchar](50) NULL,
     [ISBN] [nvarchar](50) NULL
 ) ON [PRIMARY]
 GO
 /****** Object:  Table [dbo].[ActorRole]    Script Date: 07/13/2013 03:31:15 ******/
 SET ANSI_NULLS ON
 GO
 SET QUOTED_IDENTIFIER ON
 GO
 CREATE TABLE [dbo].[ActorRole](
     [Id] [uniqueidentifier] NOT NULL,
     [Actor] [nvarchar](50) NOT NULL,
     [Role] [nvarchar](50) NOT NULL,
     [MovieId] [uniqueidentifier] NULL,
     [ActorId] [int] NULL
 ) ON [PRIMARY]
 GO

SQL脚本

   

一件简单的测试算是完成了， 会用简单的CRUD功能，Nhibernate也是非常简单方便的，但是深入我估计还是要花N久时间，以后还要多做练习。