C# 數據操作系列 - 12 NHibernate的增刪改查

0. 前言

上一篇《C# 數據操作系列 - 11 NHibernate 配置和結構介紹》 介紹了Nhibernate里的配置內容。這一篇將帶領大家了解一下如何使用NHIbernate。之前提到NHibernate繼承了Hibernate的一些傳統：使用XML文件進行配置，這一點也是備受爭議。不過，有社區愛好者開發了一個名為《Fluent NHibernate》的項目，用來支持NHibernate的流式配置。當然，NHibernate本身也提供了NHibernate.Mapping.ByCode模式。不過這一篇暫且略過，留待下文。

1. NHibernate映射文件

對於NHibernate的映射文件有個約定的名字：

<類名>.hbm.xml

這里先為大家介紹一下映射文件的格式：

1.1 hibernate-mapping 的說明

<hibernate-mapping
schema="schemaName" 									(1)
default-cascade="none|save-update" 						(2)
auto-import="true|false"		 						(3)
assembly="Eg" 											(4)
namespace="Eg" 											(5)
default-access="field|property|field.camecase..."		(6)
default-lazy="true|false" 								(7)
/>

1. schema: 數據庫schema的名稱
2. default-cascade：可選項，默認是none，一種默認的級聯風格
3. auto-import：明確是否可以在查詢中使用非限定類名。
4. assembly：指定映射對象所在的assembly，一般情況指的是項目名稱
5. namespace：所在命名空間
6. default-access：可選的，默認是property，表示NHibernate的讀取數據列的策略，默認情況從Property 中讀取
7. default-lazy：可選的，默認是true，是否啟動延遲加載

1.2 class的配置

一般情況下，class節點只需要指定name和table就可以了。接下來，讓我們探索class如何映射成的。

1.2.1 id

任何一個映射都必須聲明一個數據表的主鍵，大多數類也必須有一個唯一標示字段用來區分不同的實例。

這里介紹一下 id 節點的配置：

<id 
    name="PropertyName"
    type="typename"
    column="column_name">
    <generator class="generatorClass"/>
</id>

• name : 對應的屬性名
• type：對應的NHibernate類型
• column：列名
• generator：主鍵生成器，如果不需要參數可以直接在 id節點處添加，最常用的是native。

1.2.2 property

映射一個普通屬性就簡單多了，只需要進行以下配置即可：

<property
          name="propertyName"
          column="column_name"
          type="typename"
/>

• name ：類里的屬性名
• column：對應數據表的列名
• type：數據庫中的類型

1.2.3 many-to-one

在Nhibernate中，多對一的配置是在一的一端，表示該類有一個外鍵導航。

<many-to-one
             name="PropertyInOne"
             class="ManyClass"
             column="Column"
             ></many-to-one>

1.2.4 one-to-one

一對一的關系與多對一的關系比較相似，不同的地方在於一對一需要在雙方的映射關系里均要維護，在有外鍵的表/實體中 添加 constrained=“true”。

示例如下：

<one-to-one name="Person" class="Person"/>
<one-to-one name="Employee" class="Employee" constrained="true"/>

2. 增刪改查

Nhibernate的每次操作都基於一個Session，所以我們在操作數據庫的時候最好先持有一個可用的Session。接下來，我們就一個通用數據庫操作類為基礎，向大家分享一下我的想法。

首先，創建一個泛型模板類，並約束泛型為類：

public class Repository<T> where T: class
{

}

添加一個ISession屬性，用來后續訪問操作，並由構造方法賦值：

public Repository(ISession session)
{
    Session = session;
}

public ISession Session { get; }

2.1 新增

現在我們寫一下新增方法：

public object Add(T entity)
{
    var key= Session.Save(entity);
    return key;
}

public void Add(params T[] entities)
{
    foreach (var entity in entities)
    {
        Session.Save(entity);
    }
}

查了下，Save會返回當前持久化對象插入時生成的主鍵。

2.2 修改

NHibernate的修改與EF類似，也是由ISession監控了修改，不用做過多的操作。

2.3 刪除

NHibernate的刪除也十分簡單，直接通知ISession刪除某個持久化對象。

public void Delete(T entity)
{
    Session.Delete(entity);
}
public void Delete(params T[] entities)
{
    foreach (var entity in entities)
    {
        Session.Delete(entity);
    }
}

2.4 查詢

通常情況下，查詢需要結合實際業務來進行開發，當然為了通用，我在這里選擇給調用方開放一個查詢對象：

public IQueryable<T> IqQueryable()
{
    return Session.Query<T>();
}

其中 IQueryable是一個接口，表示這是一個可查詢對象，通過Linq可以快捷的查詢。

3. 總結

嗯，NHibernate基礎使用篇到這里可以暫告一段落了。后續的內容有機會再深挖，當然並不代表EF Core就沒有了。嗯嗯，沒毛病。下一篇就讓我來先替大伙看看SugarSQL是什么情況吧。

不過在本篇內容完結之前，先補充一個NHibernate的SqlDialect選值：

數據庫	Dialect	備注
DB2	NHibernate.Dialect.DB2Dialect
DB2 for iSeries(OS/400)	NHibernate.Dialect.DB2400Dialect
Firebird	NHibernate.Dialect.FirebirdDialect	需要設置driver_class為NHibernate.Driver.FirebirdClientDriver
Informix	NHibernate.Dialect.InformixDialect
Informix 9.40	NHibernate.Dialect.InformixDialect0940
Informix 10.00	NHibernate.Dialect.InformixDialect1000
Ingres	NHibernate.Dialect.IngresDialect
Ingres 9	NHibernate.Dialect.Ingres9Dialect
Microsoft SQL Server 7	NHibernate.Dialect.MsSql7Dialect
Microsoft SQL Server 2000	NHibernate.Dialect.MsSql2000Dialect
Microsoft SQL Server 2005	NHibernate.Dialect.MsSql2005Dialect
Microsoft SQL Server 2008	NHibernate.Dialect.MsSql2008Dialect
Microsoft SQL Azure Server 2008	NHibernate.Dialect.MsSqlAzure2008Dialect
Microsoft SQL Server 2012	Hibernate.Dialect.MsSql2012Dialect
Microsoft SQL Server Compact Edition	NHibernate.Dialect.MsSqlCeDialect
Microsoft SQL Server Compact Edition 4.0	NHibernate.Dialect.MsSqlCe40Dialect
MySQL 3 or 4	NHibernate.Dialect.MySQLDialect
MySQL 5	NHibernate.Dialect.MySQL5Dialect
MySQL 5 InnoDB	NHibernate.Dialect.MySQL5InnoDBDialect
MySQL 5.5	NHibernate.Dialect.MySQL55Dialect
MySQL 5.5 Inno DB	NHibernate.Dialect.MySQL55InnoDBDialect
Oracle	NHibernate.Dialect.Oracle8iDialect
Oracle 9i	NHibernate.Dialect.Oracle9iDialect
Oracle 10g, Oracle 11g	NHibernate.Dialect.Oracle10gDialect
Oracle 12c	NHibernate.Dialect.Oracle12cDialect
PostgreSQL	NHibernate.Dialect.PostgreSQLDialect
PostgreSQL 8.1	NHibernate.Dialect.PostgreSQL81Dialect	支持8.1 的 FOR UPDATE NOWAIT
PostgreSQL 8.2	NHibernate.Dialect.PostgreSQL82Dialect	在DROP TABLE和DROP SEQUENCE 語句中支持 IF EXISTS關鍵字
PostgreSQL 8.3	NHibernate.Dialect.PostgreSQL83Dialect	支持XML類型
SQLite	NHibernate.Dialect.SQLiteDialect	設置driver_class為NHibernate.Driver.SQLite20Driver
Sybase Adaptive Server Anywhere 9	NHibernate.Dialect.SybaseASA9Dialect
Sybase Adaptive Server Enterprise 15	NHibernate.Dialect.SybaseASE15Dialect
Sybase SQL Anywhere 10	NHibernate.Dialect.SybaseSQLAnywhere10Dialect
Sybase SQL Anywhere 11	NHibernate.Dialect.SybaseSQLAnywhere11Dialect
Sybase SQL Anywhere 12	NHibernate.Dialect.SybaseSQLAnywhere12Dialect

更多內容煩請關注我的博客《高先生小屋》