C# : Nhibernate探索

269 阅读5分钟
原文链接: click.aliyun.com

 C#—Nhibernate探索

本篇文章,让我们一起来探索Nhibernate。

首先我们去搜索Nhibernate下载地址,如下链接所示。

该版本可能是最新版,我下载的4.0.4.GA。其中GA意思我没搞清楚。不过应该不重要。

sourceforge.net/projects/nh…

分析文件内容

下载完成后,解压缩,我们看到文件夹内容如下图所示。

 

我们可以分析得出,其中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。 

接下来,我们开始建立持久化对象。


                    
public class Test 
 { 
        public virtual int Id { get; set; } 
        public virtual string Name { get; set; } 
}
 

接下来建立持久化对象与数据库的映射。再次上网调查。

调查结果:

对象与数据库的映射是保存在XML文件中的,于是我配置XML映射文件如下。

该XML文件的属性,要求设置其生成操作为【嵌入的资源】。

但我怕它丢失,还给他设置了始终复制的属性。

XML文件如下:


                    
<?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如下。


                    
 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持久化对象的增删改查的方法。


                    
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,是否可以正常运行。

编写测试类代码如下。


                    
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函数调用如下:


                    
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代表什么意思。】


                    
<?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,那自然就会慢一点。

 

----------------------------------------------------------------------------------------------------

注:此文章为原创,欢迎转载,请在文章页面明显位置给出此文链接!
若您觉得这篇文章还不错请点击下右下角的推荐,非常感谢!