強人Hibernate文檔筆記（中）

Hibernate文檔筆記共分為三個部分，此處是第二部分，講述了Contextual Sessions、Configuration、獲取SessionFactory和JDBC Connections（Session是對JDBC連接的封裝）。

五、Contextual Sessions

許多應用程序需要一種和上下文有關聯Hibernate session，這樣的session是指貫穿於給定環境的上下文中都有效的session。無論如何，貫穿於應用程序應用上下文由什麼組成的清晰度不同，不同的上下文針對當前的概念有不同的范圍。

使用Hibernate 3.0以前版本的應用程序，趨於使用自已實現的基於ThreadLocal來維護前後關系的session、諸如HibernateUtil的幫助類；或使用基於代理或攔截機制的第三方的框架（Spring或Pico）。

從Hibernate 3.0.1，Hibernate加入了SessionFactory.getCurrentSession()方法。最初，假定使用JTA事務定義了當前session的scope和context。Hibernate團隊維護時，給定了成熟的卓越的JTA TransactionManager的實現方式，多數（但不是所有）應用程序應該使JTA transaction management，不論它是否發布到一個JEE容器中。基於這一點，基於用JTA來維護上下文關系中的session應該是必須的。

無論如何，在Hibernate 3.1，SessionFactory.getCurrentSession()之後的處理，是可以被插拔的，也就是說可以session的范圍和上下文。新擴展接口（org.hibernate.context.CurrentSessionContext）和新的配置參數（hibernate.current_session_context_class）被加入，允許插拔，也就是說可以定義session的范圍和上下文。

細節可以查看org.hibernate.context.CurrentSessionContext的文檔。它定義了一個currentSession()方法，負責跟蹤與當前上下文相關聯的session。Hibernate提供了這個接口的三種實現方式。

1.org.hibernate.context.JTASessionContext

當前session，通過JTA事務跟蹤和標識生命周期。這裡的處理過程在處理方法上和老JTA是相似的。

2.org.hibernate.context.ThreadLocalSessionContext

當前session，通過當前執行的線程來跟蹤。

3.org.hibernate.context.ManagedSessionContext

當前session，通過當前執行的線程來跟蹤。你是負責綁定和解除當前session到執行線程通過使用這個類的靜態方法。該類不會open、flush、close session。

前兩個實現類，提供了“一個session對應一個數據庫事務”的編程模式，也就是眾所周知的“session-per-request”模式。Hibernate session的開始和結束，是以數據庫中事務的執行時間為依據的。如果你使用編程方式劃分事務，用簡單的JSE需不是JTA，你應該考慮使用Hibernate事務APIs來隱藏低層的事務代碼。如果你使用的是JTA，使用JTA的接口來劃分事務。如果你在一個支持CMT（Container Management Transaction）的容器運行程序，事務是通過聲明定義，在你程序中不需要任何的代碼來劃分事務。

Hibernate.current_session_context_class參數應該指定，一個org.hibernate.context.CurrentSessionContext的實現類。如果配置參數沒有被設置，而是配置了一個org.hibernate.transaction.TransactionManagerLookup被設置，Hibernate將使用org.hibernate.context.JTASessionContext，這裡要考慮向後兼容。典型的情況下，這個參數是使用的類的名字。對於Hibernate提供的三個實現類，有對應的三個簡短名，“jta”、“thread”、“managed”。

六、Configuration

1.編程配置

一個org.hibernate.cfg.Configuration的實例表示一個應用程序的所有Java類型到數據庫類型的映射。org.hibernate.cfg.Configuration是用來建造一個org.hibernate.SessionFactory。被編譯的映射是來自所有的XML映射文件。

片斷1.

Configuration cfg = new Configuration().addResource(“test.hbm.XML”); 

片斷2.

Configuration cfg = new Configuration().addClass(com.test.class); 

片斷3.

Configuration cfg = new Configuration().setProperty(“hibernate.dialect”, “org.hibernate.dialect.DB2Dialect”); 

Configuration可以接收的選項：

（1）傳遞一個Java.util.Properties到Configuration.setPropertIEs()。

（2）放一個hibernate.propertIEs文件到類路徑的根目錄。

（3）設置系統propertIEs，通過Java –Dproperty=value。

（4）包含標簽指定值在hibernate.cfg.XML文件。

org.hibernate.cfg.Configuration對象是有意作為一個開始時間生成的對象的，一旦SessionFactory被創建，他將被拋棄掉。

七、獲取SessionFactory

當org.hibernate.cfg.Configuration解析完所有的映射文件後，應用程序應該獲取一個org.hibernate.Session實例的工廠。這個工廠是被應用程序的所有線程共享的。

SessionFactory sessionFactory = cfg.buildSessionFactory(); 

Hibernate允許應用程序實例多個SessionFactory。對於使用多個數據庫的應用程序是非常有用的。

八、JDBC Connections（Session是對JDBC連接的封裝）

通常，你應該使用org.hibernate.SessionFactory來創建或共享JDBC。如果這采用這種方法，是非常簡單的。

Session session = sessionFactory.openSession(); 

當你的操作需要訪問數據庫時，一個JDBC連接就會從連接池中被獲取。

對於這個工作，我們應該給Hibernate提供一些JDBC連接屬性。所有的Hibernate屬性名和語義學都被定義在org.hibernate.cfg.Environment。我們現在描述對於JDBC連接配置的一些更重要的設置。

1.如果你設置以下屬性，Hibernate將獲取或共享連接使用Java.sql.DriverManager：

hibernate.connection.driver_class  
 
hibernate.connection.url  
 
hibernate.connection.username  
 
hibernate.connection.passWord  
 
hibernate.connection.pool_size 

Hibernate自己擁有的連接池算法是沒有發展的。他是為了你的初始接觸使用的，而不是為了你的產品使用的，甚至性能測試時使用。為了更好的性能和穩定性考慮，你應該使用第三方的連接池產品。只需要替換hibernate.connection.pool_size屬性的設置用相應連接池的設置。這將關閉Hibernate內部的連接池。例如，可以使用C3P0。

C3P0是一個開源的JDBC連接池，被放置在Hibernate發布文件的lib目錄下，隨Hibernate一塊發行。如果你設置hibernate.c3p0.*屬性，Hibernate將會使用org.hibernate.connection.C3P0ConnectionProvider為共享連接。如果你想使用proxool作為連接池，你可以通過查閱hibernat.propertIEs或Hibernate站點獲取需要設置的屬性名設置。

C3P0配置舉例，屬性文件片斷：

hibernate.connection.driver_class=  
 
hibernate.connection.url=  
 
hibernate.connection.username=  
 
hibernate.connection.passWord=  
 
hibernate.c3p0.min_size=  
 
hibernate.c3p0.max_size=  
 
hibernate.c3p0.timeout=  
 
hibernate.c3p0.max_statements=  
 
hibernate.dialect= 

2.對於在應用服務器內運行的程序，多數情況你應該配置Hibernate通過JNDI找到服務器的Javax.sql.DataSource來獲取連接。你需要設置以下屬性。

hibernate.connection.datasource  
 
hibernate.jndi.url  (可選)  
 
hibernate.jndi.class  (可選)  
 
hibernate.connection.username  (可選)  
 
hibernate.connection.passWord  (可選) 

你可以通過實現org.hibernate.connection.ConnectionProvider來定義自己的獲得連接的策略。通過hibernate.connection.provider_class配置使用自己的定義起作用。