hibernate配置文档

http://wenku.baidu.com/link?url=WYBBeSSYuRYa_Zr4y29CphRDCEhj0WgIpX0apvWlumXZkl5ZYuEKZB2drkAsnNaLF22FqZo1C6245kcwHce8EPaCx2yAyfNV32wqulQ63ni

由于 Hibernate 是为了能在各种不同环境下工作而设计的，因此存在着大量的配置参数。幸运的是多数配置参数都有比较直观的默认值，并有随 Hibernate 一同分发的配置样例 hibernate.properties（位于

etc/）来展示各种配置选项。所需做的仅仅是将这个样例文件复制到类路径（classpath）下并进行定制。
3.1. 可编程的配置方式
org.hibernate.cfg.Configuration 实例代表了一个应用程序中 Java 类型到SQL数据库映射的完整集合。org.hibernate.cfg.Configuration 被用来构建一个（不可变的（immutable））org.hibernate.SessionFactory。
映射定义则由不同的 XML 映射定义文件编译而来。
你可以直接实例化 org.hibernate.cfg.Configuration 来获取一个实例，并为它指定 XML 映射定义文件。如果映射定义文件在类路径（classpath）中，请使用 addResource（)。例如：
Configuration cfg = new Configuration()     .addResource("Item.hbm.xml")     .addResource("Bid.hbm.xml");
一个替代方法（有时是更好的选择）是，指定被映射的类，让 Hibernate 帮你寻找映射定义文件：  
Configuration cfg = new Configuration()
    .addClass(org.hibernate.auction.Item.class)     .addClass(org.hibernate.auction.Bid.class);
Hibernate 将会在类路径（classpath）中寻找名字为 /org/hibernate/auction/Item.hbm.xml 和
/org/hibernate/auction/Bid.hbm.xml 映射定义文件。这种方式消除了任何对文件名的硬编码
（hardcoded）。
org.hibernate.cfg.Configuration > 也允许你指定配置属性。例如：
Configuration cfg = new Configuration()
    .addClass(org.hibernate.auction.Item.class)     .addClass(org.hibernate.auction.Bid.class)
    .setProperty("hibernate.dialect", "org.hibernate.dialect.MySQLInnoDBDialect")     .setProperty("hibernate.connection.datasource", "java:comp/env/jdbc/test")     .setProperty("hibernate.order_updates", "true");


     五一长假除了旅游 还能做什么？  辅导补习  美容养颜  家庭家务  加班须知      
 


当然这不是唯一的传递 Hibernate 配置属性的方式，其他可选方式还包括：  
1. 传一个 java.util.Properties 实例给 Configuration.setProperties()。
2. 将 hibernate.properties 放置在类路径（classpath）的根目录下（root directory）。 3. 通过 java -Dproperty=value 来设置系统（System）属性。 4. 在 hibernate.cfg.xml 中加入元素 <property>（稍后讨论）。  
如果你想快速上路，hibernate.properties 就是最容易的途径。
org.hibernate.cfg.Configuration 实例被设计成启动期间（startup-time）对象，一旦 SessionFactory 创
建完成它就被丢弃了。
3.2. 获得 SessionFactory
当所有映射定义被 org.hibernate.cfg.Configuration 解析后，应用程序必须获得一个用于构造
org.hibernate.Session 实例的工厂。这个工厂将被应用程序的所有线程共享：
SessionFactory sessions = cfg.buildSessionFactory();
Hibernate 允许你的应用程序创建多个 org.hibernate.SessionFactory 实例。这对 使用多个数据库的应用来说很有用。
3.3. JDBC 连接
通常你希望 org.hibernate.SessionFactory 来为你创建和缓存（pool）JDBC 连接。如果你采用这种方式，只需要如下例所示那样，打开一个 org.hibernate.Session：
Session session = sessions.openSession(); // open a new Session
一旦你需要进行数据访问时，就会从连接池（connection pool）获得一个 JDBC 连接。  
为了使这种方式工作起来，我们需要向 Hibernate 传递一些 JDBC 连接的属性。所有 Hibernate 属性的名字和语义都在 org.hibernate.cfg.Environment 中定义。我们现在将描述 JDBC 连接配置中最重要的设置。



 


如果你设置如下属性，Hibernate 将使用 java.sql.DriverManager 来获得（和缓存）JDBC 连接：
表 3.1. Hibernate JDBC 属性
属性名
用途
hibernate.connection.driver_class JDBC driver class hibernate.connection.url JDBC URL hibernate.connection.username database user
hibernate.connection.password 数据库用户密码
hibernate.connection.pool_size maximum number of pooled connections
 
但 Hibernate 自带的连接池算法相当不成熟。它只是为了让你快些上手，并不适合用于产品系统或性能测试中。 出于最佳性能和稳定性考虑你应该使用第三方的连接池。只需要用特定连接池的设置替换
hibernate.connection.pool_size 即可。这将关闭 Hibernate 自带的连接池。例如，你可能会想用 C3P0。  
C3P0 是一个随 Hibernate 一同分发的开源的 JDBC 连接池，它位于 lib目录下。 如果你设置了
hibernate.c3p0.* 相关的属性，Hibernate将使用 C3P0ConnectionProvider 来缓存 JDBC 连接。如果
你更原意使用 Proxool，请参考发行包中的 hibernate.properties 并到 Hibernate 网站获取更多的信息。  
这是一个使用 C3P0 的 hibernate.properties 样例文件：  
hibernate.connection.driver_class = org.postgresql.Driver
hibernate.connection.url = jdbc:postgresql://localhost/mydatabase hibernate.connection.username = myuser hibernate.connection.password = secret hibernate.c3p0.min_size=5 hibernate.c3p0.max_size=20 hibernate.c3p0.timeout=1800 hibernate.c3p0.max_statements=50
hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect
为了能在应用程序服务器（application server）中使用 Hibernate，应当总是将 Hibernate 配置成从注册在 JNDI 中的 Datasource 处获得连接，你至少需要设置下列属性中的一个：  



 


表 3.2. Hibernate 数据源属性
属性名
用途
hibernate.connection.datasource 数据源 JNDI 名字
hibernate.jndi.url JNDI 提供者的 URL（可选）
hibernate.jndi.class
JNDI InitialContextFactory 类（可选）
hibernate.connection.username 数据库用户（可选） hibernate.connection.password 数据库密码（可选）
 
这是一个使用应用程序服务器提供的 JNDI 数据源的 hibernate.properties 样例文件：  
hibernate.connection.datasource = java:/comp/env/jdbc/test hibernate.transaction.factory_class = \
    org.hibernate.transaction.JTATransactionFactory hibernate.transaction.manager_lookup_class = \
    org.hibernate.transaction.JBossTransactionManagerLookup hibernate.dialect = org.hibernate.dialect.PostgreSQLDialect
从 JNDI 数据源获得的 JDBC 连接将自动参与到应用程序服务器中容器管理的事务（container-managed transactions）中去。
任何连接（connection）属性的属性名都要以 "hibernate.connnection" 开头。例如，你可能会使用
hibernate.connection.charSet 来指定 charSet 连接属性。  
通过实现 org.hibernate.connection.ConnectionProvider 接口，你可以定义属于你自己的获得JDBC连接的插件策略。通过设置hibernate.connection.provider_class，你可以选择一个自定义的实现。  
3.4. 可选的配置属性
有大量属性能用来控制 Hibernate 在运行期的行为。它们都是可选的，并拥有适当的默认值。  
警告



 


其中一些属性是"系统级（system-level）的"。系统级属性只能通过java -Dproperty=value 或
hibernate.properties 来设置，而不能用上面描述的其他方法来设置。
表 3.3. Hibernate 配置属性
属性名 用途
hibernate.dialect
允许 Hibernate 针对特定的关系数据库生成优化的 SQL 的 org.hibernate.dialect.Dialect 的类名。  
例如：full.classname.of.Dialect  
在大多数情况下，Hibernate 可以根据 JDBC 驱动返回的
 
JDBC
metadata
选择正确的
org.hibernate.dialect.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
org.hibernate.SessionFactory 创建后，将自动使用这个名
字绑定到 JNDI 中。