首页 > 代码库 > [NHibernate]ISessionFactory配置

[NHibernate]ISessionFactory配置

系列文章

[Nhibernate]体系结构

引言

在上篇文章学习了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中文文档》