C# 數據操作系列 – 11 NHibernate 配置和結構介紹

0. 前言

今天是NHibernate的第二篇內容,通過上一篇的內容,我們初步了解了NHibernate的創建和使用。這一篇,我繼續探索NHibernate背後的秘密。嗯,就是這樣。

1. NHibernate結構

先給小夥伴們放個圖:

結構圖

這是NHibernate的整體結構圖。NHibernate通過ADO.NET 建立訪問資料庫的連接,然後封裝了一個Transaction(事務)工廠和一個Session工廠。每次操作的時候,通過兩個工廠獲取對應的Session/Transaction示例操作數據對象。

ISessionFactory – NHibernate.ISessionFactory:

一個基於單資料庫的已編譯的映射快取,它是持久不變的且執行緒安全(額,這句話是從它的文檔翻譯過來的)。是一個提供ISession的工廠類,同時也是一個 IConnectionProvider的客戶端。可以設置一個在事務之間的進程級或集群級的二級快取。

ISession – NHibernate.ISession:

一個單執行緒、短生命周期的對象,表示從應用程式和數據持久化之間一個連接。一個ADO.NET連接的封裝,用來提供ITransaction的工廠。提供了一個通過主鍵檢索對象和導航鏈接查詢對象時的一級快取。也就是EF Core中的導航屬性。

Persistent Objects and Collections(持久化對象和集合):

一些單執行緒、短生命周期對象其中包含持久化狀態和業務方法。它們可能只是一些普通的POCO,僅僅是與ISession中關聯起來了。只要ISession關閉了,這些對象就可以被分離出來然後可以在應用層的任意地方使用。

Transient Objects and Collections(臨時對象和集合):

表示臨時的未被ISession託管的持久化對象,它們被應用層臨時創建但直到ISession關閉都不會被持久化。

ITransaction – NHibernate.ITransaction:

這個是可選的。表示一個單執行緒、短生命周期的對象,被應用程式用來限制一個原子的工作單元,基於ADO.NET 的Transaction的抽象。一個ISession可能會開啟多個事務,Transaction scopes may be used instead(原話是這個,大意是可以改用事務作用域)。

IConnectionProvider – NHibernate.Connection.IConnectionProvider:

也是可選的,是一個用來創建ADO.NET Connection和Command的工廠。基於DbConnection和DbCommand實現,並非直接暴露給應用程式,但是可以由開發者對其進行擴展或實現。

IDriver -NHibernate.Driver.IDriver:

可選的,驅動介面,用來封裝隱藏不同ADO.NET 數據提供程式之間的不同。例如:參數化等。

ITransactionFactory – NHibernate.Transaction.ITransactionFactory:

可選的,事務實現工廠,不對應用程式公開,但開發者可以對其進行擴展或實現。

2. 實例狀態

在NHibernate中,一個可持久化的對象有三種不同的狀態,依據與持久化上下文之間的關係不同,其中ISession就是一個持久化上下文。狀態分為以下三種:

  • transient 暫存的、臨時的 該狀態的對象並沒有被持久化上下文捕獲到,簡單來講就是剛被創建,還沒有從資料庫/持久化上下文中獲取到主鍵資訊。

  • persistent 持久化的 該狀態的對象表示已經被上下文正確獲取到了,持久化上下文能夠監控到對象的變化。持久化上下文中持有一個指向該對象的引用。這種狀態通常是從資料庫中獲取到數據或者新建的數據附加到了上下文中。

  • detached 遊離態 該狀態的對象是從上下文中分離出來的,有了資料庫主鍵,曾經或現在仍然有一條資料庫記錄與之對應。造成的原因可能有,上下文關閉了;該對象是在另一個上下文中持久化的,它對於當前上下文是遊離態的。

3. 配置項介紹

在上一篇文章中,我們介紹了一下如何設置NHibernate的基本配置項,但是並未對配置項進行深入。這一節,將帶領大家看一下NHibernate中我們常用的配置,因為配置項有很多,但一大部分通常情況都遇不到使用它的時候。

  • dialect

    資料庫方言,表示NHibernate連接的資料庫是什麼,該用哪種格式解析關係映射到資料庫SQL語句

  • default_schema

    默認的schema,用來設置連接字元串連接的資料庫默認的schema。

  • connection.provider

    資料庫連接的提供程式,默認是NHibernate.Connection.DriverConnectionProvider. 填繼承自 IConnectionProvider 的實現類

  • connection.connection_string

    資料庫連接字元串

  • connection.connection_string_name

    資料庫連接字元串的名稱,指的是配置在程式的配置文件中 connectionStrings節點的數據連接字元串。

  • max_fetch_depth

    最大遞歸深度,表示一次查詢中直接載入的導航屬性深度。默認是不直接載入導航屬性,基於延遲載入的邏輯,由實際使用時才從資料庫中載入數據。

  • show_sql

    是否在控制台中列印轉換的SQL語句,一般在調試的過程中會設置為true,用來確認生成的SQL是否正確等。

  • hbm2ddl.auto

    該值表示每次ISessionFactory創建的時候,是否自動生成DDL語句並提交資料庫執行。默認是空,表示不會強制更新資料庫。有幾個候選值:create或create-drop、update等。其中create表示每次只創建新增的;create-drop表示每次ISessionFactory創建時創建表 ,ISessionFactory關閉時,刪除表;其中update表示每次都會將DDL SQL更新到資料庫中。(我記得有update,但文檔中沒有這個選項)

以上是我們常用的一些配置內容,當然還有更多的配置,我並沒有在這裡一一講明,留待以後吧。

4. 總結

這是一篇枯燥乏味的說明文,主要介紹了Nhibernate的基本內容。下一章我們來試試,如何創建Nhibernate的映射配置。

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

file

Tags: