NHibernate之配置文件属性说明

一、NHibernate配置所支持的属性

属性名用途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

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

 

二、dialect属性支持的方言选项值

关系型数据库方言备注DB2NHibernate.Dialect.DB2Dialect DB2 for iSeries (OS/400)NHibernate.Dialect.DB2400Dialect IngresNHibernate.Dialect.IngresDialect PostgreSQLNHibernate.Dialect.PostgreSQLDialect PostgreSQL 8.1NHibernate.Dialect.PostgreSQL81Dialect方言在PostgreSQL8.1中现在支持FOR UPDATE NOWAIT了。PostgreSQL 8.2NHibernate.Dialect.PostgreSQL82Dialect方言在PostgreSQL8.2中现在支持在 DROP TABLE和DROP SEQUENCE中使用IF EXISTS关键字了。MySQL 3 or 4NHibernate.Dialect.MySQLDialect MySQL 5NHibernate.Dialect.MySQL5Dialect Oracle (any version)NHibernate.Dialect.OracleDialect Oracle 9/10gNHibernate.Dialect.Oracle9Dialect Sybase Adaptive Server EnterpriseNHibernate.Dialect.SybaseDialect Sybase Adaptive Server AnywhereNHibernate.Dialect.SybaseAnywhereDialect Microsoft SQL Server 2000NHibernate.Dialect.MsSql2000Dialect Microsoft SQL Server 2005NHibernate.Dialect.MsSql2005Dialect Microsoft SQL Server 2005 Everywhere EditionNHibernate.Dialect.MsSqlCeDialect Microsoft SQL Server 7NHibernate.Dialect.MsSql7Dialect FirebirdNHibernate.Dialect.FirebirdDialect把driver_class设置为 NHibernate.Driver.FirebirdClientDriver启用Firebird provider for .NET 2.0。SQLiteNHibernate.Dialect.SQLiteDialect把driver_class设置为NHibernate.Driver.SQLite20Driver启用System.Data.SQLite provider for .NET 2.0。Ingres 3.0NHibernate.Dialect.IngresDialect 

三、NHibernate提供的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。 详细的dialect与IDriver的默认对应关系可以查看API文档。

connection.connection_string数据库连接字符串connection.connection_string_name数据库连接字符串名称(定义在.Net配置文件<connectionStrings>配置节里面的连接字符串名。connection.isolationADO.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（不启用该功能）。