一個org.hibernate.cfg.Configuration實例代表了一個應用程序中Java類型 到SQL數據庫映射的完整集合. Configuration被用來構建一個(不可變的 (immutable))SessionFactory. 映射定義則由不同的XML映射定義文件編譯而來.

你可以直接實例化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).

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配置屬性的方式, 其他可選方式還包括:

如果想盡快體驗Hbernate, hibernate.properties是最簡單的方式.

Configuration實例是一個啟動期間（startup-time）的對象, 一旦SessionFactory創建完成它就被丟棄了.

當所有映射定義被Configuration解析后, 應用程序必須獲得一個用于構造Session實例的工廠. 這個工廠將被應用程序的所有線程共享:

SessionFactory sessions = cfg.buildSessionFactory();

Hibernate允許你的應用程序創建多個SessionFactory實例. 這對 使用多個數據庫的應用來說很有用.

通常你希望SessionFactory來為你創建和緩存(pool)JDBC連接. 如果你采用這種方式, 只需要如下例所示那樣，打開一個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在運行期的行為. 它們都是可選的, 并擁有適當的默認值.

警告: 其中一些屬性是"系統級(system-level)的". 系統級屬性可以通過java -Dproperty=value或 hibernate.properties來設置, 而不能用上面描述的其他方法來設置.

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

hibernate.query.substitutions toLowercase=LOWER

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/目錄下.

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

在使用Hibernate開發應用程序時, 你應當總是為org.hibernate.SQL 開啟debug級別的日志記錄,或者開啟hibernate.show_sql屬性來代替它。.

org.hibernate.cfg.NamingStrategy接口允許你為數據庫中的對象和schema 元素指定一個“命名標準”.

你可能會提供一些通過Java標識生成數據庫標識或將映射定義文件中"邏輯"表/列名處理成"物理"表/列名的規則. 這個特性有助于減少冗長的映射定義文件.

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

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

org.hibernate.cfg.ImprovedNamingStrategy是一個內建的命名策略, 對 一些應用程序而言，可能是非常有用的起點.

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

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

<?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實例 -->
<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"/>
<!-- 緩存設置 -->
<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>

如你所見, 這個方法優勢在于，在配置文件中指出了映射定義文件的名字. 一旦你需要調整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">
<!-- 必須的服務 -->
<depends>jboss.jca:service=RARDeployer</depends>
<depends>jboss.jca:service=LocalTxCM,name=HsqlDS</depends>
<!-- 將Hibernate服務綁定到JNDI -->
<attribute name="JndiName">java:/hibernate/SessionFactory</attribute>
<!-- 數據源設置 -->
<attribute name="Datasource">java:HsqlDS</attribute>
<attribute name="Dialect">org.hibernate.dialect.HSQLDialect</attribute>
<!-- 事務集成 -->
<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>
<!-- 抓取選項 -->
<attribute name="MaximumFetchDepth">5</attribute>
<!-- 二級緩存 -->
<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>