一個(gè)org.hibernate.cfg.Configuration實(shí)例代表了一個(gè)應(yīng)用程序中Java類型 到SQL數(shù)據(jù)庫(kù)映射的完整集合. Configuration被用來(lái)構(gòu)建一個(gè)(不可變的 (immutable))SessionFactory. 映射定義則由不同的XML映射定義文件編譯而來(lái).

你可以直接實(shí)例化Configuration來(lái)獲取一個(gè)實(shí)例，并為它指定XML映射定義 文件. 如果映射定 義文件在類路徑(classpath)中, 請(qǐng)使用addResource():

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

一個(gè)替代方法（有時(shí)是更好的選擇）是，指定被映射的類，讓Hibernate幫你尋找映射定義文件:

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

Hibernate將會(huì)在類路徑(classpath)中尋找名字為 /org/hibernate/auction/Item.hbm.xml和 /org/hibernate/auction/Bid.hbm.xml映射定義文件. 這種方式消除了任何對(duì)文件名的硬編碼(hardcoded).

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");

當(dāng)然這不是唯一的傳遞Hibernate配置屬性的方式, 其他可選方式還包括:

如果想盡快體驗(yàn)Hbernate, hibernate.properties是最簡(jiǎn)單的方式.

Configuration實(shí)例是一個(gè)啟動(dòng)期間（startup-time）的對(duì)象, 一旦SessionFactory創(chuàng)建完成它就被丟棄了.

當(dāng)所有映射定義被Configuration解析后, 應(yīng)用程序必須獲得一個(gè)用于構(gòu)造Session實(shí)例的工廠. 這個(gè)工廠將被應(yīng)用程序的所有線程共享:

SessionFactory sessions = cfg.buildSessionFactory();

Hibernate允許你的應(yīng)用程序創(chuàng)建多個(gè)SessionFactory實(shí)例. 這對(duì) 使用多個(gè)數(shù)據(jù)庫(kù)的應(yīng)用來(lái)說(shuō)很有用.

通常你希望SessionFactory來(lái)為你創(chuàng)建和緩存(pool)JDBC連接. 如果你采用這種方式, 只需要如下例所示那樣，打開(kāi)一個(gè)Session:

Session session = sessions.openSession(); // open a new Session

一旦你需要進(jìn)行數(shù)據(jù)訪問(wèn)時(shí), 就會(huì)從連接池(connection pool)獲得一個(gè)JDBC連接.

為了使這種方式工作起來(lái), 我們需要向Hibernate傳遞一些JDBC連接的屬性. 所有Hibernate屬性的名字和語(yǔ)義都在org.hibernate.cfg.Environment中定義. 我們現(xiàn)在將描述JDBC連接配置中最重要的設(shè)置.

如果你設(shè)置如下屬性，Hibernate將使用java.sql.DriverManager來(lái)獲得(和緩存)JDBC連接 :

但Hibernate自帶的連接池算法相當(dāng)不成熟. 它只是為了讓你快些上手，不適合用于產(chǎn)品系統(tǒng)或性能測(cè)試中。 出于最佳性能和穩(wěn)定性考慮你應(yīng)該使用第三方的連接池。只需要連接池的特定設(shè)置替換 hibernate.connection.pool_size。這將關(guān)閉Hibernate自帶的連接池. 例如, 你可能會(huì)想用C3P0.

C3P0是一個(gè)隨Hibernate一同分發(fā)的開(kāi)源的JDBC連接池, 它位于lib目錄下。 如果你設(shè)置了hibernate.c3p0.*相關(guān)的屬性, Hibernate將使用 C3P0ConnectionProvider來(lái)緩存JDBC連接. 如果你更原意使用Proxool, 請(qǐng)參考發(fā) 行包中的hibernate.properties并到Hibernate網(wǎng)站獲取更多的信息.

這是一個(gè)使用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

為了能在應(yīng)用程序服務(wù)器(application server)中使用Hibernate, 你應(yīng)當(dāng)總是將Hibernate 配置成注冊(cè)在JNDI中的Datasource處獲得連接，你至少需要設(shè)置下列屬性中的一個(gè):

這里有一個(gè)使用應(yīng)用程序服務(wù)器JNDI數(shù)據(jù)源的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數(shù)據(jù)源獲得的JDBC連接將自動(dòng)參與應(yīng)用程序服務(wù)器中容器管理的事務(wù)(container-managed transactions)中去.

任何連接(connection)配置屬性的屬性名要以"hibernate.connnection"前綴開(kāi)頭. 例如, 你可能會(huì)使用hibernate.connection.charSet來(lái)指定charSet.

通過(guò)實(shí)現(xiàn)org.hibernate.connection.ConnectionProvider接口，你可以定義屬于 你自己的獲得JDBC連接的插件策略。通過(guò)設(shè)置hibernate.connection.provider_class， 你可以選擇一個(gè)自定義的實(shí)現(xiàn).

有大量屬性能用來(lái)控制Hibernate在運(yùn)行期的行為. 它們都是可選的, 并擁有適當(dāng)?shù)哪J(rèn)值.

警告: 其中一些屬性是"系統(tǒng)級(jí)(system-level)的". 系統(tǒng)級(jí)屬性可以通過(guò)java -Dproperty=value或 hibernate.properties來(lái)設(shè)置, 而不能用上面描述的其他方法來(lái)設(shè)置.

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

hibernate.query.substitutions toLowercase=LOWER

Hibernate使用Apache commons-logging來(lái)為各種事件記錄日志.

commons-logging將直接輸出到Apache Log4j(如果在類路徑中包括log4j.jar)或 JDK1.4 logging (如果運(yùn)行在JDK1.4或以上的環(huán)境下). 你可以從http://jakarta.apache.org 下載Log4j. 要使用Log4j，你需要將log4j.properties文件放置在類路徑下, 隨Hibernate 一同分發(fā)的樣例屬性文件在src/目錄下.

我們強(qiáng)烈建議你熟悉一下Hibernate的日志消息. 在不失可讀性的前提下， 我們做了很多工作，使Hibernate的日志可能地詳細(xì). 這是必要的查錯(cuò)利器. 最令人感興趣的日志分類有如下這些:

在使用Hibernate開(kāi)發(fā)應(yīng)用程序時(shí), 你應(yīng)當(dāng)總是為org.hibernate.SQL 開(kāi)啟debug級(jí)別的日志記錄,或者開(kāi)啟hibernate.show_sql屬性來(lái)代替它。.

org.hibernate.cfg.NamingStrategy接口允許你為數(shù)據(jù)庫(kù)中的對(duì)象和schema 元素指定一個(gè)“命名標(biāo)準(zhǔn)”.

你可能會(huì)提供一些通過(guò)Java標(biāo)識(shí)生成數(shù)據(jù)庫(kù)標(biāo)識(shí)或?qū)⒂成涠x文件中"邏輯"表/列名處理成"物理"表/列名的規(guī)則. 這個(gè)特性有助于減少冗長(zhǎng)的映射定義文件.

在加入映射定義前，你可以調(diào)用 Configuration.setNamingStrategy()指定一個(gè)不同的命名策略:

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

org.hibernate.cfg.ImprovedNamingStrategy是一個(gè)內(nèi)建的命名策略, 對(duì) 一些應(yīng)用程序而言，可能是非常有用的起點(diǎn).

另一個(gè)配置方法是在hibernate.cfg.xml文件中指定一套完整的配置. 這個(gè)文件可以當(dāng)成hibernate.properties的替代。 若兩個(gè)文件同時(shí)存在，它將重載前者的屬性.

XML配置文件被默認(rèn)是放在CLASSPATH的根目錄下. 這是一個(gè)例子:

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
"-//Hibernate/Hibernate Configuration DTD//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
<!-- 以/jndi/name綁定到JNDI的SessionFactory實(shí)例 -->
<session-factory
name="java:hibernate/SessionFactory">
<!-- 屬性 -->
<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 resource="org/hibernate/auction/Item.hbm.xml"/>
<mapping resource="org/hibernate/auction/Bid.hbm.xml"/>
<!-- 緩存設(shè)置 -->
<class-cache class="org.hibernate.auction.Item" usage="read-write"/>
<class-cache class="org.hibernate.auction.Bid" usage="read-only"/>
<collection-cache class="org.hibernate.auction.Item.bids" usage="read-write"/>
</session-factory>
</hibernate-configuration>

如你所見(jiàn), 這個(gè)方法優(yōu)勢(shì)在于，在配置文件中指出了映射定義文件的名字. 一旦你需要調(diào)整Hibernate的緩存， hibernate.cfg.xml也是更方便. 注意，使用hibernate.properties還是 hibernate.cfg.xml完全是由你來(lái)決定, 除了上面提到的XML語(yǔ)法的優(yōu)勢(shì)之外, 兩者是等價(jià)的.

使用XML配置，使得啟動(dòng)Hibernate變的異常簡(jiǎn)單, 如下所示，一行代碼就可以搞定：

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

你可以使用如下代碼來(lái)添加一個(gè)不同的XML配置文件

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

針對(duì)J2EE體系,Hibernate有如下幾個(gè)集成的方面:

如果應(yīng)用程序服務(wù)器拋出"connection containment"異常, 根據(jù)你的環(huán)境，也許該將配置屬性 hibernate.connection.release_mode設(shè)為after_statement.

<?xml version="1.0"?>
<server>
<mbean code="org.hibernate.jmx.HibernateService"
name="jboss.jca:service=HibernateFactory,name=HibernateFactory">
<!-- 必須的服務(wù) -->
<depends>jboss.jca:service=RARDeployer</depends>
<depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>
<!-- 將Hibernate服務(wù)綁定到JNDI -->
<attribute name="JndiName">java:/hibernate/SessionFactory</attribute>
<!-- 數(shù)據(jù)源設(shè)置 -->
<attribute name="Datasource">java:HsqlDS</attribute>
<attribute name="Dialect">org.hibernate.dialect.HSQLDialect</attribute>
<!-- 事務(wù)集成 -->
<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>
<!-- 抓取選項(xiàng) -->
<attribute name="MaximumFetchDepth">5</attribute>
<!-- 二級(jí)緩存 -->
<attribute name="SecondLevelCacheEnabled">true</attribute>
<attribute name="CacheProviderClass">org.hibernate.cache.EhCacheProvider</attribute>
<attribute name="QueryCacheEnabled">true</attribute>
<!-- 日志 -->
<attribute name="ShowSqlEnabled">true</attribute>
<!-- 映射定義文件 -->
<attribute name="MapResources">auction/Item.hbm.xml,auction/Category.hbm.xml</attribute>
</mbean>
</server>