C#——Nhibernate探索

 C#—Nhibernate探索

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

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

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

分析文件内容

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

 

我们可以分析得出，其中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，那自然就会慢一点。

 

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

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