net.sf.hibernate.cfg.Configuration的一個(gè)實(shí)例代表了應(yīng)用程序中所有的Java類(lèi)到SQL數(shù)據(jù)庫(kù)的映射的集合。Configuration用于構(gòu)造一個(gè)(不可變的)SessionFactory。這些映射是從一些XML映射文件中編譯得來(lái)的。

你可以得到一個(gè)Configuration的實(shí)例，直接實(shí)例化它即可。下面有一個(gè)例子，用來(lái)從兩個(gè)XML配置文件（位于classpath）中的映射中初始化：

Configuration cfg = new Configuration()
    .addFile("Item.hbm.xml")
    .addFile("Bid.hbm.xml");

另外一個(gè)（某些時(shí)候更好的）方法是讓Hibernate自行用getResourceAsStream()來(lái)裝載映射文件。

Configuration cfg = new Configuration()
    .addClass(org.hibernate.auction.Item.class)
    .addClass(org.hibernate.auction.Bid.class);

Hibernate 就會(huì)在classpath中尋找叫做/org/hibernate/autcion/Item.hbm.xml、/org/hibernate/autcion/Bid.hbm.xml的映射文件。這種方法取消了所有對(duì)文件名的硬編碼。

Configuration也可以指定一些可選的配置項(xiàng)：

Properties props = new Properties();
...
Configuration cfg = new Configuration()
    .addClass(org.hibernate.auction.Item.class)
    .addClass(org.hibernate.auction.Bid.class)
    .setProperties(props);

Configuration是僅在配置期使用的對(duì)象，從第一個(gè)SessionFactory開(kāi)始建立的時(shí)候，它就失效了。

當(dāng)所有的映射都被Configuration解析之后，應(yīng)用程序?yàn)榱说玫?TT class=literal>Session實(shí)例，必須先得到它的工廠。這個(gè)工廠應(yīng)該是被應(yīng)用程序的所有線程共享的：

SessionFactory sessions = cfg.buildSessionFactory();

當(dāng)然，Hibernate并不禁止你的程序?qū)嵗鄠€(gè)SessionFactory。在你使用不止一個(gè)數(shù)據(jù)庫(kù)的時(shí)候，這就有用了。

SessionFactory可以使用一個(gè)用戶自行提供的JDBC連接來(lái)打開(kāi)一個(gè)Session。這種設(shè)計(jì)可以讓?xiě)?yīng)用程序來(lái)自己管理JDBC連接:

java.sql.Connection conn = datasource.getConnection();
Session session = sessions.openSession(conn);

// do some data access work

應(yīng)用程序必須小心，不能在同一個(gè)連接上打開(kāi)兩個(gè)并行的session!

另一種方法就是，你可以讓SessionFactory替你打開(kāi)連接。SessionFactory必須事先知道JDBC連接的參數(shù)，有幾種不同的方法設(shè)置參數(shù)：

如果你使用這種方法，打開(kāi)一個(gè)Session是非常簡(jiǎn)單的：

Session session = sessions.openSession(); // open a new Session
// do some data access work, a JDBC connection will be used on demand

所有的Hibernate屬性名和約束都在net.sf.hibernate.cfg.Environment類(lèi)中定義。我們討論一下JDBC連接配置最重要的幾項(xiàng)設(shè)置：

假若你設(shè)置了如下的屬性，Hibernate會(huì)使用java.sql.DriverManager來(lái)得到連接，并建立連接池：

Hibernate的連接池算法是非常可配置的。它的用途是讓你上手，但是并非讓你在生產(chǎn)系統(tǒng)中使用的,甚至不是用來(lái)做性能測(cè)試的。如果為了得到最好的性能和可靠性需要使用第三方的池，請(qǐng)用你連接池特定的設(shè)置來(lái)取代hibernate.connection.pool_size屬性。

C3P0是隨Hibernate發(fā)行包一起發(fā)布的一個(gè)開(kāi)放源代碼JDBC連接池，你可以在lib 目錄中找到。假若你設(shè)置了hibernate.c3p0.* 屬性，Hibernate會(huì)使用內(nèi)置的C3P0ConnectionProvider作為連接池。 對(duì)Apache DBCP和Proxool的支持也是內(nèi)置的。你必須設(shè)置hibernate.dbcp.*屬性 （DBCP連接池屬性）來(lái)打開(kāi)DBCPConnectionProvider。如果打開(kāi)hibernate.dbcp.ps.* (DBCP 語(yǔ)句緩存屬性)可以使用Prepared statement緩存（高度推薦）。要知道它們的含義，請(qǐng)查閱Apache commons-pool的文檔。如果你想要用Proxool,你需要設(shè)置hibernate.proxool.*系列屬性。

下面是使用C3P0的一個(gè)例子：

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 = net.sf.hibernate.dialect.PostgreSQLDialect

在Application Server內(nèi)使用時(shí)，Hibernate可以從JNDI中注冊(cè)的javax.sql.Datasource取得連接。需要設(shè)置如下屬性：

下面是一個(gè)使用應(yīng)用服務(wù)器提供的JNDI數(shù)據(jù)源的例子:

hibernate.connection.datasource = java:/comp/env/jdbc/MyDB
hibernate.transaction.factory_class = /
    net.sf.hibernate.transaction.JTATransactionFactory
hibernate.transaction.manager_lookup_class = /
    net.sf.hibernate.transaction.JBossTransactionManagerLookup
hibernate.dialect = /
    net.sf.hibernate.dialect.PostgreSQLDialect

從JNDI數(shù)據(jù)源獲得的JDBC連接自動(dòng)具有應(yīng)用服務(wù)器的容器管理事務(wù)的特性。

可以通過(guò)"hibernate.connnection"開(kāi)頭的屬性來(lái)設(shè)置特別的連接屬性。比如，你可以通過(guò)hibernate.connnection.charSet來(lái)指定charSet。

通過(guò)實(shí)現(xiàn)net.sf.hibernate.connection.ConnectionProvider接口，你可以定義如何獲得JDBC連接的策略。你可以通過(guò)設(shè)置hibernate.connection.provider_class來(lái)選擇一個(gè)自定義的實(shí)現(xiàn)。

下面是一些在運(yùn)行時(shí)可以改變Hibernate行為的其他配置。所有這些都是可選的，也有合理的默認(rèn)值。

系統(tǒng)級(jí)別的配置只能通過(guò)java -Dproperty=value或者在hibernate.properties文件中配置，而不能通過(guò)傳遞給Configuration的Properties實(shí)例來(lái)配置。

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

hibernate.query.substitutions toLowercase=LOWER

通過(guò)Apache commons-logging，Hibernate記錄很多事件。

commons-logging服務(wù)會(huì)直接輸出到Apache log4j(如果你把log4j.jar放在你的classpath里),或者JDK1.4 logging（如果你運(yùn)行JDK 1.4或以上版本）。你可以從http://jakarta.下載log4j。要使用log4j,你需要在你的classpath中放置一個(gè)log4j.properties文件。Hibernate發(fā)行包中包含一個(gè)示例的properties配置文件。

我們強(qiáng)烈建議你熟悉Hibernate的log信息。Hibernate的很多工作都會(huì)盡量詳細(xì)的留下log,也沒(méi)有讓它變的難以閱讀。這是用來(lái)解決問(wèn)題的最基本的設(shè)施。當(dāng)然也別忘了可以如前所述打開(kāi)SQL 記錄(hibernate.show_sql)，在你要解決性能問(wèn)題時(shí)，這是你第一步就需要做的。

net.sf.hibernate.cfg.NamingStrategy接口允許你對(duì)數(shù)據(jù)庫(kù)對(duì)象和schema元素指定“命名標(biāo)準(zhǔn)”。

你可以定義從Java標(biāo)識(shí)符自動(dòng)生成數(shù)據(jù)庫(kù)標(biāo)識(shí)符的規(guī)則，或者是映射文件中給出的“邏輯”字段名和表名處理為“物理”表名和字段名的規(guī)則。這個(gè)功能可以讓映射文件變得簡(jiǎn)潔，消除無(wú)用的噪音（比如TBL_前綴等）。Hibernate使用的默認(rèn)策略是幾乎什么都不做。

你可以在增加映射(add mappings)之前調(diào)用Configuration.setNamingStrategy()來(lái)指定不同的策略。

SessionFactory sf = new Configuration()
    .setNamingStrategy(ImprovedNamingStrategy.INSTANCE)
    .addFile("Item.hbm.xml")
    .addFile("Bid.hbm.xml")
    .buildSessionFactory();

net.sf.hibernate.cfg.ImprovedNamingStrategy 是一個(gè)內(nèi)置的策略，對(duì)某些程序，你可以把它作為改造的起點(diǎn)。

另一種配置屬性的方法是把所有的配置都放在一個(gè)名為hibernate.cfg.xml的文件中。這個(gè)文件可以被用于替代hibernate.properties文件，如果二者都出現(xiàn)，它會(huì)覆蓋properties文件。

XML配置文件默認(rèn)會(huì)期望在CLASSPATH的根目錄中找到。下面是一個(gè)例子。

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 2.0//EN"

 "http://hibernate./hibernate-configuration-2.0.dtd">

<hibernate-configuration>

    <!-- a SessionFactory instance listed as /jndi/name -->
    <session-factory
        name="java:comp/env/hibernate/SessionFactory">

        <!-- properties -->
        <property name="connection.datasource">my/first/datasource</property>
        <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>
        <property name="show_sql">false</property>
        <property name="use_outer_join">true</property>
        <property name="transaction.factory_class">
            net.sf.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"/>

    </session-factory>

</hibernate-configuration>

配置Hibernate只需如此簡(jiǎn)單：

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

你可以使用另外一個(gè)名字的XML配置文件：

SessionFactory sf = new Configuration()
    .configure("catdb.cfg.xml")
    .buildSessionFactory();