[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中文文档》

[NHibernate]ISessionFactory配置,码迷,mamicode.com

时间: 04-27

[NHibernate]ISessionFactory配置的相关文章

NHibernate 基本配置 (第一篇)

使用NHibernate最重要的一步就是配置,如果连NHibernate都还没有跑的起来,谈何学习.今天就来详解一下NHibernate的配置. 一.NHibernate基本配置 NHibernate配置要注意的有: 1.NHibernate需要一个自定义的配置节点,一般放在Web.config里或App.config里面,当然你可以自己定义实际位置. 示例如下: <?xml version="1.0" encoding="utf-8" ?> <c

NHibernate之配置文件属性说明

一.NHibernate配置所支持的属性 属性名 用途 dialect 设置NHibernate的Dialect类名 - 允许NHibernate针对特定的关系数据库生成优化的SQL 可用值: full.classname.of.Dialect, assembly default_schema 在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上. 可用值: SCHEMA_NAME use_outer_join 允许外连接抓取,已弃用,请使用max_fetch_

Fluent Nhibernate 数据库配置

一.Access数据库配置 NHibernate本身不支持Access数据库,一开始看网上各种文档,捣敲浪费了N分钟.还是祭起Nuget神器引用NHibernate.JetDrive.代码如下,搞定收工... private string FilePath { get; set; } private ISessionFactory BuildSessionFactory() { var connectionString = string.Format("Provider=Microsoft.Je

log4net NHibernate日志配置

1. 通过Nuget引用log4net 2. 在程序开始的执行的地方(一般是在Global.asax文件中)加入下面log4net配置语句 protected void Application_Start() { log4net.Config.XmlConfigurator.Configure(); } 3. 在web.config 中configuration 节点中 加入如下配置 <configuration> <configSections> <section name

[NHibernate]存储过程的使用(三)

目录 写在前面 文档与系列文章 查询 总结 写在前面 前面的文章介绍了在nhibernate中使用存储过程进行增删改的操作,当然查询也是可以的,在nhibernate中也可以执行任意的存储过程.本篇文章将介绍如何使用查询的存储过程的方式. 文档与系列文章 [Nhibernate]体系结构 [NHibernate]ISessionFactory配置 [NHibernate]持久化类(Persistent Classes) [NHibernate]O/R Mapping基础 [NHibernate]

[NHibernate]立即加载

目录 写在前面 文档与系列文章 立即加载 一个例子 总结 写在前面 上篇文章介绍了nhibernate延迟加载的相关内容,简单回顾一下延迟加载,就是需要的时候再去加载,需要的时候再向数据库发出sql指令进行查询. 本篇文章介绍的立即加载,则和延迟加载相对,举个简单的例子,就是查询客户信息,则会将该客户相关联的数据立即进行加载.实现立即加载的方式有三种:设置映射文件中节点的可选属性lazy,Nhibernate提供的实用类,HQL抓取策略. 文档与系列文章 [Nhibernate]体系结构 [NH

[NHibernate]延迟加载

目录 写在前面 文档与系列文章 延迟加载 一个例子 总结 写在前面 上篇文章介绍了多对多关系的关联查询的sql,HQL,Criteria查询的三种方式.本篇文章将介绍nhibernate中的延迟加载方式,延迟加载按个人理解也可以叫做按需要加载(Loading-on-demand). 文档与系列文章 [Nhibernate]体系结构 [NHibernate]ISessionFactory配置 [NHibernate]持久化类(Persistent Classes) [NHibernate]O/R

[NHibernate]增删改操作

目录 写在前面 文档与系列文章 添加数据 删除数据 修改数据 添加修改数据 总结 写在前面 上篇文章介绍了nhibernate的基于面向对象的条件查询.对一个项目来说,增删改查是必不可少的,虽然实现方式不同,但是总有涉及到这部分的代码.之前跟朋友说过一个笑话,你要会增删改查了,一切问题就不是问题了,在加上业务处理基本上就完成一个项目了.可能说的是有点过了,但是我觉得在编码中,重要的是你的业务处理能力,在公司很少人能能站在项目框架或者架构的决策的位置,这个时候,作为开发来说不就是负责模块吗?而这些

[NHibernate]持久化类(Persistent Classes)

系列文章 [Nhibernate]体系结构 [NHibernate]ISessionFactory配置 引言 持久化类是应用程序用来解决商业问题的类(比如,在电子交易程序中的Customer和Order).持久化类,就如同它的名字暗示的,是短暂存在的,它的实例会被持久性保存于数据库中. 如果这些类符合简单的规则,NHibernate能够工作的最好,这些规则就是Plain Old CLR Object(POCO,简单传统CLR对象)编程模型. POCO简单示例 用一个类描述一只猫: 1 publi