经过上一节的介绍,对整个NHibernate有了初步的了解,本节主要是介绍整个NHibernate的对象体系和配置内容。
一、对象
A.ISessionFactory(NHibernate.ISessionFactory)
针对单个数据库映射关系经过编译后的内存镜像,是线程安全的(不可变)。 它是生成ISession的工厂,本身要用到IConnectionProvider。 该对象可以在进程或集群的级
别上,为那些事务之间可以重用的数据提供可选的二级缓存。
B.ISession(NHibernate.ISession)
表示应用程序与持久储存层之间交互操作的一个单线程对象,此对象生存期很短。 其隐藏了ADO.NET连接,也是 ITransaction的工厂。其会持有一个针对持久化对象的必
选(第一级)缓存, 在遍历对象图或者根据持久化标识查找对象时会用到。
C.持久的对象及其集合(Persistent Objects and Collections)
带有持久化状态的、具有业务功能的单线程对象,此对象生存期很短。 这些对象可能是普通的POCOs, 唯一特殊的是他们正与(仅仅一个)ISession相关联。一旦这个
ISession被关闭, 这些对象就会脱离持久化状态,这样就可被应用程序的任何层自由使用。(例如,用作跟表示层打交道的数据传输对象)
D.瞬态(transient)和脱管(detached)的对象及其集合
那些目前没有与ISession关联的持久化类实例。他们可能是在被应用程序实例化后, 尚未进行持久化的对象。 也可能是因为实例化他们的ISession已经被关闭而脱离持久化
的对象。
E.ITransaction(NHibernate.ITransaction)
(可选的)应用程序用来指定原子操作单元范围的对象,它是单线程的,生命周期很短。 它通过抽象将应用从底层具体的ADO.NET事务隔离开。 某些情况下,一个Session
之内可能包含多个ITransaction对象。
F.IConnectionProvider(NHibernate.Connection.IConnectionProvider)
(可选的)生成ADO.NET连接以及Command对象的工厂。 它通过抽象将应用从底层的IDbConnection或IDbCommand隔离开。 仅供开发者扩展/实现用,并不暴露给应
用程序使用。
G.IDriver(NHibernate.Driver.IDriver)
(可选的)一个封装了不同ADO.NET providers之间的差异(利用参数命名转换等ADO.NET支持的特性)的接口。
H.ITransactionFactory(NHibernate.Transaction.ITransactionFactory)
(可选的)生成ITransaction对象实例的工厂。仅供开发者扩展/实现用,并不暴露给应用程序使用。
二、配置
A.ADO.NET的配置
属性名 |
用途 |
connection.provider_class |
实现IConnectionProvider接口的类型。 例如: (如果是NHibernate内部的IConnectionProvider实现类)full.classname.of.ConnectionProvider, (如果是自定义的NHibernate外部的IConnectionProvider实现类 )full.classname.of.ConnectionProvider, assembly。 |
connection.driver_class |
如果使用DriverConnectionProvider,实现IDriver接口的类型。 (如果是NHibernate内部的实现的IDriver类型)full.classname.of.Driver (如果是自定义的NHibernate外部的IDriver实现类 )full.classname.of.Driver, assembly。 这个配置通常是不需要配置的,如果设置好了hibernate.dialect一般会自动选好对应的IDriver。 |
connection.connection_string |
数据库连接字符串 |
connection.connection_string_name |
数据库连接字符串名称(定义在.Net配置文件<connectionStrings>配置节里面的连接字符串名。 |
connection.isolation |
ADO.NET事务隔离级别, 查看System.Data.IsolationLevel类来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别。 例如: Chaos, ReadCommitted, ReadUncommitted, RepeatableRead, Serializable, Unspecified |
connection.release_mode |
指定ADO.NET何时释放数据库连接。 例如: auto (默认) | on_close | after_transaction 注意,这些设置仅对通过ISessionFactory.OpenSession得到的ISession起作用。 对于通过ISessionFactory.GetCurrentSession得到的ISession, 所配置的ICurrentSessionContext实现控制这些ISession的连接释放模式。 |
command_timeout |
指定NHibernate生成的IDbCommands对象的超时时间。 . |
adonet.batch_size |
指定用ADO.Net的批量更新的数量,默认设置为0(不启用该功能)。 |
proxyfactory.factory_class |
代理工厂配置。用于指定是哪个中间件提供的延迟加载代理 |
B.可选的配置
属性名 |
用途 |
dialect |
设置NHibernate的Dialect类名 - 允许NHibernate针对特定的关系数据库生成优化的SQL 可用值: full.classname.of.Dialect, assembly |
default_schema |
在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上。 可用值: SCHEMA_NAME |
use_outer_join |
允许外连接抓取,已弃用,请使用max_fetch_depth。 可用值: true | false |
max_fetch_depth |
为单向关联(一对一, 多对一)的外连接抓取(outer join fetch)树设置最大深度。 值为0意味着将关闭默认的外连接抓取 可用值:建议在0 到3之间取值。 |
use_reflection_optimizer |
开启运行时代码动态生成来替代运行时反射机制(系统级属性)。 使用这种方式的话程序在启动会耗费一定的性能,但是在程序运行期性能会有更好的提升。 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性。 这个属性不能在hibernate.cfg.xml或者是应用程序配置文件<hibernate-configuration> 配置节中设置。 可用值: true | false |
bytecode.provider |
指定字节码provider用于优化NHibernate反射性能。 null代表完全关闭性能优化, lcg用于轻量级的代码动态生成,codedom基于CodeDOM代码动态生成。 可用值: null | lcg | codedom |
cache.provider_class |
设置缓存实现类(实现ICacheProvider接口的类) 可用值: classname.of.CacheProvider, assembly |
cache.use_minimal_puts |
以频繁的读操作为代价, 优化二级缓存来最小化写操作(对群集缓存有效)。 可用值: true | false |
cache.use_query_cache |
允许查询缓存, 个别查询仍然需要被设置为可缓存的. 可用值: true | false |
cache.query_cache_factory |
自定义实现IQueryCacheFactory接口的类名, 默认为内建的StandardQueryCacheFactory。 可用值: classname.of.QueryCacheFactory, assembly |
cache.region_prefix |
二级缓存区域名的前缀。 可用值: prefix |
query.substitutions |
将NHibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字)。 可用值: hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC query.substitutions true=1, false=0 将导致符号true和false在生成的SQL中被翻译成整数常量 |
show_sql |
输出所有SQL语句到控制台. 可用值: true | false |
hbm2ddl.auto |
在ISessionFactory创建时,自动检查数据库结构,或者将数据库schema的DDL导出到数据库。 使用 create-drop时,在显式关闭ISessionFactory时,将drop掉数据库schema。 可用值: create | create-drop |
use_proxy_validator |
是否启用验证接口或者是类是否可以使用代理,默认开启。 (检查实体类的属性或者是方法是否被设置为Virtual) 可用值: true | false |
transaction.factory_class |
自定义ITransactionFactory的实现,默认为NHibernate内建的AdoNetTransactionFactory。 可用值: classname.of.TransactionFactory, assembly |
C.SQL方言的配置
关系型数据库 |
方言 |
备注 |
DB2 |
NHibernate.Dialect.DB2Dialect |
|
DB2 for iSeries (OS/400) |
NHibernate.Dialect.DB2400Dialect |
|
Ingres |
NHibernate.Dialect.IngresDialect |
|
PostgreSQL |
NHibernate.Dialect.PostgreSQLDialect |
|
PostgreSQL 8.1 |
NHibernate.Dialect.PostgreSQL81Dialect |
方言在PostgreSQL8.1中现在支持FOR UPDATE NOWAIT了。 |
PostgreSQL 8.2 |
NHibernate.Dialect.PostgreSQL82Dialect |
方言在PostgreSQL8.2中现在支持在 DROP TABLE和DROP SEQUENCE中使用IF EXISTS关键字了。 |
MySQL 3 or 4 |
NHibernate.Dialect.MySQLDialect |
|
MySQL 5 |
NHibernate.Dialect.MySQL5Dialect |
|
Oracle 8g |
NHibernate.Dialect.Oracle8iDialect |
|
Oracle 9g |
NHibernate.Dialect.Oracle9Dialect |
|
Oracle 10/11g |
NHibernate.Dialect.Oracle10gDialect |
|
Sybase Adaptive Server Enterprise |
NHibernate.Dialect.SybaseDialect |
|
Sybase Adaptive Server Anywhere |
NHibernate.Dialect.SybaseAnywhereDialect |
|
Microsoft SQL Server 2000 |
NHibernate.Dialect.MsSql2000Dialect |
|
Microsoft SQL Server 2005 |
NHibernate.Dialect.MsSql2005Dialect |
|
Microsoft SQL Server 2008 |
NHibernate.Dialect.MsSql2008Dialect |
|
Microsoft SQL Server 2005 Everywhere Edition |
NHibernate.Dialect.MsSqlCeDialect |
|
Microsoft SQL Server 7 |
NHibernate.Dialect.MsSql7Dialect |
|
Firebird |
NHibernate.Dialect.FirebirdDialect |
把driver_class设置为 NHibernate.Driver.FirebirdClientDriver启用Firebird provider for .NET 2.0。 |
SQLite |
NHibernate.Dialect.SQLiteDialect |
把driver_class设置为NHibernate.Driver.SQLite20Driver启用System.Data.SQLite provider for .NET 2.0。 |
Ingres 3.0 |
NHibernate.Dialect.IngresDialect |
|