HIbernate的配置文件详解
1.Hibernate配置
1.1. 可编程的配置方式
一个org.hibernate.cfg.Configuration 实例代表了一个应用程序中Java类型到SQL数据库映射的完整集合。Configuration被用来构建一个 SessionFactory. 映射定义则由不同的XML映射定义文件编译而来。
可以直接实例化Configuration来获取一个实例，并为它指定XML映射定义文件.如果映射定义文件在类路径(classpath)中，请使用addResource():
|
Configuration cfg = new Configuration() .configure() .addResource("Emp.hbm.xml") .addResource("Dept.hbm.xml");
|
一个替代方法(有时是更好的选择)是，指定被映射的类，让Hibernate帮你寻找映射定义文件:
|
Configurationcfg=newConfiguration() .addClass(com.morris.ssh.Emp.class) .addClass(com.morris.ssh.Dept.class); |
hibernate将会在类路径(classpath)中寻找名字为/com/morris/ssh/Emp.hbml.xml,和
/com/morris/ssh/Dept.hbml.xml映射定义文件.这种方式消除了任何对文件名的硬编码(hardcoded).
Configuration也允许你指定配置属性:
|
Configurationcfg=newConfiguration() .addClass(com.morris.ssh.Emp.class) .addClass(com.morris.ssh.Dept.class) .setProperty("hibernate.dialect","org.hibernate.dialect.MySQLInnoDBDialect") .setProperty("hibernate.connection.datasource","java:cornp/env/jdbc/test") .setProperty ("hibernate.order_updates",”true”
|
1.2. 与数据库的连接
HibernateJDBC属性
|
属性名 |
用途 |
|
hibernate.connection.driver_class |
jdbc驱动类 |
|
hibernate.connection.url |
jdbcURL |
|
hibernate.connection.username |
数据库用户名 |
|
hibernate.connection.password |
数据库密码 |
1.2.1.oracle连接配置
|
<property name="connection.driver_class">oracle.jdbc.driver.OracleDriver</property> <property name="connection.url">jdbc:oracle:thin:@localhost:1521:orcl</property> <property name="connection.username">scott</property> <property name="connection.password">tiger</property> |
1.2.2.mysql连接配置
|
hibernate.dialect org.hibernate.dialect.MySQLDialect hibernate.dialect org.hibernate.dialect.MySQLInnoDBDialect hibernate.dialect org.hibernate.dialect.MySQLMyISAMDialect hibernate.connection.driver_class com.mysql.jdbc.Driver hibernate.connection.url jdbc:mysql:///test hibernate.connection.username gavin hibernate.connection.password |
1.2.3.sql server连接配置
|
hibernate.dialect org.hibernate.dialect.SQLServerDialect hibernate.connection.username sa hibernate.connection.password sa |
1.2.4.连接池c3p0的配置
由于Hibernate自己实现的连接池不太好，在项目中，建议使用工业级的连接池，比如：c3p0，Hibernate发行包中带有c3p0。
|
hibernate.c3p0.max_size 2 hibernate.c3p0.min_size 2 hibernate.c3p0.timeout 5000 hibernate.c3p0.max_statements 100 hibernate.c3p0.idle_test_period 3000 hibernate.c3p0.acquire_increment 2 hibernate.c3p0.validate false |
1.3. hibernate.cfg.xml文件的常用配置
1.3.1.Hibernate配置属性
|
属性名 |
用途 |
|
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 |
1.3.2.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的连接释放模式。 |
|
hibernate.connection.<propertyName> |
将JDBC属性propertyName传递到DriverManager.getConnection()中去. |
|
hibernate.jndi.<propertyName> |
将属性propertyName传递到JNDI InitialContextFactory中去. |
1.3.3.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 |
1.3.4.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上下文管理。 取值true | false |
|
hibernate.transaction.auto_close_session |
如果开启, session在事务完成后将被自动关闭。 现在更好的方法是使用自动session上下文管理。 取值true | false |
1.3.5.其他属性
|
属性名 |
用途 |
|
hibernate.current_session_context_class |
为"当前" 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 |
1.3.6.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 |
1.3.7.数据库的Catalog和schema
为了解决数据库中元素命名冲突的问题，引入catalog和schema来解决。 从概念上说，一个数据库系统包含多个Catalog，每个 Catalog又包含多个 Schema，而每个Schema又包含多个数据库对象（表、视图、字段等）。
比较简单而常用的实现方式是使用数据库名作为Catalog名，使用用户名作为Schema名，各种数据库系统对Catalog和Schema的支持具体可参见下表。
1.3.8.日志
Hibernate使用Apache commons-logging来为各种事件记录日志.
commons-logging将直接输出到Apache Log4j(如果在类路径中包括log4j.jar)或 JDK1.4 logging (如果运行在JDK1.4或以上的环境下). 可以从http://jakarta.apache.org下载Log4j. 要使用Log4j，需要将log4j.properties文件放置在类路径下, 随Hibernate 一同分发的样例属性文件在src/目录下.
|
类别 |
功能 |
|
org.hibernate.SQL |
在所有SQL DML语句被执行时为它们记录日志 |
|
org.hibernate.type |
为所有JDBC参数记录日志 |
|
org.hibernate.tool.hbm2ddl |
在所有SQL DDL语句执行时为它们记录日志 |
|
org.hibernate.pretty |
在session清洗(flush)时，为所有与其关联的实体(最多20个)的状态记录日志 |
|
org.hibernate.cache |
为所有二级缓存的活动记录日志 |
|
org.hibernate.transaction |
为事务相关的活动记录日志 |
|
org.hibernate.jdbc |
为所有JDBC资源的获取记录日志 |
|
org.hibernate.hql.AST |
在解析查询的时候,记录HQL和SQL的AST分析日志 |
|
org.hibernate.secure |
为JAAS认证请求做日志 |
|
org.hibernate |
为任何Hibernate相关信息做日志 (信息量较大, 但对查错非常有帮助) |
在使用Hibernate开发应用程序时, 应当总是为org.hibernate.SQL 开启debug级别的日志记录,或者开启hibernate.show_sql属性。