C# 資料操作系列 - 11 NHibernate 配置和結構介紹

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

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

相關文章