当前位置:电脑软件 > 编程开发 > 编程软件 > NHibernate v5.2.3

NHibernate v5.2.3

大小:10.6MB语言:英文类别:编程软件

类型:国外软件授权:免费软件时间:2019/7/17

官网:

环境:Windows10, Windows8, Windows7, WinVista, WinXP

安全检测:无插件360通过腾讯通过金山通过瑞星通过

普通下载

高速下载

需下载高速下载器,提速50%

NHibernate是一款面向.NET环境的对象/关系数据库映射工具。提供了将域模型(类)映射到传统关系数据库并生成查询所需的框架。NHibernate的目标主要是用于与数据持久化相关的编程任务,大幅度减少开发时人工使用SQL和ADO.NET处理数据的时间。能够使开发人员从原来枯燥的SQL语句的编写中解放出来,解放出来的精力可以让开发人员投入到业务逻辑的实现上。
NHibernate

相关配置

一、NHibernate基本配置
NHibernate配置要注意的有:
1、NHibernate需要一个自定义的配置节点,一般放在Web.config里或App.config里面,当然你可以自己定义实际位置

(1)、声明自定义配置节点
  name:自定义配置节点名称。
  type:处理程序位置。
(2)、声明是哪一个数据库驱动程序。
(3)、数据库连接。
(4)、所使用的SQL方言,通过这个方言,NHibernate才知道要将你写的查询语句,翻译成何种数据库的SQL语句。
(5)、设定映射文件默认所在的程序集。
2、NHibernate的映射文件一定要设为嵌入的资源。
3、NHibernate的实体类所有的属性都要加上virtual-虚属性,NHibernate作为一个ORM框架,它需要知道如何将数据库的表与对应的实体类相关联,NHibernate通过映射文件的方式来获得这方面的信息。
二、获取映射文件相关配置
NHibernate中的映射文件以hbm.xml为后缀结束,NHibernate获取映射文件的方法有3种方法:
1、从config程序配置文件获取映射文件位置
NHibernate运行在.Net程序上,需要自己提供一个自定义配置节点,这个配置节点里面包含了数据库连接,什么数据库等等信息。其中就包括了配置文件所在位置的信息。
NHibernate会直接从Web.config或App.config文件上的配置节点上读取这个节点,然后从节点指定的程序集去查找映射文件。
2、编程的方式,写在代码里

(1)、AddFile 指定映射文件
ISessionFactory sessionFactory = new Configuration().Configure().AddFile(@"C:\Users\Administrator\Desktop\NHibernate学习\Model\Mapping\Person.hbm.xml").BuildSessionFactory();
ps:当你不写全路径的时候,也就是只写个文件名,那么NHibernate就会从配置文件读取程序集,到配置文件中指定的程序集去加载此映射文件。如果配置文件并不指定程序集,那么就从当前程序集中查找指定名的映射文件。但这种方式,不必设置嵌入的资源,但要记得设置为始终复制。
Configuration cfg = new Configuration().AddFile("Mapping/Person.hbm.xml");ISessionFactory sessionFactory = cfg.BuildSessionFactory();
这种方法只是指定一个文件,但是可以链式指定多个如:AddFile("f1").AddFile("f2")。
(2)、AddAssembly
还有另外一种方法,在创建Configuration时指定程序集。
Configuration cfg = new Configuration().AddAssembly("Model");       //Model为映射文件所在程序集名称
 ISessionFactory sessionFactory = cfg.BuildSessionFactory();
这种方法,即使.config配置文件里节点为空也没关系,NHibernate会自动到指定的程序集里查找所有以.hbm.xml结尾的文件。
(3)、AddClass
这种方式,可以消除程序对文件路径字符串的硬编码。
Configuration cfg = new Configuration().AddClass(typeof(Model.Person));
ISessionFactory sessionFactory = cfg.BuildSessionFactory();
但是缺点也非常明显,类名必须与映射文件的名称相同。不然,编译就无法通过,因为Person类都找不到。另外,映射文件Person.hbm.xml必须放在根目录。NHibernate会自动到程序中去查找名为Person.hbm.xml文件。

使用方法

步骤一、创建数据库和映射的表

步骤二、创建项目和实体类映射类以及类对应的映射文件
新建一个网站,网站创建之后,网站解决方案右键,选择添加 => 新建项目 => 类库

给类库起名

与之前写的实体类不同的是此实体类每个属性前面就加了virtual,虚方法或者属性的关键字,子类可以从新定义(override),在这里必须有virtual 关键字,不然程序运行就会出错。笔者判断此原因可能是程序在运行时候此属性被重新映射(定义),所以必须添加virtual关键字。
然后比较重要的一个步骤就是配置此实体类对应的映射文件,此映射xml文件名称固定为“实体类.hbm.xml”

实体类的属性配置,其中“Com.uuu9.nHibernate”为上述所建类库(生成程序集的名称)的名称。注意:每个实体类对应的映射文件“实体类.hbm.xml”,都要右键设置生成类型属性为:嵌入的资源

因为当作为一个资源被嵌入后,项目的默认命名空间与文件名就组成了资源访问的完整名称,NHibernate运行时会访问资源的完整名称,但如果不设置,程序就找不到映射文件,就会认为此类没有设置映射,也就不能使用NHibernate操作。
步骤三、添加项目引用与NHibernate(版本2.1.2)的dll文件

步骤四、配置hibernate.cfg.xml文件(数据库映射信息配置)
hibernate.cfg.xml文件为NHibernate的配置文件,名称固定,且必须放到Bin目录中

name可以自己随意定义:NHibernate.Dialect.MsSql2005Dialect
“NHibernate.Dialect.MsSql2005Dialect”可根据实际的数据库的需要改为 2000Dialect、2008Dialect。
注意:“”为实体类生成程序集的名称,一直要写正确,一定要有。
步骤五、创建和使用NHibernate

至此NHibernate制作完毕。

体系结构

1、SessionFactory(NHibernate.IsessionFactory):它是Session的工厂,是ConnectionProvider的客户。可以持有一个可选的(第二级)数据缓存,可以在进程级别或集群级别保存的可以在事物中重用的数据。
2、会话(NHibernate.ISession):单线程,生命期较短的对象,代表应用程序和持久化层之间的一次对话。封装了一个ADO.NET连接,也是Transaction的工厂。保存有必需的(第一级)持久化对象的缓存,用于遍历对象图,或者通过标识符查找对象。
3、持久化对象(Persistent)及其集合(Collections):生命期较短的单线程的对象,包含了持久化状态和商业功能。这些可能是普通的对象,唯一特别的是现在从属于且仅从属于一个Session。一旦Session被关闭,它们都将从Session中取消联系,可以在任何程序层自由使用(比如,直接作为传送到表现层的DTO,数据传输对象)。
4、临时对象(Transient Object)及其集合(Collection):目前没有从属于一个Session的持久化类的实例。这些可能是刚刚被程序实例化,还没有来得及被持久化,或者是被一个已经关闭的Session实例化。
5、事务Transaction (NHibernate.ITransaction):(可选)单线程,生命期较短的对象,应用程序用其来表示一批工作的原子操作,它是底层的ADO.NET事务的抽象。一个Session在某些情况下可能跨越多个Transaction事务。
6、ConnectionProvider(NHibernate.Connection.ConnectionProvider):(可选)ADO.NET连接的工厂。从底层的IDbConnection抽象而来。对应用程序不可见,但可以被开发者扩展/实现。
7、TransactionFactory(net.sf.hibernate.TransactionFactory):(可选)事务实例的工厂。对应用程序不可见,但可以被开发者扩展/实现。

常见问题

NHibernate,处理字段NULL值的问题
因为 birthday 在数据库里是“smalldatetime”类型,所以我们在创建表实体、以及xml映射的时候,可能会把 birthday 的类型设置为“DateTime”。但是经过这样的设置后,可能会出现以下错误提示:
SqlDateTime 溢出。必须介于 1/1/1753 12:00:00 AM 和 12/31/9999 11:59:59 PM 之间。 
说明: 执行当前 Web 请求期间,出现未处理的异常。请检查堆栈跟踪信息,以了解有关该错误以及代码中导致错误的出处的详细信息。 异常详细信息: System.Data.SqlTypes.SqlTypeException: SqlDateTime 溢出。必须介于 1/1/1753 12:00:00 AM 和 12/31/9999 11:59:59 PM 之间。
解决方法:
 当库中的字段为 DateTime 类型的时候,我们在创建表实体、以及xml映射的时候,应该将类型设置为“String”。
下载地址

有问题?点击报错+投诉+提问

网友评论

0条评论

评论需审核后才能显示