系列文章
引言
在上篇文章學習了orm和nhibernate相關概念,這篇文章主要學習ISessionFactory如何配置。
因為NHibernate被設計為可以在許多不同環境下工作,所以它有很多配置參數。不過,大部分都已經有默認值了。NHibernate.Test.dll包含了一個示例的配置文件app.config,它演示了一些可變的參數。
可編程配置方式
NHibernate. Cfg.Configuration的一個實例代表了應用程序中所有的.Net類到SQL數據庫的映射集合。Configuration用於構造一個(不可變的)ISessionFactory。這些映射是從一些XML映射文件中編譯得來的。
你可以得到一個Configuration的實例,直接實例化它即可。
一個例子
從兩個xml配置文件(和exe文件在同一個目錄下)的映射中初始化:
Configuration cfg = new Configuration().AddXmlFile("Item.hbm.xml") .AddXmlFile("Bid.hbm.xml");
某些情況下,有一個更好的方法是讓NHibernate自行用GetMainifestResourceStream()來裝載映射文件。
Configuration cfg = new Configuration() .AddClass( typeof(NHibernate.Auction.Item) ).AddClass( typeof(NHibernate.Auction.Bid) );
NHibernate就會在這些類型的程序集的嵌入的資源中尋找叫做NHibernate.Auction.Item.hbm.xml和NHibernate.Auction.Bid.hbm.xml的映射文件。這種方法取消了所有對文件名的硬編碼。
另外一個(可能是最好的)方法是讓NHibernate讀取一個程序集中的所有的配置文件:
Configuration cfg = new Configuration().AddAssembly( "NHibernate.Auction" );
NHibernate將會遍歷程序集查找任何以hbm.xml結尾的文件。這種方法取消了所有對文件名的硬編碼並且確保程序集中的配置文件都會被加載。
在使用vs或者NAnt生成的程序集時請確保hbm.xml文件是作為嵌入資源(Embedded Resources)添加的。
Configuration也可以指定一些可選的配置項。
Hashtable props = new Hashtable(); ... Configuration cfg = new Configuration() .AddClass( typeof(NHibernate.Auction.Item) ) .AddClass( typeof(NHibernate.Auction.Bid) ); cfg.Properties = props;
Configuration是僅在配置期使用的隊形,從第一個SessionFactory開始建立的
時候,它就失效了。
獲取ISessionFactory
當所有的映射都被Configuration解析之后,應用程序為了得到ISession實例,必須先得到它的工廠。這個工廠應該是被應用程序的所有線程共享的:
ISessionFactory session=cfg.BuidSessionFactory();
當然,NHibernate並不禁止你的程序實例化多個ISessionFactory。在你使用不止一個數據庫的時候,這就很有用了。
用戶自行提供ADO.NET連接
ISessionFactory可以使用一個用戶自行提供的ADO.NET連接來打開一個ISession。這種設計可以讓應用程序來自己管理ADO.NET連接:
IDbConnection conn=myapp.GetOpenConnection(); ISession session=Sessions.OpenSession(conn); //do some Data access work
應用程序必須小心,不能在同一個連接上打開兩個並行的ISession
NHibernate提供ADO.NET連接
另一種方法就是,你可以讓ISessionFactory替你打開連接,SessionFactory必須事先知道ADO.NET連接的參數,有幾種不同的方法設置參數:
1.通過提供一個IDictionary實例給Configuration.Properties.
2.在名為nhibernate的System.Configuration.NameValueSectionHandler類型的配置節點中添加屬性。
3.在hibernate.cfg.xml中包含<property>元素。
如果你使用這種方法,打開一個ISession是非常簡單的:
ISession session = sessions.OpenSession(); // open a new Session // do some data access work, an ADO connection will be used on demand
所有的NHibernate屬性名和約束都在NHibernate.Cfg.Environment類中定義。ADO.NET連接配置最重要的幾項設置:
假若你設置了如下的屬性,NHibernate會使用ADO.NET Data Provider來得到連接:
屬性名 |
用途 |
hibernate.connection.provider_class |
定制IConnectionProvider的類型. 例如:full.classname.of.ConnectionProvider (如果提供者創建在NHibernate中), 或者 full.classname.of.ConnectionProvider, assembly (如果使用一個自定義的IConnectionProvider接口的實現,它不屬於NHibernate)。 |
hibernate.connection.driver_class |
定制IDriver的類型. full.classname.of.Driver (如果驅動類創建在NHibernate中), 或者 full.classname.of.Driver, assembly (如果使用一個自定義IDriver接口的實現,它不屬於NHibernate)。 |
hibernate.connection.connection_string |
用來獲得連接的連接字符串. |
hibernate.connection.isolation |
設置事務隔離級別. 請檢查 System.Data.IsolationLevel 來得到取值的具體意義並且查看數據庫文檔以確保級別是被支持的。 例如: Chaos, ReadCommitted, ReadUncommitted, RepeatableRead, Serializable, Unspecified |
一個例子
1 <?xml version="1.0" encoding="utf-8" ?> 2 <configuration> 3 <configSections> 4 <section name="nhibernate" type="System.Configuration.NameValueSectionHandler, System, 5 Version=1.0.5000.0,Culture=neutral, PublicKeyToken=b77a5c561934e089" /> 6 <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler,log4net" /> 7 </configSections> 8 9 <nhibernate> 10 <add 11 key="hibernate.connection.provider" 12 value="NHibernate.Connection.DriverConnectionProvider" 13 /> 14 <add 15 key="hibernate.connection.driver_class" 16 value="NHibernate.Driver.SqlClientDriver" 17 /> 18 <add 19 key="hibernate.connection.connection_string" 20 value="Server=127.0.0.1;Initial Catalog=thedatabase;Integrated Security=SSPI" 21 /> 22 <add 23 key="hibernate.connection.isolation" 24 value="ReadCommitted" 25 /> 26 <add 27 key="hibernate.dialect" 28 value="NHibernate.Dialect.MsSql2000Dialect" 29 /> 30 31 </nhibernate> 32 33 <!-- log4net (required by NHibernate) and other app specific config follows --> 34 </configuration>
可選的配置屬性
下面是一些在運行時可以改變NHibernate欣慰的其他配置。所有這些都是可選的,也有默認值。
屬性名 |
用途 |
hibernate.dialect |
NHibernate方言(Dialect)的類名 - 可以讓NHibernate使用某些特定的數據庫平台的特性 例如: full.classname.of.Dialect(如果方言創建在NHibernate中), 或者full.classname.of.Dialect, assembly (如果使用一個自定義的方言的實現,它不屬於NHibernate)。 |
hibernate.default_schema |
在生成的SQL中,scheml/tablespace的全限定名. 例如: SCHEMA_NAME |
hibernate.prepare_sql |
是否准備sql語句 例如: true | false |
hibernate.session_factory_name |
SessionFactory被創建后將自動綁定這個名稱. 例如: some.name |
hibernate.use_outer_join |
允許使用外連接抓取。 例如:true | false |
hibernate.cache.provider_class |
指定一個自定義的CacheProvider緩存提供者的類名 例如: full.classname.of.CacheProvider(如果ICacheProvider創建在NHibernate中), 或full.classname.of.CacheProvider, assembly(如果使用一個自定義的ICacheProvider,它不屬於NHibernate)。 |
hibernate.query.substitutions |
把NHibernate查詢中的一些短語替換為SQL短語(比如說短語可能是函數或者字符)。 例如: hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC |
SQL方言(SQL Dialects)
你總是可以為你的數據庫設置一個hibernate.dialect方言,它是NHibernate.Dialect.Dialect的一個子類。如果你不需要使用基於native或者sequence的主鍵自動生成算法,或者悲觀鎖定(使用ISession.Lock()或者IQuery.SetLockMode())的話,方言就可以不必指定。然而,假若你指定了一個方言,Hibernate會為上面列出的一些屬性使用特殊默認值,省的你手工指定他們。
RDBMS |
方言 |
DB2 |
NHibernate.Dialect.DB2Dialect |
PostgreSQL |
NHibernate.Dialect.PostgreSQLDialect |
MySQL |
NHibernate.Dialect.MySQLDialect |
Oracle (any version) |
NHibernate.Dialect.OracleDialect |
Oracle 9/10g |
NHibernate.Dialect.Oracle9Dialect |
Sybase |
NHibernate.Dialect.SybaseDialect |
Microsoft SQL Server 2000 |
NHibernate.Dialect.MsSql2000Dialect |
Microsoft SQL Server 7 |
NHibernate.Dialect.MsSql7Dialect |
Firebird |
NHibernate.Dialect.FirebirdDialect |
外連接抓取(Outer Join Fetching)
如果你的數據庫支持ANSI或者Oracle風格的外連接,外連接抓取可能提高性能,因為可以限制和數據庫交互的數量(代價是數據庫自身進行了更多的工作)。外連接抓取允許你在一個SELECT語句中就可以得到一個由多對一或者一對一連接構成的對象圖。
默認情況下,抓取在葉對象,擁有代理的對象或者產生對自身的應用時終止。
對一個特定關聯來說,通過在XML映射文件中設置outer-join屬性可以控制是否開啟抓取功能。
設置hibernate.use_outer_join為false將禁用全局的外連接抓取,設置為true將啟用所有一對一(one-to-one)和多對一(many to one)關聯中的外連接抓取默認情況下,它被設置為auto,即自動外連接。但是,一對多關聯和集合永遠不會使用外連接抓取,除非對每個特定的管理進行明確聲明。這一行為可以在運行時通過NHibernate查詢重載。
自定義CacheProvider
通過實現NHibernate.Cache.ICacheProvider接口,你可以整合一個第二級緩存進來。你可以通過hibernate.cache.provider_class選擇某個自定義的實現。
查詢語言替換
你可以使用hibernate.query.substitutions定義新的NHibernate查詢短語。比如說:
hibernate.query.substitutions true=1, false=0
會在生成的SQL中把短語true和 false替換成整數值。
hibernate.query.substitutions toLowercase=LOWER
這可以讓你重新命名SQL的LOWER 函數。
Logging
通過Apache log4net,NHibernate記錄很多事件。
你可以從 http://logging.apache.org/log4net/下載 log4net. 要使用log4net,你要在app.config或者web.config中配置log4net節點.在src/NHibernate.Test工程中有一個配置的例子.
我們強烈建議你熟悉NHibernate's的log信息。NHibernate's的很多工作都會盡量詳細的留下log,也沒有讓它變的難以閱讀。這是用來解決問題的最基本的設施。
總結
ISessionFactory的配置內容很多,也很難記,你可以通過如下方式實現配置信息的智能提示,新建一個解決方案文件夾,將下面兩個文件拷入解決方案文件夾,可實現智能提示。
本文來自
《NHibernate中文文檔》