C#——Nhibernate探索
C#—Nhibernate探索
本篇文章,让我们一起来探索Nhibernate。
首先我们去搜索Nhibernate下载地址,如下链接所示。
该版本可能是最新版,我下载的4.0.4.GA。其中GA意思我没搞清楚。不过应该不重要。
https://sourceforge.net/projects/nhibernate/
分析文件内容
下载完成后,解压缩,我们看到文件夹内容如下图所示。
我们可以分析得出,其中Required_Bins存储的是类库和其他资源;字面的意思Required,是必须文件。
打开Required文件夹,我们看到里面是这样的。
这里有两个类库;可以分析得出,这两个类库是要被引用的。
类库拥有对应的XML,没找到具体使用该XML的方法。所以暂时不去理他。
NHibernate.pdb应该是没有用的。估计是作者忘记删除了。
nhibernate-configuration.xsd和nhibernate-mapping.xsd两个文件暂时不知道要干什么用的。
但看到.xsd文件,第一时间反应,他们应该是用来帮助开发者,快速生成配置文件用的。为了保险起见,我们上网查询一下。
查询结果:
查询结果是,他们俩是【文件智能提示功能】用的。
且nhibernate-configuration.xsd和nhibernate-mapping.xsd是要放到c盘的,路径如下:
C:\Program Files (x86)\Microsoft Visual Studio 11.0\Xml\Schemas
因为是我用的是vs2012,所以,我找的路径是Microsoft Visual Studio 11.0。并将文件放在了那里面。
虽然感觉,这俩文件好像不是这么用的,但由于可以判断它们并不影响程序运行,所以,先且不管他们,等程序运行起来后,再删除他们试试。
再之后,我上网调查了下Nhibernate的应用。
上网调查后,发现Nhibernate有Castle框架、LinFu框架、Spring.Net三种。
看起来很复杂,文章有很多,写的又很复杂,于是我放弃调查,直接尝试使用,首先第一步,直接引用类库。
一、建立了一个类库程序,引用Iesi.Collections.dll和NHibernate.dll两个DLL。
接下来,我们开始建立持久化对象。
1 2 3 4 5 | public class Test { public virtual int Id { get ; set ; } public virtual string Name { get ; set ; } } |
接下来建立持久化对象与数据库的映射。再次上网调查。
调查结果:
对象与数据库的映射是保存在XML文件中的,于是我配置XML映射文件如下。
该XML文件的属性,要求设置其生成操作为【嵌入的资源】。
但我怕它丢失,还给他设置了始终复制的属性。
XML文件如下:
1 2 3 4 5 6 7 8 9 10 11 | <?xml version= "1.0" encoding= "utf-8" ?> <hibernate-mapping xmlns= "urn:nhibernate-mapping-2.2" assembly= "NherbinateHelper" namespace = "NherbinateHelper" > < class name = "Test" > <id name= "Id" column = "Id" > <generator class = "native" /> </id> <property name = "Name" /> </ class > </hibernate-mapping> |
再然后,我需要建立数据库连接的类。
再次上网调查。编写NHibernateHelper如下。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | public class NHibernateHelper { private ISessionFactory _sessionFactory; public NHibernateHelper() { _sessionFactory = GetSessionFactory(); } private ISessionFactory GetSessionFactory() { return ( new Configuration()).Configure().BuildSessionFactory(); } public ISession GetSession() { return _sessionFactory.OpenSession(); } } |
因为我们没有显示设置数据库连接字符串,所以,如果程序可以运行,那么这个类,一定会读配置文件中SQL字符串连接。
然后,我们建立domain(域),添加对Text持久化对象的增删改查的方法。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | public class NHibernateSample { protected ISession Session { get ; set ; } public NHibernateSample(ISession session) { Session = session; } public void CreateCustomer(Test test) { Session.Save(test); Session.Flush(); } public Test GetCustomerById( int Id) { return Session.Get<Test>(Id); } } |
再然后,我们新建一个控制台程序,用于测试我们编写的这个NHibernate,是否可以正常运行。
编写测试类代码如下。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | public class NHibernateSampleFixture { private NHibernateSample _sample; public NHibernateSampleFixture() { _sample = new NHibernateSample( new NHibernateHelper().GetSession()); } public void GetCustomerByIdTest() { var tempCutomer = new Test { Name = "李" }; _sample.CreateCustomer(tempCutomer); Test customer = _sample.GetCustomerById(1); int customerId = customer.Id; } } |
main函数调用如下:
1 2 3 4 5 6 7 8 | class Program { static void Main( string [] args) { NHibernateSampleFixture f = new NHibernateSampleFixture(); f.GetCustomerByIdTest(); } } |
测试结果是失败,因为,我们还没有在任何地方设置数据库连接字符串。所以推断,缺少了配置数据库连接的文件。
接着,我打开文件夹了Configuration_Templates。
发现Configuration_Templates文件夹下有如下文件。
我推断,这里就是数据库连接字符串的模板。
由于我使用的数据库是sqlserver,所以,我复制了mssql.cfg.xml。
然后将复制的文件,黏贴到测试的控制台程序下,然后改名为《hibernate.cfg.xml》。
这里测试了下,貌似不改名不好使,配置文件内容如下
【PS:我始终没搞懂,XML中的CFG代表什么意思。】
1 2 3 4 5 6 7 8 9 10 11 | <?xml version= "1.0" encoding= "utf-8" ?> <hibernate-configuration xmlns= "urn:nhibernate-configuration-2.2" > <session-factory name= "NHibernate.Test" > <property name= "connection.driver_class" >NHibernate.Driver.SqlClientDriver</property> <property name= "connection.connection_string" > Server=SKY-20160718RXO\SA;initial catalog=Nherbinate;Integrated Security=SSPI; </property> <property name= "dialect" >NHibernate.Dialect.MsSql2012Dialect</property> <mapping assembly= "NherbinateHelper" /> </session-factory> </hibernate-configuration> |
因为我连接的是sqlserver2012,所以配置文件里,我将原始版SQL2008的property 修改为
<property name="dialect">NHibernate.Dialect.MsSql2012Dialect</property>
注意
其中<mapping assembly="NherbinateHelper"/>是后加的,原文件里没有。
这句话的意思是,映射我创建的那个类库。
我推断,Nherbinate是读这个配置文件,然后到这个程序集里,反射查询那些poco对象。
最后,nhibernate-configuration-2.2这句话我想了很久要不要改成4.0。
结果是我没改,测试一切正常。可以顺利使用。
结语
这是一场Nhibernate探索之旅,结果是非常顺利的配置成功了。共耗时2小时。
为什么说是探索之旅呢,因为,我也是首次配置Nhibernate,我平常更多的是使用Entity Framework。
文中使用了一些推断,猜测的词语。那是因为,真的是在推断的。我并不清楚那几个点的原理和含义,因为我没看Nhibernate的原代码。
虽然本文是讲述,配置Nhibernate;但我更想讲述的是,面对未知的框架入手学习和使用的方法。
我描述了自身一步一步配置Nhibernate的路径,我觉得还算高效,大家也可以效仿,用来学习陌生框架。
当然不必太追求速度,因为每个人的基础不一样。我比较熟悉Entity Framework。所以学习Nhibernate就会比较快。
如果你还没接触过ORM,那自然就会慢一点。
----------------------------------------------------------------------------------------------------
注:此文章为原创,任何形式的转载都请联系作者获得授权并注明出处!
若您觉得这篇文章还不错,请点击下方的【推荐】,非常感谢!
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期(2025年3.1-3.9)
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异