如何在C#项目中使用NHibernate
现代化大型项目通常使用独立的数据库来存储数据,其中以采用关系型数据库居多。用于开发项目的高级语言(C#、Java等)是面向对象的,而关系型数据库是基于关系的,两者之间的沟通需要一种转换,也就是对象/关系数据库映射(Object/Relational Mapping,简称ORM)。
C#可用以解决对象/关系数据库映射的工具有多种,常见的有EF (Entity Framework)、NHibernate、iBATIS等,各自的优缺点及适用场景在此不做讨论,本文只对如何使用NHibernate做个总结。
NHibernate是一个面向.NET环境的对象/关系数据库映射工具。
1. 创建项目文件
在Visual Studio开发工具里创建需要的项目结构。
2. 添加对NHibernate的引用
当下载并解压NHibernate安装包后,电脑上就会创建一些目录,包括“Required_Bins”,要把 Required_Bins目录下的DLL引用到项目里来,它们是NHibernate使用的核心组件。
NHibernate.dll(基础类库,与数据库直接打交道,位于数据访问层)
Iesi.Collections(基础类库辅助类库,位于数据访问层)
Antlr3.Runtime(基础类库辅助类库,位于数据访问层)
NHibernate.ByteCode.Spring.dll(Proxy Factory类库,用于打开/关闭Nhibernate Session,位于数据访问层工具类库)
图1 添加对NHibernate的引用
3. 配置NHibernate
文件:hibernate.cfg.xml,位于站点根目录。
<?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">Data Source=120.120.200.200;Initial Catalog=MAMall;Persist Security Info=True;User ID=mamall;Password=mima123;connection reset=false;connection lifetime=50;min pool size=1;max pool size=500</property><property name="adonet.batch_size">10</property><property name="show_sql">true</property><property name="dialect">NHibernate.Dialect.MsSql2005Dialect</property><property name="command_timeout">10</property><property name="query.substitutions">true 1, false 0, yes 'Y', no 'N'</property><property name="proxyfactory.factory_class"> NHibernate.ByteCode.Spring.ProxyFactoryFactory,NHibernate.ByteCode.Spring</property><property name="connection.release_mode">on_close</property><mapping assembly="Fuli.Entity"/></session-factory> </hibernate-configuration>
4. 编写NHibernateHelper辅助类
文件:NHibernateHelper.cs
1 using System; 2 using Fuli.Tool.Log; 3 using NHibernate; 4 using NHibernate.Cfg; 5 6 namespace Fuli.DAL.Common 7 { 8 public class NHibernateHelper 9 { 10 private static ISessionFactory _sessionFactory; 11 private static ISessionFactory SessionFactory 12 { 13 get 14 { 15 if (_sessionFactory == null) 16 { 17 var configuration = new Configuration(); 18 configuration.Configure(); 19 _sessionFactory = configuration.BuildSessionFactory(); 20 } 21 return _sessionFactory; 22 } 23 } 24 25 public static ISession OpenSession() 26 { 27 try 28 { 29 return SessionFactory.OpenSession(); 30 } 31 catch (Exception ex) 32 { 33 LogHelper.GetInstance().WriteMessage("打开数据库失败,错误:" + ex.ToString()); 34 return null; 35 } 36 } 37 } 38 }
5. 创建数据模型
NHibernate允许直接使用Plain Old CLR Objects (POCOs),而不用通过存储过程来直接和数据库交互。使用POCOs的一个优势在于不用绑定特定的持久化层。相比较而言,有些ORM解决方案需要特殊属性,或者是基于模型对象,这些对象又是从特定的基类中继承而来的。
在NHibernate中不用特殊的修饰就可以让对象和持久化层交互。要注意的是所有需要持久化的属性必须是虚拟的,并且要开启延迟加载,所有数据模型类中的公共方法必须是虚拟的,哪怕它们并没有包含到映射文件中。
通常来讲,最好把所有的属性都设置为虚拟的。
可以借助MyGeneration自动代码工具从数据表生成数据模型和对应的映射文件。
1 using System; 2 using System.Collections.Generic; 3 4 namespace Fuli.Entity.Domain 5 { 6 /// <summary> 7 /// 共享编码表(字典表) 8 /// </summary> 9 [Serializable] 10 public class SharedCode 11 { 12 #region 构造方法 13 14 public SharedCode() 15 { 16 m_Id = 0; 17 m_Category = string.Empty; 18 m_Text = string.Empty; 19 m_Value = string.Empty; 20 m_IsDefault = false; 21 m_Description = string.Empty; 22 m_ParentId = 0; 23 m_SortOrder = 0; 24 } 25 26 #endregion 构造方法 27 28 #region 私有变量 29 30 private long m_Id; 31 private string m_Category; 32 private string m_Text; 33 private string m_Value; 34 private bool m_IsDefault; 35 private string m_Description; 36 private long m_ParentId; 37 private short m_SortOrder; 38 39 #endregion 私有变量 40 41 #region 公有属性 42 43 ///<summary> 44 /// 主键Id 45 ///</summary> 46 public virtual long Id 47 { 48 get { return m_Id; } 49 set { m_Id = value; } 50 } 51 52 ///<summary> 53 /// 分类 54 ///</summary> 55 public virtual string Category 56 { 57 get { return m_Category; } 58 set { m_Category = value; } 59 } 60 61 ///<summary> 62 /// 文本 63 ///</summary> 64 public virtual string Text 65 { 66 get { return m_Text; } 67 set { m_Text = value; } 68 } 69 70 ///<summary> 71 /// 编码值 72 ///</summary> 73 public virtual string Value 74 { 75 get { return m_Value; } 76 set { m_Value = value; } 77 } 78 79 ///<summary> 80 /// 是否是同类里默认 81 ///</summary> 82 public virtual bool IsDefault 83 { 84 get { return m_IsDefault; } 85 set { m_IsDefault = value; } 86 } 87 88 ///<summary> 89 /// 描述 90 ///</summary> 91 public virtual string Description 92 { 93 get { return m_Description; } 94 set { m_Description = value; } 95 } 96 97 ///<summary> 98 /// 父级Id(如果有) 99 ///</summary> 100 public virtual long ParentId 101 { 102 get { return m_ParentId; } 103 set { m_ParentId = value; } 104 } 105 106 ///<summary> 107 /// 排列次序 108 ///</summary> 109 public virtual short SortOrder 110 { 111 get { return m_SortOrder; } 112 set { m_SortOrder = value; } 113 } 114 115 #endregion 公有属性 116 117 #region 扩展属性 118 119 #endregion 扩展属性 120 121 #region Rewrite Equals and HashCode 122 123 /// <summary> 124 /// 125 /// </summary> 126 public override bool Equals(object obj) 127 { 128 if(this == obj) return true; 129 if((obj == null) || (obj.GetType() != GetType())) return false; 130 SharedCode castObj = (SharedCode)obj; 131 return (castObj != null) && (m_Id == castObj.Id); 132 } 133 134 /// <summary> 135 /// 用唯一值实现GetHashCode 136 /// </summary> 137 public override int GetHashCode() 138 { 139 int hash = 57; 140 hash = 27 * hash * m_Id.GetHashCode(); 141 return hash; 142 } 143 144 #endregion Rewrite Equals and HashCode 145 } 146 }
6. 创建NHibernate映射文件
Nhibernate使用XML映射文件来映射POCO到数据库对象。虽然在很多案例中这可能是一对一关系,但这并不是必定的。
文件:SharedCode.hbm.xml
<?xml version="1.0" encoding="utf-8" ?> <hibernate-mapping xmlns="urn:nhibernate-mapping-2.2"><class name="Fuli.Entity.Domain.SharedCode, Fuli.Entity" table="SharedCode"><id name="Id" column="Id" type="Int64" unsaved-value="0"><generator class="native"/></id><property name="Category" type="String" column="Category"/><property name="Text" type="String" column="Text"/><property name="Value" type="String" column="Value"/><property name="IsDefault" type="Boolean" column="IsDefault"/><property name="Description" type="String" column="Description"/><property name="ParentId" type="Int64" column="ParentId"/><property name="SortOrder" type="Int16" column="SortOrder"/></class> </hibernate-mapping>
在hibernate-maping标签中,同时引用类集(POCOs)所属的程序集命名空间。
- class元素表示到单个POCO的映射。name表示上面的程序集和命名空间中的类名,table属性告诉NHibernate数据库中的哪个表或者视图将被映射。
- id元素告诉NHibernate哪个数据库的字段和对应的对象作为一个唯一键来使用。在本例中,我们使用Id这个字段。
- generator元素告诉NHibernate怎样给新实体来创建唯一ID。
- property标签是见得最多的标签。它简单地映射一个到数据表或者视图中对应字段的映射。
一旦XML文件创建好了,需要更改XML的生成方式确保它被设置为嵌入式资源,否则NHibernate不会读取这个XML文件,那么映射就不会生效了。
图2 映射文件必须是嵌入的资源
7. 使用 NHibernate连接数据库
文件:CommonRepository
1 namespace Fuli.DAL.SQLServerImpl 2 { 3 public class CommonRepository : ICommonRepository 4 { 5 #region 新增 6 7 /// <summary> 8 /// 新增实体表 9 /// </summary> 10 /// <param name="obj"></param> 11 /// <returns></returns> 12 public long AddNewEntity<T>(object obj, string tableName) where T : new() 13 { 14 long id = 0; 15 try 16 { 17 using (ISession session = NHibernateHelper.OpenSession()) 18 { 19 id = long.Parse(session.Save((T)obj).ToString()); 20 session.Flush(); 21 } 22 } 23 catch (Exception ex) 24 { 25 LogHelper.GetInstance().WriteMessage(tableName + OperationType.COMMA + ex.ToString()); 26 } 27 return id; 28 } 29 30 /// <summary> 31 /// 新增实体表 32 /// </summary> 33 /// <param name="entity"></param> 34 /// <returns></returns> 35 public TReturn AddNewEntity<TEntity, TReturn>(object entity, string tableName) where TEntity : new() 36 { 37 TReturn returnValue = default(TReturn); 38 try 39 { 40 using (ISession session = NHibernateHelper.OpenSession()) 41 { 42 object returnObject = session.Save(entity); 43 if (returnObject != null) 44 { 45 returnValue = (TReturn)Convert.ChangeType(returnObject, typeof(TReturn)); 46 } 47 session.Flush(); 48 } 49 } 50 catch (Exception ex) 51 { 52 LogHelper.GetInstance().WriteMessage(tableName + OperationType.COMMA + ex.ToString()); 53 } 54 55 return returnValue; 56 } 57 58 #endregion 新增 59 } 60 }
对于不同的实体,可以一对一地写一个<Entity>Repository,专注负责相对应的实体操作。
8. 附录
NHibernate开源项目:https://sourceforge.net/projects/nhibernate/files/NHibernate/
Your first NHibernate based application:http://nhibernate.info/doc/tutorials/first-nh-app/your-first-nhibernate-based-application.html
NHibernate 快速上手:http://www.oschina.net/translate/nhibernate-quickstart?p=1#comments
Quickstart with NHibernate:https://docs.google.com/document/d/1OTC16N1GnKvgkIDvQn_RkQS_y3vvjYav-Ons9JLEUCU/edit?pli=1
NHibernate词条:https://baike.baidu.com/item/NHibernate
ANTLR:http://www.antlr.org/
酷客多小程序 陈苏洲
如何在C#项目中使用NHibernate相关推荐
- android开发使用c+_如何在Android项目中开始使用C ++代码
android开发使用c+ by Onur Tuna 通过Onur Tuna 如何在Android项目中开始使用C ++代码 (How to start using C++ code in your ...
- php7开发的项目怎么样,如何在PHP7项目中搭建一个多线程
如何在PHP7项目中搭建一个多线程 发布时间:2021-03-05 15:31:22 来源:亿速云 阅读:93 作者:Leah 这期内容当中小编将会给大家带来有关如何在PHP7项目中搭建一个多线程,文 ...
- react前端显示图片_如何在react项目中引用图片?
如何在react项目中引用图片?本文码云笔记将为大家整理在react项目中插入图片以及背景图片的方法,希望对需要的小伙伴提供一些参考. 在react项目中插入图片以及背景图片的方法共有2种: 1.im ...
- vfp生成菜单时文件不存在_如何在VFP项目中创建菜单
接上面两篇文章! 本文,我们来学习一下如何在VFP项目中创建菜单! 打开上文所讲的简单的项目文件,切换到"其他"选项卡! 如上图,选择"菜单"一项,之后点击&q ...
- 如何在vue项目中修改less变量,多主题项目解决方案
如何在vue项目中修改less变量,多主题项目解决方案 参考文章: (1)如何在vue项目中修改less变量,多主题项目解决方案 (2)https://www.cnblogs.com/niubilit ...
- 如何在Java项目中查找未使用/无效的代码
本文翻译自:How to find unused/dead code in java projects What tools do you use to find unused/dead code i ...
- python中pass的使用_pass语句如何在Python项目中使用
pass语句如何在Python项目中使用 发布时间:2020-11-16 14:55:02 来源:亿速云 阅读:98 本篇文章为大家展示了pass语句如何在Python项目中使用,内容简明扼要并且容易 ...
- jfinal 普通java工程_JFinal getModel方法如何在java项目中使用
JFinal getModel方法如何在java项目中使用 发布时间:2020-11-17 15:11:27 来源:亿速云 阅读:94 作者:Leah 今天就跟大家聊聊有关JFinal getMode ...
- IDEA下,如何在java项目中新增jsp模板文件
IDEA下,如何在java项目中新增jsp模板文件 大家会不会有这样的烦恼,就是当想要创建一个jsp模板文件的时候,右键new的时候找不到JSP选项. 这是因为在创建项目的时候没有选中Web Appl ...
最新文章
- 十一、深入JavaScript的定时器(七)
- python使用ddt_python使用ddt模块对用例执行操作
- Opencv2.4.9源码分析——HoughLinesP
- 二十四种设计模式:装饰模式(Decorator Pattern)
- CASE_04 基于FPGA的电梯控制器
- 苹果电脑删除软件_软件自动开启很烦人?如何彻底关掉开机自动开启的应用程序...
- 预览docx_Windows-快速预览文件-QuickLook
- 1506G. Maximize the Remaining String
- (pytorch-深度学习系列)卷积神经网络LeNet-学习笔记
- 《计算机应用基础》18春作业,【北语网院】18春《计算机应用基础》作业_4.pdf...
- opencv双目视觉标定、匹配和测量 (附代码)(转载)
- 《机器学习实战》学习总结(五)K-means算法原理
- 2D阵列中的峰值检测
- STM32F103mini教程学习总结与心得(四)---->看门狗
- 1045. Favorite Color Stripe (30)
- RubyOnRails开发知识链接汇总
- 高斯白噪声仿真-复信号分析
- Mac使用技巧:关闭系统自动更新
- 非线性思维 -- 大前研一
- AkShare-期货数据-连续合约数据,2010年的IFO怎么获取呢?
热门文章
- linux CMA总结
- 笔记本显示器仅计算机,别只玩性能 笔记本屏幕怎么进化才靠谱?
- SEO工具MIPCMS搜索引擎提交器 v1.1
- MIPCMS V3.1.0 远程写入配置文件Getshell过程分析(附批量getshell脚本)
- 校内hu测(10.6T2,T3)(乱搞+贪心+模拟)
- et200sp系统服务器模块,et200sp系统指导书.pdf
- 从2018到2022: 一个大数据工程师眼中的TiDB
- 软通动力外派华为手机
- 如何高效地使用 OneNote
- Springboot2.x集成ES7.x