Hibernate4之配置详解

[size=medium]
Hibernate基本配置其实就是SessionFactory的配置，所有配置都在<session-factory/>标签之内。但是<session-factory/>标签又可以分成3个部分的配置：
[color=red]
1.JDBC连接参数的基本配置
2.Hibernate连接池的参数配置
3.注册ORM映射文件的配置
[/color]

[color=darkblue]Hibernate4和Hibernate3在配置上的一些区别：[/color]
[b]连接池c3p0的配置[/b]
由于Hibernate自己实现的连接池不太好，在项目中，建议使用工业级的连接池，比如：c3p0，Hibernate发行包中带有c3p0的专用jar包hibernate-c3p0-4.1.4.Final.jar，在以前的Hibernate3.X版本中是直接在核心jar包里面的，在4.X版本之后包名做出来调整，大家使用的时候需要注意了。


[b]TransactionFactory有三个标准(内建)的选择：[/b]
1：委托给数据库(JDBC)事务（默认）
Hibernate3:org.hibernate.transaction.JDBCTransactionFactory
Hibernate4:org.hibernate.engine.transaction.internal.jdbc.JDBCTransactionFactory

2：JTA事务，如果在上下文环境中存在运行着的事务(如, EJB会话Bean的方法), 则委托给容器管 理的事务, 否则，将启动一个新的事务，并使用Bean管理的事务.
Hibernate3: org.hibernate.transaction.JTATransactionFactory
Hibernate4: org.hibernate.engine.transaction.internal.jta.JTATransactionFactory

3：委托给容器管理的JTA事务
Hibernate3: org.hibernate.transaction.CMTTransactionFactory
Hibernate4:org.hibernate.engine.transaction.internal.jta.CMTTransactionFactory
也可以定义属于你自己的事务策略 (如, 针对CORBA的事务服务)
[/size]

[size=medium][b][align=center]Hibernate4连接池C3P0基本配置[/align][/b][/size]

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-configuration PUBLIC
          "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
          "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>

<session-factory>
	<property name="connection.url">jdbc:oracle:thin:@127.0.0.1:1521:orcl</property>
	<property name="connection.username">username</property>
	<property name="connection.password">password</property>
	<!-- 数据库JDBC驱动类名 -->
	<property name="connection.driver_class">oracle.jdbc.driver.OracleDriver</property>
	<!-- 数据库方言 -->
	<property name="dialect">org.hibernate.dialect.Oracle10gDialect</property>
	<!-- ddl语句自动建表 -->
	<property name="hbm2ddl.auto">none</property>
	<property name="show_sql">true</property>
	<property name="format_sql">true</property>

	<!-- 连接池配置 -->
	<property name="hibernate.connection.provider_class">
		org.hibernate.service.jdbc.connections.internal.C3P0ConnectionProvider
	</property>
	<!-- 连接池中JDBC连接的最小数量。Hibernate默认为1 -->
	<property name="hibernate.c3p0.min_size">5</property>
	<!-- 连接池中JDBC连接的最大数量。Hibernate默认为100 -->
	<property name="hibernate.c3p0.max_size">20</property>
	<!-- 何时从连接池中移除一个空闲的连接（以秒为单位）时。Hibernate默认为0，永不过期 -->
	<property name="hibernate.c3p0.timeout">300</property>
	<!-- 被缓存的预编译语句数量。用来提高性能。Hibernate默认为0，缓存不可用-->
	<property name="hibernate.c3p0.max_statements">100</property>
	<!-- 一个连接被自动验证前的闲置时间（以秒为单位）。Hibernate默认为0 -->
	<property name="hibernate.c3p0.idle_test_period">3000</property>

	<!-- 注册ORM映射文件 -->
	<mapping class="com....." />

</session-factory>
</hibernate-configuration>

[color=blue][size=medium][b]Hibernate配置属性[/b][/size][/color]
[table]
|[b]属性名[/b]|[b]用途[/b]|[b]取值[/b]|
|hibernate.dialect|一个Hibernate Dialect类名允许Hibernate针对特定的关系数据库生成优化的SQL|full.classname.of.Dialect|

|hibernate.show_sql|输出所有SQL语句到控制台. 有一个另外的选择是把org.hibernate.SQL这个log category设为debug|true & false |

|hibernate.format_sql|在log和console中打印出更漂亮的SQL|true & false |

|hibernate.default_schema|在生成的SQL中, 将给定的schema/tablespace附加于非全限定名的表名上.|SCHEMA_NAME |

|hibernate.default_catalog|在生成的SQL中, 将给定的catalog附加于非全限定名的表名上.|CATALOG_NAME |

|hibernate.session_factory_name|SessionFactory创建后，将自动使用这个名字绑定到JNDI中.|jndi/composite/name |

|hibernate.max_fetch_depth|为单向关联(一对一, 多对一)的外连接抓取（outer join fetch）树设置最大深度. 值为0意味着将关闭默认的外连接抓取.|建议在0到3之间取值 |

|hibernate.default_batch_fetch_size|为Hibernate关联的批量抓取设置默认数量. |建议的取值为4, 8, 和16 |

|hibernate.default_entity_mode|为由这个SessionFactory打开的所有Session指定默认的实体表现模式. |dynamic-map, dom4j, pojo |

|hibernate.order_updates|强制Hibernate按照被更新数据的主键，为SQL更新排序。这么做将减少在高并发系统中事务的死锁。 |true & false |

|hibernate.generate_statistics|如果开启, Hibernate将收集有助于性能调节的统计数据.|true & false |

|hibernate.use_identifer_rollback|如果开启, 在对象被删除时生成的标识属性将被重设为默认值. |true & false |

|hibernate.use_sql_comments|如果开启, Hibernate将在SQL中生成有助于调试的注释信息, 默认值为false. |true & false|

[/table]

[color=blue][size=medium][b]JDBC和连接(connection)属性[/b][/size][/color]

[table]
|[b]属性名[/b]|[b]用途[/b]|[b]取值[/b]|
|hibernate.jdbc.fetch_size|非零值，指定JDBC抓取数量的大小 (调用Statement.setFetchSize()).
hibernate.jdbc.batch_size 非零值，允许Hibernate使用JDBC2的批量更新.|建议取5到30之间的值|
|hibernate.jdbc.batch_versioned_data|如果你想让你的JDBC驱动从executeBatch()返回正确的行计数 , 那么将此属性设为true(开启这个选项通常是安全的). 同时，Hibernate将为自动版本化的数据使用批量DML. 默认值为false.|true & false|
|hibernate.jdbc.factory_class|选择一个自定义的Batcher.多数应用程序不需要这个配置属性.|classname.of.Batcher|
|hibernate.jdbc.use_scrollable_resultset|允许Hibernate使用JDBC2的可滚动结果集. 只有在使用用户提供的JDBC连接时，这个选项才是必要的, 否则Hibernate会使用连接的元数据.|true & false|
|hibernate.jdbc.use_streams_for_binary|在JDBC读写binary (二进制)或serializable (可序列化) 的类型时使用流(stream)(系统级属性).|true & false|
|hibernate.jdbc.use_get_generated_keys|在数据插入数据库之后，允许使用JDBC3 PreparedStatement.getGeneratedKeys() 来获取数据库生成的key(键)。需要JDBC3+驱动和JRE1.4+, 如果你的数据库驱动在使用Hibernate的标 识生成器时遇到问题，请将此值设为false. 默认情况下将使用连接的元数据来判定驱动的能力.|true & false |
|hibernate.connection.provider_class|自定义ConnectionProvider的类名, 此类用来向Hibernate提供JDBC连接.|classname.of.ConnectionProvider|
|hibernate.connection.isolation|设置JDBC事务隔离级别. 查看java.sql.Connection来了解各个值的具体意义, 但请注意多数数据库都不支持所有的隔离级别. |1, 2, 4, 8|
|hibernate.connection.autocommit|允许被缓存的JDBC连接开启自动提交(autocommit) (不建议).|true & false|
|hibernate.connection.release_mode|指定Hibernate在何时释放JDBC连接. 默认情况下,直到Session被显式关闭或被断开连接时,才会释放JDBC连接. 对于应用程序服务器的JTA数据源, 你应当使用after_statement, 这样在每次JDBC调用后，都会主动的释放连接. 对于非JTA的连接, 使用after_transaction在每个事务结束时释放连接是合理的. auto将为JTA和CMT事务策略选择after_statement, 为JDBC事务策略选择after_transaction. |auto (默认) & on_close & after_transaction & after_statement （这些设置仅对通过SessionFactory.openSession得到的Session起作用。对于通过SessionFactory.getCurrentSession得到的Session，所配置的CurrentSessionContext实现控制这些Session的连接释放模式|
|hibernate.connection.<propertyName>|将JDBC属性propertyName传递到DriverManager.getConnection()中去.| |
|hibernate.jndi.<propertyName>|将属性propertyName传递到JNDI InitialContextFactory中去.| |
[/table]


[color=blue][size=medium][b]Hibernate缓存属性[/b][/size][/color]

[table]
|[b]属性名[/b]|[b]用途[/b]|[b]取值[/b]|
|hibernate.cache.provider_class|自定义的CacheProvider的类名.|classname.of.CacheProvider|
|hibernate.cache.use_minimal_puts|以频繁的读操作为代价, 优化二级缓存来最小化写操作. 在Hibernate3中，这个设置对的集群缓存非常有用, 对集群缓存的实现而言，默认是开启的.|true & false|
|hibernate.cache.use_query_cache|允许查询缓存, 个别查询仍然需要被设置为可缓存的. | true & false |
|hibernate.cache.use_second_level_cache|能用来完全禁止使用二级缓存. 对那些在类的映射定义中指定<cache>的类，会默认开启二级缓存. |true & false |
|hibernate.cache.query_cache_factory|自定义实现QueryCache接口的类名, 默认为内建的StandardQueryCache.|classname.of.QueryCache|
|hibernate.cache.region_prefix|二级缓存区域名的前缀.|prefix|
|hibernate.cache.use_structured_entries|强制Hibernate以更人性化的格式将数据存入二级缓存.|true & false|
[/table]

[color=blue][size=medium][b]Hibernate事务属性[/b][/size][/color]

[table]
|[b]属性名[/b]|[b]用途[/b]|[b]取值[/b]|
|hibernate.transaction.factory_class|一个TransactionFactory的类名, 用于Hibernate Transaction API (默认为JDBCTransactionFactory).|classname.of.TransactionFactory|
|jta.UserTransaction|一个JNDI名字，被JTATransactionFactory用来从应用服务器获取JTA UserTransaction.|jndi/composite/name|
|hibernate.transaction.manager_lookup_class|一个TransactionManagerLookup的类名 - 当使用JVM级缓存，或在JTA环境中使用hilo生成器的时候需要该类.|classname.of.TransactionManagerLookup|
|hibernate.transaction.flush_before_completion|如果开启, session在事务完成后将被自动清洗(flush)。 现在更好的方法是使用自动session上下文管理|true & false |
|hibernate.transaction.auto_close_session|如果开启, session在事务完成后将被自动关闭|true & false|
[/table]

[color=blue][size=medium][b]其他属性[/b][/size][/color]

[table]
|[b]属性名[/b]|[b]用途[/b]|[b]取值[/b]|
|hibernate.current_session_context_class|为"当前" Session指定一个(自定义的)策略|jta & thread & managed & custom.Class|
|hibernate.query.factory_class|选择HQL解析器的实现.|org.hibernate.hql.ast.ASTQueryTranslatorFactory 和org.hibernate.hql.classic.ClassicQueryTranslatorFactory|
|hibernate.query.substitutions|将Hibernate查询中的符号映射到SQL查询中的符号 (符号可能是函数名或常量名字).|hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC|
|hibernate.hbm2ddl.auto|在SessionFactory创建时，自动检查数据库结构，或者将数据库schema的DDL导出到数据库. 使用 create-drop时,在显式关闭SessionFactory时，将drop掉数据库schema.|validate & update & create & create-drop|
|hibernate.cglib.use_reflection_optimizer|开启CGLIB来替代运行时反射机制(系统级属性). 反射机制有时在除错时比较有用. 注意即使关闭这个优化, Hibernate还是需要CGLIB. 你不能在hibernate.cfg.xml中设置此属性.|true & false|
[/table]


[color=blue][size=medium][b]SQL方言[/b][/size][/color]

[table]
|[b]RDBMS[/b]|[b]方言[/b]|
|DB2 |org.hibernate.dialect.DB2Dialect|
|DB2 AS/400 |org.hibernate.dialect.DB2400Dialect|
|DB2 OS390 |org.hibernate.dialect.DB2390Dialect|
|PostgreSQL |org.hibernate.dialect.PostgreSQLDialect|
|MySQL |org.hibernate.dialect.MySQLDialect|
|MySQL with InnoDB |org.hibernate.dialect.MySQLInnoDBDialect|
|MySQL with MyISAM |org.hibernate.dialect.MySQLMyISAMDialect|
|Oracle (any version) |org.hibernate.dialect.OracleDialect|
|Oracle 9i/10g |org.hibernate.dialect.Oracle9Dialect|
|Sybase |org.hibernate.dialect.SybaseDialect|
|Sybase Anywhere |org.hibernate.dialect.SybaseAnywhereDialect|
|Microsoft SQL Server |org.hibernate.dialect.SQLServerDialect|
|SAP DB |org.hibernate.dialect.SAPDBDialect|
|Informix |org.hibernate.dialect.InformixDialect|
|HypersonicSQL |org.hibernate.dialect.HSQLDialect|
|Ingres |org.hibernate.dialect.IngresDialect|
|Progress |org.hibernate.dialect.ProgressDialect|
|Mckoi |SQL org.hibernate.dialect.MckoiDialect|
|Interbase |org.hibernate.dialect.InterbaseDialect|
|Pointbase |org.hibernate.dialect.PointbaseDialect|
|FrontBase |org.hibernate.dialect.FrontbaseDialect|
|Firebird |org.hibernate.dialect.FirebirdDialect|
[/table]