首页 > 代码库 > NHibernate应用三：对象及配置
NHibernate应用三：对象及配置
经过上一节的介绍，对整个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 |
|
NHibernate应用三：对象及配置