0. 前言 在上一篇基本講完了EF Core的入門級教程。從這一篇開始,我們試著去探索一下 .net core平臺上更多的ORM框架。那麼,這一篇開始我們就來試試NHibernate。 1. NHibernate 介紹 NHibernate是Hibernate的C 版,眾所周知Hibernate是J ...
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的工作原理:
通過讀取App.config或者Web.config文件去讀NHibernate的基本配置,然後載入映射文件,建立映射關係。在後續使用中,通過映射關係生成SQL語句(這一步跟EF是一致的),進而操作數據或者查詢數據。
2. 初探 NHibernate
2.1 準備
先來個控制台項目,我起名為dataprovider。然後安裝NHibernate:
- NuGet:
Install-Package NHibernate
- 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>
創建完成後,右鍵選中文件,修改文件生成操作為嵌套的資源
然後編寫實例代碼:
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的圖:
3. 總結
NHibernate延續了Hibernate的優點,如果之前瞭解過Hibernate的人上手不難。輕量簡單,不過得需要配置文件。下一期將帶領大家繼續深入研究NHibernate。
更多內容煩請關註我的博客《高先生小屋》