首页 > 代码库 > NHibernate入门实例

NHibernate入门实例

转:http://www.cnblogs.com/huhai121/p/3955755.html

NHibernate应用一:环境准备

  本章将介绍整个开发环境所需开发和数据库工具,以及数据库设计,后续章节将以当前数据库设计为示例而展开。

  一、环境配置:

  A、操作系统

    Win7旗舰版

  B、开发环境

    VS2010

    NHibernate4.0.0

  C、数据环境

    PowerDesigner 15.1

    Sql Server 2008

  

     二、数据库设计:

  A、表结构设计:

  

  B、建表语句

    1)、客户表

      create table CustomerInfo (
         CustomerID           varchar(36)          not null,
         CustomerName         varchar(200)         not null,
         LinkPhone            varchar(20)          not null,
         LinkAddress          varchar(500)         not null,
         constraint PK_CUSTOMERINFO primary key (CustomerID)
      )      
      go

    2)、产品表

      create table ProductInfo (
         ProductID            varchar(36)          not null,
         ProductName          varchar(100)         not null,
         ProductPrice         decimal(18,2)        not null,
         constraint PK_PRODUCTINFO primary key (ProductID)
      )
      go

    3)、订单表

      create table OrderForm (
         OrderFormID          varchar(36)          not null,
         CustomerID           varchar(36)          null,
         OrderFormTime        datetime             not null,
         constraint PK_ORDERFORM primary key (OrderFormID)
      )
      go

    4)、订单明细表

      create table OrderProduct (
         OrderProductID       varchar(36)          not null,
         ProductID            varchar(36)          null,
         OrderFormID          varchar(36)          null,
         constraint PK_ORDERPRODUCT primary key (OrderProductID)
      )
      go

  三、软件配置

  要为 Microsoft Visual Studio 2010添加编写NHibernate配置文件智能提示的功能。只要在下载的NHibernate 里找到configuration.xsd 和nhibernate-mapping.xsd 两

  个文件并复制到X:\Program Files\Microsoft Visual Studio 9.0\Xml\Schemas 目录即可。

 

NHibernate应用二:第一个NHibernate程序

  当前期工作都准备完成后,将开始NHibernate的学习过程,而在第一个NHibernate程序中,将实现通过NHibernate根据客户编号对客户表进行单条记录的查询示例。该示例中,我们将按以下几部分说明。

  一、结构分析

    1.分层

      习惯了分层的体系结构,所以将第一个NHibernate程序按以下方式进行分层

     

    

      说明:

      A.Model层:模型层,是最底层,类似于传统三层中的实体层,用于持久化类和O/R Mapping操作。

      B.DAL层:DataAccessLayer层,高于Model层而低于App层,是数据访问层,定义对象的CRUD 操作。

      C.App层:应用层,最高层,用于跟用户的交互。

 

    2.引用

    Model层:引用Iesi.Collections.dll 程序集

    DAL层:引用NHibernate.dll 和Iesi.Collections.dll 程序集,引用Model层。

    App层:引用NHibernate.dll 和Iesi.Collections.dll 程序集,引用Model层和DAL层。

  

  二、Model层

    按简单传统.NET 对象(POCOs,Plain Old CLR Objects(Plain Ordinary CLR Objects))模型编程时需要持久化类,也可以说是DTO(Data Transfer Object,数据传

    送对象)模式(这是迄今为止可以工作的最简单方式)。在NHibernate 中,POCO 通过.NET 的属性机制存取数据,就可以把它映射成为数据库表。

    1.客户表的持久化类

       为Customer对象新建一个类文件,命名为CustomerEntity.cs

 

 
public class CustomerEntity    {        public virtual string CustomerID { get; set; }        public virtual string CustomerName { get; set; }        public virtual string LinkPhone { get; set; }        public virtual string LinkAddress { get; set; }    }
 

        说明:

      A. NHibernate 使用属性的getter 和setter 来实现持久化

      B. 属性可设置为public、internal、protected、protected internal 或private

      注意:

      NHibernate默认使用代理功能,要求持久化类不是 sealed 的,而且其公共方法、属性和事件声明为virtual。在这里,类中的字段要设置为virtual,否则出现异常,

      异常内容如下:

       “failed: NHibernate.InvalidProxyTypeException : The following types may not be used as proxies: DomainModel.Entities.Customer: method get_CustomerId

       should be virtual,method set_CustomerId should be virtual”。

     2. 客户表的映射文件

      为Customer对象新建一XML 文件,命名为Customer.hbm.xml

    

 
<?xml version="1.0" encoding="utf-8" ?><hibernate-mapping xmlns="urn:nhibernate-mapping-2.2">  <class name ="NHibernateExample01.Model.Entity.CustomerEntity,NHibernateExample01.Model" table="CustomerInfo">    <id name="CustomerID" column="CustomerID" type="string" length="36">      <generator class ="native"></generator>    </id>    <property name="CustomerName" column ="CustomerName" type="string" length="200" />    <property name ="LinkPhone" column="LinkPhone" type="string" length="20"/>    <property name ="LinkAddress" column="LinkAddress" type="string" length="500" />  </class></hibernate-mapping>
 

      说明:

      A. XML文件的默认生成操作为“内容”,这里需要修改为“嵌入的资源”生成,否则出现异常,异常内容如下:

       Unable to locate persister for the entity named ‘NHibernateExample01.Model.Entity.CustomerEntity‘.

          The persister define the persistence strategy for an entity.

          Possible causes:

          The mapping for ‘NHibernateExample01.Model.Entity.CustomerEntity‘ was not added to the NHibernate configuration

     B. 配置节< hibernate-mapping>中,urn:nhibernate-mapping-2.2是Xml的命名空间,跟NHibernate的DLL版本无关

     C. 配置节<hibernate-mapping>中,如果没有限定assembly 和namespace,那么在配置节<Class>中,需要完整限定名。否则出现异常,异常内容如下:

         Could not compile the mapping document: NHibernateExample01.Model.Entity.Customer.hbm.xml

     D. 配置节<generator>中,Native主键生成方式会根据不同的底层数据库自动选择Identity、Sequence、Hilo主键生成方式根据不同的底层数据库采用不同的主键

            生成方式。由于Hibernate会根据底层数据库采用不同的映射方式,因此便于程序移植,项目中如果用到多个数据库时,可以使用这种方式。

 

  三、DAL层

     1. 会话管理类

     整个NHibernate的数据流程如下:

     A.通过Configuration(NHibernate.Cfg.Configuration)构建ISessionFactory的属性和映射文件。

     B. 通过ISessionFactory生成Session。ISessionFactory 是线程安全的,很多线程可以同时访问它。

     C. Session进行一个单线程的单元操作(数据操作)。Session 不是线程安全的,它代表与数据库之间的一次操作,在所有的工作完成后,需要关闭。

     由此可见,ISessionFactory是整个数据访问的核心,由于它是线程安全性的,所以它可以做全局性对象,将使用单例模式来构建对它的管理。

 
public class SessionManager    {        private ISessionFactory _sessionFactory;        public SessionManager()        {            _sessionFactory = GetSessionFactory();        }        private ISessionFactory GetSessionFactory()        {            return (new Configuration()).Configure().BuildSessionFactory();        }        public ISession GetSession()        {            return _sessionFactory.OpenSession();        }    }
 

   2. 数据访问类

    NHibernate数据访问是交由Session完成的,所以,数据访问的重点就在ISession上。

    在DAL层上新建一个CustomerDal.cs类,用来进行数据访问,编写一方法GetCustomerId 用于读取客户信息。

  

 
public class CustomerDal    {        private ISession _session;        public ISession Session        {            set            {                _session = value;            }        }        public CustomerDal(ISession session)        {            _session = session;        }        public CustomerEntity GetCustomerByID(string customerID)        {            return _session.Get<CustomerEntity>(customerID);        }    }
 

 

  4. App层

    1. NHibernate配置文件

 

 
<?xml version="1.0" encoding="utf-8" ?><hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" >  <session-factory>    <property name="connection.driver_class">      NHibernate.Driver.SqlClientDriver    </property>    <property name="connection.connection_string">      server=.;database=NHibernateSample;uid=sa;pwd=123456;    </property>    <property name="adonet.batch_size">10</property>    <property name="show_sql">true</property>    <property name="dialect">      NHibernate.Dialect.MsSql2008Dialect    </property>    <property name="command_timeout">10</property>    <property name="query.substitutions">      true 1, false 0, yes ‘Y‘, no ‘N‘    </property>    <mapping assembly="NHibernateExample01.Model"/>  </session-factory></hibernate-configuration>
 

    说明:

    A.XML文件的默认“复制到输出目录”为“不复制”,这里需要修改为“始终复制”,否则出现异常,异常内容如下:

       failed: NHibernate.Cfg.HibernateConfigException : An exception occurredduring configuration of persistence layer. ---->

      System.IO.FileNotFoundException : 未能找到文件“NHibernateSample\DAL.Test\bin\Debug\hibernate.cfg.xml””

    B.配置文件会随着NHibernate的DLL版本不同而不同,需要详细查看NHibernate的DLL的Change日志。

    C.属性connection.provider设置了数据库连接提供者(一般不需要更改,除非你决定自己实现提供者)。

    D. 属性connection.driver_class设置了数据库的的驱动类(这里设置了SqlServer的驱动类)。

    E. 属性connection.connection_string是数据库的连接字符串。

    F. 属性show_sql设置是否在运行时是否在控制台显示正在执行的SQL语句(这个属性在调试程序时很有用)。

    G. 属性dialect是NHibernate方言, 可以让NHibernate使用某些特定的数据库平台的特性。

    H. 属性query.substitutions,把NHibernate查询中的一些短语替换为SQL短语(比如说短语可能是函数或者字符)。

    I.  属性mapping节点设置了将使用到的映射文件。

 

      2. 窗体文件内容

    

 
public partial class Form1 : Form    {        public Form1()        {            InitializeComponent();            Init();        }        private void Init()        {            string CustomerID = "48CBCDFC-1AAA-4A08-9C9B-4578C6F59E8C";            SessionManager _helper = new SessionManager();            ISession _session = _helper.GetSession();            CustomerDal _sample = new CustomerDal(_session);            CustomerEntity entity = _sample.GetCustomerByID(CustomerID);            if (entity != null)            {                txtName.Text = entity.CustomerName;                txtAddress.Text = entity.LinkAddress;                txtPhone.Text = entity.LinkPhone;            }        }    }
 

    说明:

      A.数据库中CustomerInfo表中有一条数据:

 

CustomerID

CustomerName

LinkPhone

LinkAddress

48CBCDFC-1AAA-4A08-9C9B-4578C6F59E8C

huhai

18618181513

内蒙古呼和浩特市赛罕区东影西路

 

 

    B. 显示结果如下:

      

 

NHibernate入门实例