目录写在前面一年前刚来这家公司,发现项目中使用的ORM是Nhibernate,这个之前确实没接触过,EF多少在项目中用过,想着既然都是ORM,应该语法上都差不多。当时也就是硬着头皮上的,刚开始也只能通过模仿别人的代码,再加上自己的理解,一些增删改查的方法,确实也被自己给搞出来了,现在回头想想,在项目中,用到的那些方法基本上就一个样,很少有变化。除非有些业务逻辑非常强的,自己搞不定,问一下同事,还是可以解决的。到现在使用Nhibernate也很长时间,中间多少也查过一些资料,从网上下的nhibernate文档.docx,但是每次想去找的时候,总的在电脑上去找,比较麻烦,就干脆记录在博客中了,当时就是有哪些不明白的,可以很方便的从里面查,比如参数是什么含义。也总结了一些,在使用过程遇到的问题。 现在项目告一段落,坐等为客户去部署了,也就有那么点空闲时间,那就要系统的学习一下了。 发现在写这篇文章的时候,说了自己的一些学习方式,发现越写越多,就单独成篇了,也就有了这篇文章——如何高效的利用博客园? 上篇文章,也算是nhibernate学习的开篇吧。 nhibernate文档[NHibernate]持久化类(Persistent Classes) [NHibernate]集合类(Collections)映射 [NHibernate]缓存(NHibernate.Caches) [NHibernate]NHibernate.Tool.hbm2net [NHibernate]Nhibernate如何映射sqlserver中image字段
搭建项目项目结构和映射文件
项目结构说明 采用传统三层架构 Wolfy.Shop.Domain:数据实体和数据库映射文件。也有人叫做领域层。 Wolfy.Shop.Data:数据层,存放数据库的操作及Nhibernate辅助类。引用Iesi.Collections.dll,NHibernate.dll和类库Wolfy.Shop.Domain Wolfy.Shop.Business:业务逻辑类。引用类库项目Wolfy.Shop.Domain,Wolfy.Shop.Data Wolfy.Shop.WebSite:测试项目。需引用Iesi.Collections.dll,NHibernate.dll和类库项目Wolfy.Shop.Domain,Wolfy.Shop.Business Nhibernate最新版本为4.0.1.GA,下载地址:http:/// 解压NHibernate-4.0.1.GA-bin.zip压缩包,内容如下: 其中Confiuration_Templates文件夹内包括: 这些xml内为数据库连接配置文件模版,通过上图也可以发现nhibernate支持的数据库种类还是很全的。主流的数据库已经都包括在内了。 那么,咱们打开MSSQL.cfg的文件看一下 1 <?xml version="1.0" encoding="utf-8"?> 2 <!-- 3 This template was written to work with NHibernate.Test. 4 Copy the template to your NHibernate.Test project folder and rename it in hibernate.cfg.xml and change it 5 for your own use before compile tests in VisualStudio. 6 --> 7 <!-- This is the System.Data.dll provider for SQL Server --> 8 <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > 9 <session-factory name="NHibernate.Test"> 10 <property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property> 11 <property name="connection.connection_string"> 12 Server=(local);initial catalog=nhibernate;Integrated Security=SSPI 13 </property> 14 <property name="dialect">NHibernate.Dialect.MsSql2008Dialect</property> 15 </session-factory> 16 </hibernate-configuration> 通过上面的注释部分咱们可以得到一个信息,就是在项目中使用的话,需要将文件重命名为hibernate.cfg.xml. 添加引用 同样可以通过Nuget进行添加,如图: 持久化类为客户实体创建持久化类 1 namespace Wolfy.Shop.Domain.Entities 2 { 3 /// <summary> 4 /// 描述:客户实体,数据库持久化类 5 /// 创建人:wolfy 6 /// 创建时间:2014-10-16 7 /// </summary> 8 public class Customer 9 { 10 /// <summary> 11 /// 客户id 12 /// </summary> 13 public virtual Guid CustomerID { get; set; } 14 /// <summary> 15 /// 客户名字 16 /// </summary> 17 public virtual string CustomerName { get; set; } 18 /// <summary> 19 /// 客户地址 20 /// </summary> 21 public virtual string CustomerAddress { get; set; } 22 } 23 }
编写映射文件 编写NHibernate配置文件智能提示的功能。只要在下载的NHibernate里找到configuration.xsd和nhibernate-mapping.xsd两个文件并复制到vs安装目录下,如C:\Program Files\Microsoft Visual Studio 9.0\Xml\Schemas目录即可。 此时,你在nhibernate的配置文件中就有智能提示功能了。 nhibernate如何知道持久化类和数据库表的对应关系的呢?这就要通过映射文件来完成这个任务了,映射文件包含了对象/关系映射所需的元数据。元数据包含持久化类的声明和属性到数据库的映射。映射文件告诉nhibernate它应该访问数据库里面的哪个表及使用表里面的哪些字段。 那么我们编写Customer持久化类的映射文件,注意映射文件以.hbm.xml结尾。如Customer.hbm.xml 1 <?xml version="1.0" encoding="utf-8" ?> 2 <!--assembly:程序集,namespace:命名空间--> 3 <hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" assembly="Wolfy.Shop.Domain" namespace="Wolfy.Shop.Domain.Entities"> 4 <class name="Wolfy.Shop.Domain.Entities.Customer,Wolfy.Shop.Domain" table="TB_Customer"> 5 <!--主键--> 6 <id name="CustomerID" type="Guid" unsaved-value="null"> 7 <column name="CustomerID" sql-type="uniqueidentifier" not-null="true" unique="true"/> 8 <generator class="assigned"></generator> 9 </id> 10 <property name="CustomerName" type="String"> 11 <column name="CustomerName" sql-type="nvarchar" not-null="false"/> 12 </property> 13 <property name="CustomerAddress" type="String"> 14 <column name="CustomerAddress" sql-type="nvarchar" not-null="false"/> 15 </property> 16 17 </class> 18 </hibernate-mapping> 这些东西该怎么记?记住根节点hibernate,并且映射文件中要有主键id和property节点就可以了,其他的依赖vs的智能提示,就可以了。 否则会出现,如下错误,而这个错误也是使用nhibernate最常见,所以养成一个好习惯,能提高你的开发效率: 辅助类在使用之前,需要通过ISessionFactory获得ISession,ISessionFactory的详细介绍可以参考文档[NHibernate]ISessionFactory配置 ,ISessionFactory是线程安全的,而ISession是非线程安全的。很多线程可以同时访问ISessionFactory,所以ISession要通过ISessionFactory打开,在所有的工作完成后,需要关闭。ISessionFactory通常是个线程安全的全局对象,只需要被实例化一次(可以使用单例模式)。这里编写一个简单的辅助类NHibernateHelper,用于创建ISessionFactory和配置ISessionFactory,并打开一个新的ISession的方法。代码如下:
View Code
这里需引入命名空间:NHibernate和NHibernate.Cfg。 数据库设计与连接配置数据表设计如图所示: 创建数据表的sql
View Code
nhibernate配置,也就是数据库配置: 这里使用的是SQL Server2012,所以我们使用MSSQL.cfg.xml文件,重命名为hibernate.cfg.xml. 注意需根据自己数据库的实例名修改,并添加mapping节点,其他的设置,可根据需要进行添加。这里采用最简单的一种方式,关于nhibernate的配置参数,可参考文档中的说明。 1 1 <?xml version="1.0" encoding="utf-8" ?> 2 2 <hibernate-configuration xmlns="urn:nhibernate-configuration-2.2" > 3 3 <session-factory> 4 4 <property name="connection.driver_class">NHibernate.Driver.SqlClientDriver</property> 5 5 <property name="connection.connection_string"> 6 6 server=.;database=shop;uid=sa;pwd=sa 7 7 </property> 8 8 <property name="dialect">NHibernate.Dialect.MsSql2008Dialect</property> 9 9 <mapping assembly="Wolfy.Shop.Domain"/> 10 10 </session-factory> 11 11 </hibernate-configuration> 修改后,将hibernate.cfg.xml拷入Wolfy.Shop.WebSite项目,并修改其属性: 否则会出现如下异常: 数据层和业务逻辑层代码
View Code
View Code
测试为了以后使用方便,在这里使用webform项目作为测试,通过单击“添加”按钮,向数据库中插入记录, 页面
CustomerManager。aspx
CustomerManager.aspx.cs
界面 通过SQL Server Profiler查看生成的sql语句 通过监控到的sql语句,也可以看到使用nhibernate插入数据时,数据库中是通过存储过程进行插入数据的。 总结本文简单介绍了使用nhibernate的一些配置,给我的感觉是,在使用时只要配置正确,其他的增删改查什么的也就没什么难的了。在配置nhibernate的时候,有些细节需要注意。比如映射文件和nhibernate的配置文件的属性需要进行修改。 参考文章 http://www.cnblogs.com/lyj/archive/2008/10/14/1310913.html#comment_tip |
|