Hibernate 3.6.10.Final ²Î¿¼ÊÖ²á ÖÐÎÄ°æ

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 配置属性的方式，其他可选方式还包括：

如果你想快速上路，hibernate.properties 就是最容易的途径。

org.hibernate.cfg.Configuration 实例被设计成启动期间（startup-time）对象，一旦 SessionFactory 创建完成它就被丢弃了。

当所有映射定义被 org.hibernate.cfg.Configuration 解析后，应用程序必须获得一个用于构造 org.hibernate.Session 实例的工厂。这个工厂将被应用程序的所有线程共享：

        
        SessionFactory
        
         sessions 
        
        =
        
         cfg
        
        .
        
        buildSessionFactory
        
        ();
      

Hibernate 允许你的应用程序创建多个 org.hibernate.SessionFactory 实例。这对 使用多个数据库的应用来说很有用。

通常你希望 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 连接：

但 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 处获得连接，你至少需要设置下列属性中的一个：

这是一个使用应用程序服务器提供的 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，你可以选择一个自定义的实现。

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

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

hibernate.query.substitutions toLowercase=LOWER

Hibernate 利用 Simple Logging Facade for Java (SLF4J) 来记录不同系统事件的日志。SLF4J 可以根据你选择的绑定把日志输出到几个日志框架（NOP、Simple、log4j version 1.2、JDK 1.4 logging、JCL 或 logback）上。为了设置日志，你需要在 classpath 里加入 slf4j-api.jar 和你选择的绑定的 JAR 文件（使用 Log4J 时加入 slf4j-log4j12.jar）。更多的细节请参考 SLF4J 文档。要使用 Log4j，你也需要在 classpath 里加入 log4j.properties 文件。Hibernate 里的 src/ 目录里带有一个属性文件的例子。

我们强烈建议你熟悉一下 Hibernate 的日志消息。在不失可读性的前提下，我们做了很多工作，使 Hibernate 的日志可能地详细。这是必要的查错利器。最令人感兴趣的日志分类有如下这些：

在使用 Hibernate 开发应用程序时，你应当总是为 org.hibernate.SQL 开启 debug 级别的日志记录,或者开启 hibernate.show_sql 属性。

org.hibernate.cfg.NamingStrategy 接口允许你为数据库中的对象和 schema 元素指定一个“命名标准”。

你可能会提供一些通过 Java 标识生成数据库标识或将映射定义文件中"逻辑"表/列名处理成"物理"表/列名的规则。这个特性有助于减少冗长的映射定义文件，消除重复内容（如 TBL_ 前缀）。Hibernate 使用的缺省策略是相当精简的。

在加入映射定义前，你可以调用 Configuration.setNamingStrategy() 指定一个不同的命名策略：

SessionFactory sf = new Configuration()

    .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)

    .addFile("Item.hbm.xml")

    .addFile("Bid.hbm.xml")

    .buildSessionFactory();

org.hibernate.cfg.ImprovedNamingStrategy 是一个内建的命名策略，对一些应用程序而言，可能是非常有用的起点。

You can configure the persister implementation used to persist your entities and collections:

The latter in the list the higher in priority.

You can pass the PersisterClassProvider instance to the Configuration object.

SessionFactory sf = new Configuration()

    .setPersisterClassProvider(customPersisterClassProvider)

    .addAnnotatedClass(Order.class)

    .buildSessionFactory();

The persister class provider methods, when returning a non null persister class, override the default Hibernate persisters. The entity name or the collection role are passed to the methods. It is a nice way to centralize the overriding logic of the persisters instead of spreading them on each entity or collection mapping.

另一个配置方法是在 hibernate.cfg.xml 文件中指定一套完整的配置。这个文件可以当成 hibernate.properties 的替代。若两个文件同时存在，它将覆盖前者的属性。

XML 配置文件被默认是放在 CLASSPATH 的根目录下。下面是一个例子：

<?xml version='1.0' encoding='utf-8'?>

<!DOCTYPE hibernate-configuration PUBLIC

    "-//Hibernate/Hibernate Configuration DTD//EN"

    "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">



<hibernate-configuration>



    <!-- a SessionFactory instance listed as /jndi/name -->

    <session-factory

        name="java:hibernate/SessionFactory">



        <!-- properties -->

        <property name="connection.datasource">java:/comp/env/jdbc/MyDB</property>

        <property name="dialect">org.hibernate.dialect.MySQLDialect</property>

        <property name="show_sql">false</property>

        <property name="transaction.factory_class">

            org.hibernate.transaction.JTATransactionFactory

        </property>

        <property name="jta.UserTransaction">java:comp/UserTransaction</property>



        <!-- mapping files -->

        <mapping resource="org/hibernate/auction/Item.hbm.xml"/>

        <mapping resource="org/hibernate/auction/Bid.hbm.xml"/>



        <!-- cache settings -->

        <class-cache class="org.hibernate.auction.Item" usage="read-write"/>

        <class-cache class="org.hibernate.auction.Bid" usage="read-only"/>

        <collection-cache collection="org.hibernate.auction.Item.bids" usage="read-write"/>



    </session-factory>



</hibernate-configuration>

如你所见，这个方法优势在于，在配置文件中指出了映射定义文件的名字。一旦你需要调整 Hibernate 的缓存，hibernate.cfg.xml 也是更方便。注意，使用 hibernate.properties 还是 hibernate.cfg.xml 完全是由你来决定，除了上面提到的 XML 语法的优势之外，两者是等价的。

使用 XML 配置，使得启动 Hibernate 变的异常简单：

        
        SessionFactory
        
         sf 
        
        =
        
         
        
        new
        
         
        
        Configuration
        
        ().
        
        configure
        
        ().
        
        buildSessionFactory
        
        ();
      

你可以使用如下代码来添加一个不同的 XML 配置文件：

SessionFactory sf = new Configuration()

    .configure("catdb.cfg.xml")

    .buildSessionFactory();

针对 J2EE 体系，Hibernate 有如下几个集成的方面：

如果应用程序服务器抛出 "connection containment" 异常，根据你的环境，也许该将配置属性 hibernate.connection.release_mode 设为 after_statement。

<?xml version="1.0"?>

<server>



<mbean code="org.hibernate.jmx.HibernateService"

    name="jboss.jca:service=HibernateFactory,name=HibernateFactory">



    <!-- Required services -->

    <depends>jboss.jca:service=RARDeployer</depends>

    <depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>



    <!-- Bind the Hibernate service to JNDI -->

    <attribute name="JndiName">java:/hibernate/SessionFactory</attribute>



    <!-- Datasource settings -->

    <attribute name="Datasource">java:HsqlDS</attribute>

    <attribute name="Dialect">org.hibernate.dialect.HSQLDialect</attribute>



    <!-- Transaction integration -->

    <attribute name="TransactionStrategy">

        org.hibernate.transaction.JTATransactionFactory</attribute>

    <attribute name="TransactionManagerLookupStrategy">

        org.hibernate.transaction.JBossTransactionManagerLookup</attribute>

    <attribute name="FlushBeforeCompletionEnabled">true</attribute>

    <attribute name="AutoCloseSessionEnabled">true</attribute>



    <!-- Fetching options -->

    <attribute name="MaximumFetchDepth">5</attribute>



    <!-- Second-level caching -->

    <attribute name="SecondLevelCacheEnabled">true</attribute>

    <attribute name="CacheProviderClass">org.hibernate.cache.EhCacheProvider</attribute>

    <attribute name="QueryCacheEnabled">true</attribute>



    <!-- Logging -->

    <attribute name="ShowSqlEnabled">true</attribute>



    <!-- Mapping files -->

    <attribute name="MapResources">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>



</mbean>



</server>