3.4. 可选的配置属性 - Hibernate reference 3.2.0 ga 正式版中文参考手册

3.4. 可选的配置属性

有大量属性能用来控制Hibernate在运行期的行为. 它们都是可选的, 并拥有适当的默认值.

警告: 其中一些属性是"系统级(system-level)的". 系统级属性只能通过java -Dproperty=value或 hibernate.properties来设置, 而不能用上面描述的其他方法来设置.

表 3.3. Hibernate配置属性

属性名	用途
`hibernate.dialect`	一个Hibernate `Dialect`类名允许Hibernate针对特定的关系数据库生成优化的SQL. 取值 `full.classname.of.Dialect`
`hibernate.show_sql`	输出所有SQL语句到控制台. 有一个另外的选择是把`org.hibernate.SQL`这个log category设为`debug`。 eg. `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`

表 3.4. Hibernate JDBC和连接(connection)属性

属性名	用途
`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`. eg. `true` \| `false`
`hibernate.jdbc.factory_class`	选择一个自定义的`Batcher`. 多数应用程序不需要这个配置属性. eg. `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`的连接释放模式。请参阅第 2.5 节 “上下文相关的（Contextual）Session”。
`hibernate.connection.<propertyName>`	将JDBC属性`propertyName`传递到`DriverManager.getConnection()`中去.
`hibernate.jndi.<propertyName>`	将属性`propertyName`传递到JNDI `InitialContextFactory`中去.

表 3.5. Hibernate缓存属性

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

表 3.6. Hibernate事务属性

属性名	用途
`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上下文管理。请参见第 2.5 节 “上下文相关的（Contextual）Session”。取值 `true` \| `false`
`hibernate.transaction.auto_close_session`	如果开启, session在事务完成后将被自动关闭。现在更好的方法是使用自动session上下文管理。请参见第 2.5 节 “上下文相关的（Contextual）Session”。取值 `true` \| `false`

表 3.7. 其他属性

属性名	用途
`hibernate.current_session_context_class`	为"当前" `Session`指定一个(自定义的)策略。关于内置策略的详情，请参见第 2.5 节 “上下文相关的（Contextual）Session” 。 eg. `jta` \| `thread` \| `managed` \| `custom.Class`
`hibernate.query.factory_class`	选择HQL解析器的实现. 取值 `org.hibernate.hql.ast.ASTQueryTranslatorFactory` or `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`

3.4.1. SQL方言

你应当总是为你的数据库将hibernate.dialect属性设置成正确的 org.hibernate.dialect.Dialect子类. 如果你指定一种方言, Hibernate将为上面列出的一些属性使用合理的默认值, 为你省去了手工指定它们的功夫.

表 3.8. Hibernate SQL方言 (hibernate.dialect)

RDBMS	方言
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`

3.4.2. 外连接抓取(Outer Join Fetching)

如果你的数据库支持ANSI, Oracle或Sybase风格的外连接, 外连接抓取通常能通过限制往返数据库次数 (更多的工作交由数据库自己来完成)来提高效率. 外连接抓取允许在单个SELECTSQL语句中，通过many-to-one, one-to-many, many-to-many和one-to-one关联获取连接对象的整个对象图.

将hibernate.max_fetch_depth设为0能在全局范围内禁止外连接抓取. 设为1或更高值能启用one-to-one和many-to-oneouter关联的外连接抓取, 它们通过 fetch="join"来映射.

参见第 19.1 节 “ 抓取策略(Fetching strategies) ”获得更多信息.

3.4.3. 二进制流 (Binary Streams)

Oracle限制那些通过JDBC驱动传输的字节数组的数目. 如果你希望使用二进值 (binary)或 可序列化的 (serializable)类型的大对象, 你应该开启 hibernate.jdbc.use_streams_for_binary属性. 这是系统级属性.

3.4.4. 二级缓存与查询缓存

以hibernate.cache为前缀的属性允许你在Hibernate中，使用进程或群集范围内的二级缓存系统. 参见第 19.2 节 “二级缓存（The Second Level Cache） ”获取更多的详情.

3.4.5. 查询语言中的替换

你可以使用hibernate.query.substitutions在Hibernate中定义新的查询符号. 例如:

hibernate.query.substitutions true=1, false=0

将导致符号true和false在生成的SQL中被翻译成整数常量.

hibernate.query.substitutions toLowercase=LOWER

将允许你重命名SQL中的LOWER函数.

3.4.6. Hibernate的统计(statistics)机制

如果你开启hibernate.generate_statistics, 那么当你通过 SessionFactory.getStatistics()调整正在运行的系统时，Hibernate将导出大量有用的数据. Hibernate甚至能被配置成通过JMX导出这些统计信息. 参考org.hibernate.stats中接口的Javadoc，以获得更多信息.