C# 資料操作系列 - 10 NHibernate初試

月影西下發表於2020-05-20
C#

0. 前言

在上一篇基本講完了EF Core的入門級教程。從這一篇開始，我們試著去探索一下 .net core平臺上更多的ORM框架。那麼，這一篇開始我們就來試試NHibernate。

1. NHibernate 介紹

NHibernate是Hibernate的C#版，眾所周知Hibernate是Java 裡ORM的頂樑柱（至少曾經）。Hibernate可以說開拓了Java的世界，當年SSH三駕馬車風靡世界，至今Hibernate都發揮著舉足輕重的作用。

不過，與EntityFramework不同的地方是，Hibernate以配置檔案為主，通過配置檔案規範使用，Object/Relation 對映。而NHibernate這繼承了這一點，也是以配置檔案優先。下圖是 NHibernate的工作原理：

img

通過讀取App.config或者Web.config檔案去讀NHibernate的基本配置，然後載入對映檔案，建立對映關係。在後續使用中，通過對映關係生成SQL語句（這一步跟EF是一致的），進而運算元據或者查詢資料。

2. 初探 NHibernate

2.1 準備

先來個控制檯專案，我起名為dataprovider。然後安裝NHibernate：

  1. NuGet：
Install-Package NHibernate
  1. dotnet core 命令列：
dotnet add package NHibernate

這個文章中使用的NHibernate版本是 5.2.7

2.2 配置

需要建立一個專案用的配置檔案：App.config.

C# 專案中，除了Web型別的專案，每個專案的主配置檔案的名稱都是App.config，這是一個固定名稱。

檔案內容如下：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
</configuration>

在 configuration節點之間新增以下內容：

<configSections>
    <section name="hibernate-configuration" type="NHibernate.Cfg.ConfigurationSectionHandler, NHibernate"/>
  </configSections>

這段程式碼的含義是，在config檔案中新增一個 hibernate-configuration結點，結點的解析由類：NHibernate.Cfg.ConfigurationSectionHandler，所在包是NHibernate。

在App.config檔案configuration結點中新增以下程式碼：

<hibernate-configuration xmlns="urn:nhibernate-configuration-2.2">
    <session-factory>
        <property name="dialect">NHibernate.Dialect.MsSql2012Dialect</property>
        <property name="connection.connection_string">
            Data Source=.;Initial Catalog=Demo;Integrated Security=True
        </property>
        <property name="hbm2ddl.auto">create-drop</property>
        <mapping assembly="dataprovider" />
    </session-factory>
</hibernate-configuration>

這是固定格式，其中dialect表示使用的資料庫型別，connection.connection_string 表示連線字串。mapping表示對映關係檔案所在專案。

2.3 獲取ISessionFactory

然後獲取一個ISessionFactory：

Configuration cfg = new Configuration();
var sessionFactory = cfg.BuildSessionFactory();

當然，如果直接執行程式碼的話，會在 BuildSessionFactory這裡報錯。因為沒有為SQL Server安裝資料訪問驅動：

System.Data.SqlClient

將資料訪問驅動安裝成功後，執行可以獲得sessionFactory。

sessionFactory用來建立一個訪問資料庫的Session

2.4 增刪改查

先來個簡單的示例類：

public class Cat
{
    public virtual string Id { get; set; }
    public virtual string Name { get; set; }
    public virtual char Sex { get; set; }
    public virtual float Weight { get; set; }
}

NHibernate的對映關係檔案：Cat.hbm.xml

<?xml version="1.0" encoding="utf-8" ?>
<hibernate-mapping xmlns="urn:nhibernate-mapping-2.2" namespace="dataprovider" assembly="dataprovider">
  <class name="Cat" table="Cat">

    <!-- A 32 hex character is our surrogate key. It's automatically
            generated by NHibernate with the UUID pattern. -->
    <id name="Id">
      <column name="CatId" sql-type="char(32)" not-null="true"/>
      <generator class="uuid.hex" />
    </id>
    <!-- A cat has to have a name, but it shouldn't be too long. -->
    <property name="Name">
      <column name="Name" length="16" not-null="true" />
    </property>
    <property name="Sex" />
    <property name="Weight" />
  </class>
</hibernate-mapping>

建立完成後，右鍵選中檔案，修改檔案生成操作為巢狀的資源

image-20200519000456989

然後編寫例項程式碼：

Configuration cfg = new Configuration().Configure();

using (var sessionFactory = cfg.BuildSessionFactory())
using (var session = sessionFactory.OpenSession())
{
// 通過session操作
    session.Close();
}

新增一個Cat：

var princess = new Cat
{
    Name = "Princess",
    Sex = 'F',
    Weight = 7.4f
};
session.Save(princess);
session.Flush();//推送修改給資料庫，不呼叫的話資料庫裡將沒有資料

查詢並修改：

var cats = session.Query<Cat>().ToList();
var cat = cats.First();
cat.Name = "xiao li";
session.Update(cat);
session.Flush();

查詢並刪除：

var cats = session.Query<Cat>().ToList();
var cat = cats.First();
session.Delete(cat);
session.Flush();

這是NHibernate的入門級的入門教程。嗯，給大家一個NHibernate的圖：

img

3. 總結

NHibernate延續了Hibernate的優點，如果之前瞭解過Hibernate的人上手不難。輕量簡單，不過得需要配置檔案。下一期將帶領大家繼續深入研究NHibernate。

更多內容煩請關注我的部落格《高先生小屋》

file

相關文章